Setup your app in Okta

We recommend manually setting up an application in Okta in order to configure your company’s SSO connection with OneCloud.

Log in to your Okta organization and access the classic UI in order to create a SAML application:

From here, click “Applications” and then click “Add Application”

When adding an application, select “SAML 2.0” as your sign-on method and click “Create”. When inside the app, we recommend you name the app OneCloud and use the following logo:

Configure SAML

When you’ve finished with the general settings, click “Next” and you will be taken to the “Configure SAML” section. From here, fill out the fields as follows:

📓 Some of these fields are available in the “Show Advanced” section. Okta should default these values to the values we have chosen below, but double-check to confirm.

📓 Your company token is available in the admin SAML page. See our SSO documentation for more details. This URL will also be used in ‘Recipient URL’ and the ‘Destination URL’.

Single Logout

Attributes Statements

OneCloud requires some basic attributes to be sent along with the SAML assertion. See the screenshot below for the required attributes:

Once completed:

  • Click “Next” and proceed to the final section.

  • Select “I’m an Okta customer adding an internal app”.

    • There are optional fields to provide feedback to Okta, but they are not required.

  • When finished, click the “Finish” button. Your app is almost ready to go!

Final steps

The final step toward integrating OneCloud with Okta is to get the metadata from the app and upload it to the OneCloud platform. When you’ve finished creating your app, go to the “Sign On” section of the application.

From here, you’ll need to click “Identity provider metadata” to download the metadata associated with your application. This file will be called “metadata”, and you’ll need to rename it with a .xml extension (i.e., “metadata.xml”) in order to upload to OneCloud. See our Single Sign On (SSO) documentation for details on configuring your SAML app inside the OneCloud platform.

Did this answer your question?