Set Up Single Sign-On (SSO) for Your Apollo Account

Article author
Sarah Malone
  • Updated

Overview

 
It's Beta Time for Custom Users!

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.

 
Got Admin Superpowers?

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.

Back to Top

Create a SAML integration in Okta

 
Supported Identity Providers

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.

Create app integration button in Okta applications

Click the SAML 2.0 radio button. Then, click Next.

Create app integration modal in Okta

Type Apollo into the App name field. If you want to add the Apollo logo upload the file. Then, click Next.

App name field in Okta

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.

Single sign-on URL field in Okta

Paste your "Apollo entity ID" into the Audience URI (SP Entity ID) field.

Audience URI field in Okta

 
Feeling a Little Lost?

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.

Name ID format drop-down in Okta

Scroll to the bottom of the page and click Next.

Next button in Okta

Click the I'm a software vendor, I'd like to connect my app with Okta radio button and then click Finish.

App configuration questions on create SAML integration page

Scroll down the Apollo sign-on page that Okta loads and click View SAML Setup Instructions.

View SAML setup instructions button in Okta

Keep this tab open. You need the information on this page to complete the next steps in Apollo.

Back to Top

Configure Single Sign-on Settings in Apollo

Launch Apollo in another tab, click Settings, and then click Integrations.

Integrations page in Apollo

Scroll to Single Sign-On and click Connect.

Connect SSO button on integrations page

Click the Enable SSO toggle.

SSO toggle

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.

Apollo entity ID and SSO URL

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.

Identity provider field in Okta

Switch back to Apollo to paste the text into the Identity provider single sign-on URL field.

Identity provider SSO URL in Apollo

Copy the text after the slash from the Identity Provider Issuer field in Okta.

Text in the IP issuer field in Okta

Paste the text into the Identity provider entity ID in Apollo.

IP entity ID field in Apollo

Copy all the text in the X.509 Certificate field in Okta.

X.589 certificate field in Okta

Paste the text into the Identity provider certificate field in Apollo.

IP certificate field in Apollo

Click Save.

Save button on SSO integration page in Apollo

You have now configured your SSO settings in Apollo. Follow the steps below to finalize the process in Okta.

Back to top

Assign Users in Okta

Launch Okta and navigate to the Apollo app integration that you created on the Applications page.

Apollo integration in Okta

Click the Assignments tab.

Assignments tab in Okta

Click the Assign drop-down and then click Assign to People or Assign to Groups.

Assign drop-down on assignments tab

Click Assign on the right of the person or group that you want to add.

Assign to people modal in Okta

Click Save and Go Back.

Save and go back button in Okta

Repeat the process for every user that you want to assign to the integration.

When you have finished, click Done.

Done button in Okta

 
Want to Invite More Users to the SSO Apollo Party?

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.

Several users on the assignment tab

Back to Top

Log into Apollo with SSO

Launch https://app.apollo.io/#/login/sso, enter your email address, and then click Log In.

Apollo SSO log in page

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.

Okta sign in page

Okta redirects you to the homepage of your Apollo account.

 
Great Power Comes with Great Responsibility

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. Apollo app in Okta

You have now logged into Apollo via SSO.

Back to top


Was this article helpful?

0 out of 0 found this helpful

Have more questions? Submit a request