Overview
Single sign-on (SSO) is an authentication method that allows you and your team to securely log in to multiple apps and sites using a single set of credentials. If your team uses SSO authentication, you can set up SSO for Apollo. Apollo supports both SP and IdP-initiated SSO through SAML and SCIM integrations.
Apollo supports the following SSO providers:
Check out the following steps to set up SSO, assign users to Apollo, and log in to Apollo with SSO.
Only users with both SSO provider and Apollo admin access can set up SSO on Apollo. If you're not an admin for either account, share this article with a team member who has the necessary permissions.
Set Up SSO on Apollo
When you enable SSO, you and your team can only log in to Apollo via SSO. If you try to log in using another method, Apollo redirects you to SSO sign-in.
To set up SSO on Apollo, follow the steps for your provider:
To set up SSO via Sign in with Google:
- Launch Apollo, and click Settings > Security > Single sign on.
- Select Google from the identity provider name dropdown.
- Click Save & Enforce SSO.
If you run into issues or need help with set up, reach out to your organization's Google Admin or check out Google Support.
Microsoft
To set up SSO with Microsoft:
- Launch Apollo, and click Settings > Security > Single sign on.
- Select Microsoft from the identity provider name dropdown.
- Click Save & Enforce SSO.
You have set up SSO on Apollo. Your team can now log in to Apollo with SSO.
If you run into issues or need help with set up, reach out to your organization's Microsoft Admin or check out Microsoft Support.
Microsoft Entra ID (formerly Azure)
Step 1: Configure SSO
To set up SSO with Microsoft Entra ID:
- Launch Apollo, and click Settings > Security > Single sign on.
- Select Microsoft Entra ID from the identity provider name dropdown.
- Copy the Apollo single sign-on URL and entity ID to a secure location.
- Keep the Apollo tab open and log in to Microsoft Entra Admin in a separate tab. Navigate to Identity > Applications > Enterprise applications > All applications.
- Click to add an application, and name it
Apollo.io
. - Under Manage, click Single sign-on and select SAML.
- In the set up toolkit, copy the values for login URL and Microsoft Entra ID to a secure location.
- Click Edit beside Basic SAML configuration. Paste the entity ID copied from Apollo into the Identifier (Entity ID) field. Paste the single sign on URL copied from Apollo into the Reply URL field.
- Next, copy the single sign-on URL and identity provider entity ID to a secure location. In the SAML Certificates section, click Download for Certificate (Base64) to download the SAML signing certificate and save it to use later.
- Return to Apollo and paste the sign on URL you copied in Entra into the Identity provider single sign-on URL field.
- Then, paste the Microsoft Entra ID you copied into the Identity provider entity ID field in Apollo.
- Paste the text from the signing certificate you downloaded and copied in Entra into the Identity provider certificate field in Apollo.
- When finished, click Save & Enforce SSO.
You have now set up SSO on Apollo. Next, assign users to Apollo in Entra ID.
If you run into issues or need help with set up, reach out to your organization's Entra ID Admin or check out Learn Microsoft.
Step 2. Assign Users in Entra ID
Want to set up SCIM user provisioning to streamline user management between Entra ID and Apollo? Hop into Configure SCIM User Provisioning for the walkthrough.
To assign users to Apollo in Entra:
- Open a new browser tab and navigate to the single sign-on URL for Entra.
- Click Register and enter the email addresses of the people that should have access to Apollo. Enter a password and confirm. Click Register.
To allow users to self-service the application, check out Enable self-service access on Microsoft Entra.
Your team can now log in to Apollo with SSO.
Back to TopOkta
Step 1: Configure SSO
To set up SSO with Okta on Apollo:
- Launch Apollo, and click Settings > Security > Single sign on.
- Select Okta from the identity provider name dropdown.
- Copy the Apollo single sign-on URL and entity ID to a secure location.
- Keep this tab open and log in to Okta in another tab. In Okta, navigate to Applications, then click Browse App Catalog.
- Search for and click Apollo.io.
- Then click Add Integration.
- Enter
Apollo.io
for the application label and click Done. - Click Sign On on the Apollo.io app.
- Scroll to Advanced Sign-on Settings to find the Apollo entity ID field. Paste the Apollo entity ID that you copied from Apollo earlier.
- Scroll to Credentials Details and select Email from the Application username format dropdown. Click Save.
- Scroll to Metadata details and copy the text in the Sign on URL and Issuer fields to a secure location.
- Next, click Download to download and copy the signing certificate text.
- Return to Apollo and paste the sign on URL you copied in Okta into the Identity provider single sign-on URL field.
- Then, paste the issuer text you copied in Okta into the Identity provider entity ID field in Apollo.
- Paste the text from the signing certificate you downloaded and copied in Okta into the Identity provider certificate field in Apollo.
- When finished, click Save & Enforce SSO.
If you run into issues or need help with set up, reach out to your organization's Okta Admin or check out Okta Support.
Step 2. Assign Users in Okta
Want to set up SCIM user provisioning to streamline user management between Okta and Apollo? Hop into Configure SCIM User Provisioning for the walkthrough.
To assign users to Apollo in Okta:
- Launch Okta and navigate to the Apollo app on the Applications page. Click Assignments.
- Click Assign, and then select Assign to People or Assign to Groups.
- Click Assign beside the person or group you want to add.
- Click Save and Go Back. Repeat the process for every user or group you want to assign access to Apollo.
- When finished, click Done.
- Click Assignments to display every user that you have assigned to Apollo.
Your team can now log in to Apollo with SSO.
Log in to Apollo with SSO
Once you've enabled SSO, you and your team must log in to Apollo with SSO.
To log in to Apollo with SSO:
- Launch Apollo and click the log in button for your provider.
- Enter your email address, and click Log in.
- If you're not already logged in to your SSO provider, Apollo redirects you to SSO sign-in. Enter your credentials and click Log in.
You have now logged into Apollo via SSO.
If you're an SSO admin, when you enter your credentials, your SSO provider will redirect you to your admin account. Navigate to the Apollo app and click it to open Apollo.