Integrate with Okta using browser plugin


Before completing the following procedures, configure Apache Web Server. See SSO Configuration Step 1 on the page SAML Single Sign-On Support for configuration instructions.

The Okta plugin for browsers works by storing FileCloud user credentials in a web application that you add to Okta. After a user chooses to log in with Okta, the credentials are entered in the FileCloud page and log in proceeds automatically.

The Okta plugin works with default FileCloud login, not SSO. Do not configure SSO settings in FileCloud. If the setting: define("TONIDOCLOUD_SSO_DIRECT_ONLY",1)  appears in your cloudconfig.php file, remove or disable it.

Procedure:

Note: You must have an Okta account before completing these steps.

  1. Set up the FileCloud application in the Okta admin panel
  2. Assign the FileCloud application to users
  3. Install the plugin on the user browser.
  4. User logs in to FileCloud using the plugin.

The plugin supports different browsers. Setup and tests for this guide use Google Chrome.

Set up the FileCloud application in Okta admin panel

  1. Log in as Admin in Okta.
  2. In the navigation panel, click Applications > Applications.
  3. In the Applications screen, click Create App Integration.
  4. In the Create a new app integration screen, choose SWA - Secure Web Authentication, and click Next.
  5. Fill in the Create SWA Integration screen as shown in the following screenshot, and click Finish.
    In App's login page URL, enter the login page URL for the corresponding FileCloud installation.

Assign application to users

Now assign the Okta FileCloud integration to users so they can log in with Okta.

  1. Click the Assignments tab in Okta.

  2. In the Assign drop-down list, choose Assign to People

    A list of users who have both Okta and FileCloud accounts opens.

  3. To allow users to sign in to FileCloud using Okta, click Assign in the row with their email.

  4. Enter a User Name and Password for the user, then click Save and Go Back
    ck 
  5. Click Done.

  6. Repeat this process for all users you want to assign to the integration.


Install the Plugin in the Browser

Information on plugin installation is available here:

https://help.Okta.com/en/prod/Content/Topics/Apps/Apps_Browser_Plugin.htm

Users log in to FileCloud using the plugin

Users can sign in to the user portal or admin portal with SSO using the Okta plugin..

  1. In a browser where the Okta Plugin is installed, the user clicks the Okta plugin icon, and selects the FileCloud application.
  2. If the user is not already logged in to Okta, they are prompted to log in.
  3. In the plugin Setup access dialog box, the user enters their FileCloud Username and Password. In the future, when they open the plugin, they will not be prompted to enter credentials again.
  4. The browser redirects the user to the FileCloud login page in the Okta Admin Panel. The login screen with credentials filled in may appear first, and after a few seconds the FileCloud user portal should open (the user does not need to click Login).

    Depending on the browser, when the user accesses the FileCloud login page again, the plugin may offer to log in for them:

    Alternately, the user can access the application by choosing it directly in the plugin:
    t