Single Sign-On Authentication


Single Sign-On (SSO) is an authentication mechanism that allows a user's identity to be managed by a single, trusted identity provider through which the user can access multiple service providers. SSO is rapidly gaining popularity both for security and compliance purposes, and to improve user experience in an increasingly complex applications and services environment.

When your users have multiple apps and services to navigate, SSO helps keep it safe and simple.

Files.com integrates with the most popular SSO providers. Always a leader in security and integration practices, we understand that our service must play well with others.

SSO integrations are available on Power and Premier plans. Each of our SSO-enabled plans carries different SSO capacities and options, so please review each plan to determine which best fits your needs.

Supported SSO Providers

Files.com integrates with the following SSO providers.

Several SSO integrations will also support user and group provisioning as configured by the SSO provider application.

ProviderProviderAuthentication and On-Demand ProvisioningSCIM Provisioning

Atlassian

✔️

Auth0

✔️

✔️

Box

✔️

Dropbox

✔️

Google

✔️

Idaptiv

✔️

✔️

Jumpcloud

✔️

✔️

LDAP

✔️

✔️

Microsoft Azure

✔️

✔️

Microsoft Active Directory

✔️

✔️

Okta

✔️

✔️

SAML (any provider)

✔️

✔️

Slack

✔️

Enabling SSO Providers

You can add as many providers as you wish.

To add a provider, log in as an administrator and navigate to Settings > Users > User Settings, click the SSO Providers setting, and then click the Add provider button.

A table of the various options will appear. Click on the logo of the provider desired and then click the Save button. The new provider will be added to the table of enabled providers. You can also disable any enabled SSO providers from this table.

Auth0, Microsoft Azure and Okta require additional configuration to complete the initial setup. Please reference the provider's support documentation to locate your SubdomainClient ID and Client Secret.

Additionally, Auth0, Microsoft Azure and Okta support advanced provisioning options. Click on Advanced to expand the configuration settings and configure the provisioning settings.

Assigning user SSO methods

After an SSO provider has been enabled for a site, site administrators grant SSO access on a per-user basis. Granting this access can be performed when creating a new user or by modifying an existing user's settings. Please note that each unique user can have only one SSO provider assigned.

To assign an SSO method for an existing user, navigate to Settings > Users and click the username of the user. Next, click Authentication Method and select the desired SSO provider from the dropdown list.

Finally, click Save to apply the setting.

Files.com also allows you to Bulk Import or Bulk Create users with any site-enabled SSO providers. To do this, use the authentication_method column with one of the site-enabled SSO provider name.

Files.com allows for you to have a mix of SSO-authenticated and Files.com password-authenticated users on your site.

For example, you could have your internal users authenticate via an SSO provider, and have your external vendors/partners authenticate with Files.com passwords.

To do this simply repeat the navigation steps mentioned prior for the user in question, and select your preferred Authentication Method for that user.

Site administrators can change or remove the user's ability to authenticate via SSO at any time by selecting Password from the dropdown list.

Logging in with SSO

Once you have enabled an SSO provider, a Sign in with... button for that provider will appear on your site's login page. Users are able to click the appropriate service button to be authenticated via the external service and redirected to their Files.com account.

When logging into Files.com using the SSO provider for the first time, users will be prompted to authorize the connection of their provider account with Files.com.

If a user does not have a current session with the SSO provider, they will be prompted to log in to that provider's service before the Files.com authentication is verified.

Disabling an SSO Integration

Disabling an SSO provider will revoke access for the user accounts that are configured to authenticate using that SSO provider. The login page will also not show the login option for that provider.

To disable an SSO provider, navigate to Settings > Users > User Settings > SSO Providers, edit the SSO provider, and click the Enabled option to toggle the selection to its disabled state.

To re-enable a disabled SSO provider, edit the SSO provider, and click the Enabled option to toggle the selection back to its enabled state.

To remove an SSO provider entirely, site administrators must first modify all user accounts that are currently set to use that SSO provider, and configure them to use another authentication method or provider. You can quickly identify any users set to the provider by looking at the AUTHENTICATION METHOD column of the user list. Once there are no users configured to authenticate with the provider, you will be able to remove it.

Switching SSO Providers

Sometimes it might be required to switch the SSO provider because of various reasons your business may have.

To switch your current SSO provider for Files.com to new SSO provider, make sure that the new identity provider of your choice is supported before starting your migration. Files.com integrates with most popular SSO and you can check the supported providers list.

Once you pick the new identity provider, follow the corresponding Files.com SSO integration documentation and enable the new SSO provider.

In general, if you face any challenges in migrating the configuration or users from Files.com to new SSO provider, please refer to the provider's support documentation.

For a SAML-based IdP, work with the SSO IdP to check if the issuer + audience + username combination can be reused or not.

For SCIM, make sure the mappings and provisioning are configured properly with the new SSO provider to avoid any duplicate or disabled users in Files.com or in your user directory.

Once the new provider is setup and ready to use, go to Settings > Users > Manage Users > [UserName] > Authentication > Authentication method to edit and pick the new provider of your choice for that user.

Once all users are updated, you can disable the old SSO provider. With this, all users can now start using your new SSO provider to login to Files.com.

Using SSO with FTP, SFTP, or WebDAV

Single sign-on authentication can only be used with browser-based sessions, or with the Files.com Desktop App.

If the user requires access to FTP/SFTP/DAV connections, the authentication method must be set to Password or Active Directory/LDAP.

An alternative approach is for the user to use SSO and then additionally add an SFTP key or an API Key to their user account.

As an administrator, you can add an SFTP key for a user at Settings > Users > [username] > Authentication > SFTP keys. Or users can add their own keys in the web interface by going to My account in the top right menu.

Using SSO work with the Files.com Desktop App

This works! We have designed the Files.com app to allow connecting with SSO user accounts. Follow the instructions to connect your account, and on the login screen click the SSO provider button assigned for that user.

If you want to have the Files.com web application automatically send your users to a SSO Provider rather than displaying the login page, build a link on your external site that links to a URL on your files.com site with the URL parameter ?use_sso=1 appended.

For example, send someone a link to: https://mysite.files.com/files/MyFolder/?use_sso=1

This solution only works if you have exactly one SSO provider.

Get Instant Access to Files.com

The button below will take you to our Free Trial signup page. Click on the white "Start My Free Trial" button, then fill out the short form on the next page. Your account will be activated instantly. You can dive in and start yourself or let us help. The choice is yours.

Start My Free Trial

©2022 Files.com. All right reserved

FILES.COM

  • Start My Free Trial
  • Pricing
  • Docs
  • API and SDKs
  • Contact

CONTACT & SUPPORT

support@files.com

(800) 286-8372

Monday–Friday

9am–8pm Eastern