Requirements
- Auth0 account with access to the administrator console
- Grammarly Business, Grammarly Pro, or a Grammarly for Education account with the admin role or a designated custom role
- Sign in to the Auth0 admin console
- Choose Applications
- Click Create Application button
- Enter a name (e.g., Grammarly), select Regular Web Applications, and click Create
- Click Addons
- Click SAML2 WEB APP
- In the Application Callback URL enter the following: https://sso.grammarly.com/saml/assertion
-
Copy the following to the settings JSON field:
{
"audience": "https://sso.grammarly.com/saml/metadata",
"nameIdentifierFormat": "urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress",
"nameIdentifierProbes": [
"http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress"
],
"mappings": {
"email": "EmailAddress",
"name": "FirstName",
"nickname": "LastName"
}
} - Click Enable
Note: The example above maps name to FirstName and nickname to LastName. This mapping will depend on the user attributes you have set up for your users in the Auth0 account.
Once you have the Grammarly app configured, you will need to enter the parameters below on Grammarly’s Authentication page:
- Identity Provider Issuer
- SAML 2.0 Endpoint (HTTP)
- Certificate
To find these values in your Auth0 dashboard, please do the following:
- Click Applications
- Choose the application you created (e.g., Grammarly)
- Click Addons
- Click SAML2 WEB APP
- Navigate to the Usage tab
The parameters you are looking for are:
- Issuer (Identity Provider Issuer)
- Identity Provider Login URL (SAML 2.0 Endpoint (HTTP))
- Auth0 certificate (Certificate) Note: you will need to download the file and copy the text in it.
Once you have the values above handy, activate SSO in your Grammarly account by following the steps outlined in this article: Setup SAML single sign-on
If you encounter any issues, please look for a troubleshooting article on this page: Resolve Issues