Provisioning Users Automatically
Files.com supports SCIM provisioning to automate user management via JumpCloud. The integration handles user creation, updates, and deactivation in Files.com based on changes made in JumpCloud. For SAML setup, see the JumpCloud SSO page.
SCIM Provisioning
SCIM automatically creates, updates, and deactivates users in Files.com based on changes in JumpCloud.
To enable SCIM provisioning in Files.com, open the advanced settings in the Add/Edit SSO Provider form. Under the Enable automatic user provisioning via SCIM? section, select Token, and select Yes for Automatically provision users on first login?. Optionally, configure the remaining options and then click Save. The token only becomes available and active after the Add/Edit SSO Provider form is saved.
To enable SCIM provisioning in JumpCloud, update the Configuration Settings section under Identity Management using the following details:
| Field | Value |
|---|---|
| API Type | SCIM API |
| SCIM Version | SCIM 2.0 |
| SCIM Connector Base URL | https://app.files.com/api/scim |
| Token Key | Enter the token generated from Files.com |
| Test User Email | Use any email address that exists in the JumpCloud directory but has NOT already been provisioned or created in the Files.com app. Make sure the Test User Email is NOT present in Files.com, whether in an enabled or disabled state, before clicking Test Connection or activating the SCIM connection in JumpCloud. |
After a successful test, JumpCloud provisions the test user to Files.com and marks it as disabled. This is expected behavior. You can safely delete the user after testing to avoid conflicts during future configuration changes.
By default the token expires one year from the date you generated it. Files.com sends an alert email before your SCIM token expires. You can extend the expiration date of the SCIM provisioning secret token in Files.com at any time.
To revoke the current token and get a new one, reset the token from Files.com. Edit your JumpCloud provider's settings in Files.com and locate the Reset Token option. After you reset the token and click Save, a new token is generated and available to copy from the Token text box.
When updating an existing SCIM configuration in JumpCloud (for example, rotating the SCIM token or changing group management settings), first go to Identity Management in JumpCloud and click Deactivate IdM connection. Then delete any previously provisioned test users from Files.com to prevent them from being auto-reprovisioned during testing. Before re-testing or re-activating the SCIM connection, confirm that no test users remain in Files.com.