Prerequisites: This article assumes your account is already configured for SAML SSO. If you haven't done that yet, see Configure SAML SSO before continuing.
This article walks you through the steps to set up a Yext app in Azure. This will allow you to give your users the ability to sign in to Yext using Azure for identity management.
The process is broken into three steps:
- Add the Yext app in Azure Active Directory
- Add the Identifier and Assertion Consumer Service URL to your Yext app, then add metadata to Yext
- Finish configuration and test in Azure
If you use another SAML identity provider, see our other SSO guides for details on how to add an app to the provider you use.
Add Yext app in Azure Active Directory
You can also find instructions in Azure's Quickstart: Add an application to your Azure Active Directory (Azure AD) tenant guide. Note that some steps below suggest the correct information to enter as it pertains to Yext.
- Log in to the Azure AD portal as a Global Administrator: portal.azure.com.
- Click View under Manage Azure Active Directory.
- Click Enterprise applications in the left sidebar.
- Click New application.
- Select Non-gallery application and enter Yext as the name for your app.
- Choose 2. Set up single sign on.
- Select SAML as the single sign-on method.
Add details to your Yext app
Retrieve URLs from the SAML Configuration page in Yext
- In your Yext account, click the profile icon at the bottom of the navigation bar.
- Click Account Settings, then click SAML Configuration.
- Copy the following URLs from the SAML Configuration page: Single sign on URL and Audience URI.
Add URLs to your Yext app in Azure
- Return to Azure and enter the URLs from Yext into the Basic SAML Configuration (Identifier and Reply URL fields).
- Click Save.
Add metadata to Yext
- In Azure, download your Federation Metadata XML under section 3. SAML Signing Certificate.
- Enter the following into your Yext account:
-
Certificate — found between the
<X509Certificate>start and end tags -
ID Provider URL — found after the
SingleSignOnService Locationtag
-
Certificate — found between the
Finish configuration and test in Azure
- In Azure, under 3. SAML Signing Certificate, click Edit and select Sign SAML response and assertion from the drop-down next to Signing Option.
- Click Save.
- Add users to your Yext app by clicking Users and groups in the sidebar.
- Click Add User.
- Select the user or users you'd like to add and click Assign.
- Click Single sign-on in the left sidebar.
- Click Test at the bottom of the page to confirm everything is working. Once you do this, you should be logged in successfully to Yext.