Overview
Please note, the SSO integration is only available to users on a custom Apollo plan. This feature is also currently in Beta. If you are on a custom plan but do not have access to the SSO integration just yet, please bear with us while we fine-tune the magic formula. If you would like to be part of the beta test group, you can reach out to our friendly technical support team for more details. If you are interested in upgrading to a custom plan, contact a member of our sales team.
Single sign-on (SSO) is an authentication method that allows you and your team to securely log into multiple apps and sites with just one set of credentials. If your team uses SSO authentication, you can configure the settings to set up SSO for your Apollo account.
Please note, only users with Okta and Apollo admin access can set up the SSO integration. If you are not an admin for either account, please share this article with a team member who has the necessary permissions to follow the steps below.
Refer to the sections below for the steps to create an Apollo SAML integration in Okta, configure your SSO settings in Apollo, assign users to Apollo in Okta, and then log into Apollo via SSO.
Create a SAML integration in Okta
Please note, Apollo currently only integrates with Okta. If you use another identity provider to manage SSO authentication, stay tuned for further updates as we continue to improve our SSO integration.
Launch Okta, click Applications, and then click Create App Integration.
/i1.png)
Click the SAML 2.0 radio button. Then, click Next.
/i2.png)
Type Apollo into the App name field. If you want to add the Apollo logo upload the file. Then, click Next.
/i3.png)
Paste your "Apollo single sign-on URL" into the Single sign-on URL field. Click the checkbox if you want to use this as both the recipient and destination URL.
/i4.png)
Paste your "Apollo entity ID" into the Audience URI (SP Entity ID) field.
/i5.png)
Wondering where to find your Apollo single sign-on URL and entity ID? Follow the steps in the Configure SSO settings in Apollo section below to access and copy the settings you need.
Click the Name ID format drop-down and select Email Address.
/i6.png)
Scroll to the bottom of the page and click Next.
/i7.png)
Click the I'm a software vendor, I'd like to connect my app with Okta radio button and then click Finish.
/i8.png)
Scroll down the Apollo sign-on page that Okta loads and click View SAML Setup Instructions.
/i9.png)
Keep this tab open. You need the information on this page to complete the next steps in Apollo.
Configure Single Sign-on Settings in Apollo
Launch Apollo in another tab, click Settings, and then click Integrations.
/i10.png)
Scroll to Single Sign-On and click Connect.
/i11.png)
Click the Enable SSO toggle.
/i12.png)
On this page, Apollo displays the Apollo entity ID and Single Sign-on URL that you need to copy and paste in Okta when you follow the app integration set-up process above.
/i13.png)
Switch tabs to copy the text in the Identity Provider Single Sign-On URL field on the "How to Configure SAML" page that you have open in Okta.
/i14.png)
Switch back to Apollo to paste the text into the Identity provider single sign-on URL field.
/i15.png)
Copy the text after the slash from the Identity Provider Issuer field in Okta.
/i16.png)
Paste the text into the Identity provider entity ID in Apollo.
/i17.png)
Copy all the text in the X.509 Certificate field in Okta.
/i18.png)
Paste the text into the Identity provider certificate field in Apollo.
/i19.png)
Click Save.
/i20.png)
You have now configured your SSO settings in Apollo. Follow the steps below to finalize the process in Okta.
Assign Users in Okta
Launch Okta and navigate to the Apollo app integration that you created on the Applications page.
/i21.png)
Click the Assignments tab.
/i22.png)
Click the Assign drop-down and then click Assign to People or Assign to Groups.
/i23.png)
Click Assign on the right of the person or group that you want to add.
/i24.png)
Click Save and Go Back.
/i25.png)
Repeat the process for every user that you want to assign to the integration.
When you have finished, click Done.
/i26.png)
Don't see a user that you want to assign to Apollo? Follow the instructions in the Add Users Manually article in the Okta Knowledge Base. Then, refresh the page and follow the instructions above to assign the new user to the Apollo integration.
Okta displays every user that you have assigned to Apollo from the Assignments tab.
/i27.png)
Log into Apollo with SSO
Launch https://app.apollo.io/#/login/sso, enter your email address, and then click Log In.
/i28.png)
If you are already logged into Okta, Apollo redirects you straight to the homepage of your Apollo account.
If you are not logged into Okta, Apollo redirects you to the Okta sign-in page. Enter your credentials and click Sign in or click Sign in with Google.
/i29.png)
Okta redirects you to the homepage of your Apollo account.
Please note, if you are an admin, there are a couple of extra steps to the login process. When you enter your credentials, Okta redirects you to your Okta account. Navigate to the Apollo app integration that you created and click it to open Apollo. /i30.png)
You have now logged into Apollo via SSO.