ℹ️ Supreme only
In Okta, go to Applications > Applications.
2. Click on Create App Integration.
3. In Sign-on Options, select SAML 2.0 and click Next.
If you're not using SAML, you can choose Secure Web Authentication instead.
4. Enter "Perdoo" as the App name. You can add our logo if you like (not required), and hit Next.
5. Next Configure SAML (skip if using SWA). For this step, you will need to copy some values from Perdoo. Open Perdoo in a new tab and go to Configure > Integrations > SSO. Set up SAML as described here.
6. Copy the Service Provider ACS URL & Entity ID from Perdoo over to Okta as shown below:
Perdoo | Okta |
Service Provider ACS URL | Single sign on URL |
Service Provider Entity ID | Audience URI (SP Entity ID) |
In the unlikely case that you're not using email addresses as Okta usernames, change "Application username" to match the field you store a user's primary email address in.
7. Click Next. In the last step, select I'm an Okta customer adding an internal app and click Finish.
8. Select the Sign On tab and click View Setup Instructions.
9. Copy the values from Okta into Perdoo as per the table below:
Okta | Perdoo |
Identity Provider Single Sign-On URL | Entity ID |
Identity Provider Single Sign-On URL | SSO URL |
X.509 Certificate | Service Provider Certificate |
10. Go back to the General tab, click Edit next to App Settings and check the box for Enable SCIM provisioning. Then, hit Save.
11. A new tab Provisioning will show up. Click it, hit enter and fill in the values below:
SCIM connector base URL: https://api-eu.perdoo.com/scim/v2
Unique identifier field for users: userName
Authentication Mode: OAuth 2
Access token endpoint URI: https://api-eu.perdoo.com/o/token/
Authorization endpoint URI: https://api-eu.perdoo.com/o/authorize/
Client ID: hTwHcQnrBdmJNkRYiRYDCzuhe07wMxIFEWaYdpxp
Client Secret: OPa698xKYtHCsvjAqLjf6idtZCtsTmZZWueTNiFNJJJrROHdFiglbg86ZIbCBtoBV07jUPNRxZ8xak67apknr8hky9QUe02BSrp3K7O6erKQbGW5E7LTyS3jA4Pr5h4g
12. Hit Save. Then go to Integration in the sidebar and click Authenticate with Perdoo.
13. Enter your credentials in the popup and authorize the Okta plugin:
14. Refresh the page and you should see this confirmation:
15. Go to To app, click Edit, and select which data you would like to send to Perdoo.
Need a hand? Contact our friendly Support team via the in-app chat at the bottom-right of your screen, or email support@perdoo.com.