Integrating with Okta

When you add the Okta integration all users will use Okta authentication to access their BasicOps accounts. Okta users who do not have a BasicOps account will automatically have a BasicOps account created if they click the BasicOps icon in Okta.

How to add the Okta integration:

1. Log in to BasicOps as an Administrator
2. Navigate to Settings, then the Integrations tab
3. Find the Okta card and click the Add button
4. Copy the string in the Subdomain field
5. Log in to Okta
6. Go to the Admin section, navigate to Applications
7. Click the Add Application button
8. Search for the BasicOps application and click the Add button
9. Paste the Subdomain string copied from step 4 into the Subdomain field and click the Done button
10. Click the Sign On tab
11. Click the link ‘Identity Provider metadata’, this opens a new browser window containing XML code
12. Right-click in the browser and select 'View Page Source' or 'Show Page Source' to see the raw XML, select all the XML and copy
13. In BasicOps paste the XML into the IdP Metadata XML field (see the dialogue in step 4) and click the Submit button

This completes the integration process, you can now open the BasicOps application by clicking the BasicOps icon in Okta. If you choose instead to navigate directly to your BasicOps instance using the URL https://app.basicops.com/<subdomain> (where <subdomain> is the subdomain copied in step 4) you will be redirected to Okta whenever you need to authenticate.

If my integration doesn’t work

If for some reason your Okta integration doesn’t work and you’re not able to log in to your BasicOps instance, use this URL to log in using your BasicOps credentials:

https://app.basicops.com/<subdomain>?login

You can now find the Okta card on the Integrations page and click Configure to update the configuration or Remove to remove the Okta integration.

If you have problems with your integration please contact [e-mail].