Okta Integration
Configure Okta for use with CloudAvocado to enable single sign-on for users in your organization.
What You'll Need
- Okta admin access
- CloudAvocado account with admin access
- DNS management access for domain verification
Step 1: Create SAML App Integration in Okta
Start by creating a SAML app integration for CloudAvocado in your Okta account.
Create SAML App Integration
- Open your Okta Admin Console (
https://<your-org>-admin.okta.com) - Go to Applications → Applications
- Click Create App Integration → SAML 2.0, then click Next
- Enter App name:
CloudAvocado - Click Next
- Enter a placeholder Single sign-on URL:
https://app.cloudavocado.com/api/auth/sso/saml2/XXXXXXXXXXXXXXXXXXXXXXXX/login/callback. You'll replace it with the ACS URL from CloudAvocado in Step 3 - Enter a placeholder Audience URI (SP Entity ID):
cloudavocado.com. You'll replace it with the Entity ID from CloudAvocado in Step 3 - Select Name ID format:
EmailAddress - Select Application username:
Email - On Attribute Statements, add the following attribute mappings:
| Name | Value |
|---|---|
email | user.email |
firstName | user.firstName |
lastName | user.lastName |
- Click Next
- Click Finish, and keep this browser tab open for Step 3
Download Identity Provider Metadata
- Go to the Sign On tab of the SAML app integration
- Copy the Metadata URL
- Open a new tab and paste the Metadata URL into the address bar to open its contents in the browser
- Save the file to your computer (for example, as
okta-metadata.xml)
Step 2: Configure Single Sign-On in CloudAvocado
Now configure CloudAvocado to accept authentication from your Okta identity provider.
Configure SSO Settings
- Open CloudAvocado
- Go to Single Sign-On Settings
- Configure the following:
- Identity Provider name: Enter a recognizable name (for example,
Okta) - Domain Names: Add your organization's domain
- SAML 2.0 Metadata File: Select the IdP metadata file you downloaded in the previous step
- Identity Provider name: Enter a recognizable name (for example,
- Leave Require Signed Assertions checked. Okta signs both the SAML response and the assertion by default
- Click Save
Verify Domain Ownership
- Log into your DNS management console for your domain
- Copy the TXT Record Value displayed in CloudAvocado
- Add this TXT record to your domain's DNS management
- Wait for Domain Verification Status to show VERIFIED
Verification typically completes within minutes but may take up to 24 hours.
Copy Service Provider Details
- Once verified, copy the ACS URL and Entity ID from CloudAvocado. You'll need them in the next step
Step 3: Complete SAML App Integration in Okta
Return to the Okta Admin Console browser tab to complete the SAML app integration.
Edit SAML Settings
- Go to General → SAML Settings under the SAML app integration
- Click Edit
- Click Next
- On the Configure SAML tab, enter:
- Single sign-on URL: Paste the ACS URL from the previous step
- Entity ID: Paste the Entity ID from the previous step
- Click Next, then click Finish
Configure People/Groups Assignments
- Go to Assignments → Assign
- Assign the users or groups who should have access to CloudAvocado
Step 4: Test Your SSO Integration
Verify that single sign-on is working correctly before rolling out to users in your organization.
- Go to the CloudAvocado login page
- Enter your email address
- Click Continue
- Click the Sign in with [Your Identity Provider] button (skip password entry)
- You should be redirected to Okta for authentication, then back to CloudAvocado
Your organization's users can now sign in to CloudAvocado with their Okta accounts.
Troubleshooting
Domain verification pending?
DNS propagation can take time. Use a DNS checker tool to confirm your TXT record is visible.
Authentication failing?
Make sure to check the following:
- User assignment is created for the SAML app in Okta
- Attribute statements are correct
- The ACS URL and Entity ID match exactly in both Okta and CloudAvocado
- Signed Assertions and Signed Responses settings match exactly in both Okta and CloudAvocado
Need help? Our support team is here to assist you with any questions or issues you may encounter: info@cloudavocado.com.