Groups

A Group is a powerful tool for permissions and user management on Files.com. Users can belong to multiple groups.

All permissions can be managed via Groups, and Groups can also be synced to your identity platform via LDAP or SCIM.

Files.com's Group Admin feature allows you to define Group Admins, who then have access to add and remove users within their groups.

Resource Schema

Required

Property	Description
name String	Group name

Optional

Property	Description
allowed_ips String	A list of allowed IPs if applicable. Newline delimited
admin_ids String	Comma-delimited list of user IDs who are group administrators (separated by commas)
notes String	Notes about this group
user_ids String	Comma-delimited list of user IDs who belong to this group (separated by commas)
ai_assistant_personality_id Int64	AI Assistant Personality ID assigned to this Group, if any. Users in the Group inherit it unless a direct per-user or Partner assignment overrides it.
ftp_permission Bool	If true, users in this group can use FTP to login. This will override a false value of `ftp_permission` on the user level.
sftp_permission Bool	If true, users in this group can use SFTP to login. This will override a false value of `sftp_permission` on the user level.
dav_permission Bool	If true, users in this group can use WebDAV to login. This will override a false value of `dav_permission` on the user level.
restapi_permission Bool	If true, users in this group can use the REST API to login. This will override a false value of `restapi_permission` on the user level.
desktop_configuration_profile_id Int64	Desktop Configuration Profile ID assigned to this Group, if any. Users in the Group inherit it unless a direct per-user assignment overrides it.
integration_centric_profile_id Int64	Integration Centric Profile ID assigned to this Group, if any. Users in the Group inherit it unless a direct per-user assignment overrides it.
workspace_id Int64	Workspace ID

Read Only

Property	Description
id Int64	Group ID
usernames String	Comma-delimited list of usernames who belong to this group (separated by commas)
site_id Int64	Site ID

Example Resource

resource "files_group" "example_group" {
  notes                            = "example"
  user_ids                         = 1
  admin_ids                        = 1
  ai_assistant_personality_id      = 1
  ftp_permission                   = true
  sftp_permission                  = true
  dav_permission                   = true
  restapi_permission               = true
  desktop_configuration_profile_id = 1
  integration_centric_profile_id   = 1
  allowed_ips                      = "10.0.0.0/8\n127.0.0.1"
  name                             = "name"
  workspace_id                     = 0
}

Resource Import

This Resource supports importing using the following syntax:

Example Import Command

# Groups can be imported by specifying the id.
terraform import files_group.example_group 1

Data Source Schema

Required

Property	Description
id Int64	Group ID

Read Only

Property	Description
name String	Group name
allowed_ips String	A list of allowed IPs if applicable. Newline delimited
admin_ids String	Comma-delimited list of user IDs who are group administrators (separated by commas)
notes String	Notes about this group
user_ids String	Comma-delimited list of user IDs who belong to this group (separated by commas)
usernames String	Comma-delimited list of usernames who belong to this group (separated by commas)
ai_assistant_personality_id Int64	AI Assistant Personality ID assigned to this Group, if any. Users in the Group inherit it unless a direct per-user or Partner assignment overrides it.
ftp_permission Bool	If true, users in this group can use FTP to login. This will override a false value of `ftp_permission` on the user level.
sftp_permission Bool	If true, users in this group can use SFTP to login. This will override a false value of `sftp_permission` on the user level.
dav_permission Bool	If true, users in this group can use WebDAV to login. This will override a false value of `dav_permission` on the user level.
restapi_permission Bool	If true, users in this group can use the REST API to login. This will override a false value of `restapi_permission` on the user level.
desktop_configuration_profile_id Int64	Desktop Configuration Profile ID assigned to this Group, if any. Users in the Group inherit it unless a direct per-user assignment overrides it.
integration_centric_profile_id Int64	Integration Centric Profile ID assigned to this Group, if any. Users in the Group inherit it unless a direct per-user assignment overrides it.
site_id Int64	Site ID
workspace_id Int64	Workspace ID

Example Data Source

data "files_group" "example_group" {
  id = 1
}