add sso docs for Google Workspace SAML

mintlify · May 10, 2024 · ce4185f · ce4185f
1 parent 4c27622
commit ce4185f
Showing 1 changed file with 31 additions and 1 deletion.
diff --git a/settings/authentication.mdx b/settings/authentication.mdx
@@ -3,7 +3,7 @@ title: 'Single Sign-On (SSO)'
 description: "Customize how your team can login to Mintlify"
 ---
 
-Mintlify supports single sign-on to your dashboard via SAML and OIDC. If you use Okta, we have provider-specific documentation for setting up SSO, but if you use another provider, please contact us!
+Mintlify supports single sign-on to your dashboard via SAML and OIDC. If you use Okta or Google Workspace, we have provider-specific documentation for setting up SSO, but if you use another provider, please contact us!
 
 <Note>
   SSO functionality is available on our enterprise plan. [Contact us](https://calendly.com/mintlify/demo-your-docs) to learn more!
@@ -51,6 +51,36 @@ Mintlify supports single sign-on to your dashboard via SAML and OIDC. If you use
     </Tab>
 </Tabs>
 
+## Google Workspace
+
+<Tabs>
+    <Tab title="SAML">
+        <Steps>
+            <Step title="Create an application">
+                Under `Web and mobile apps`, select `Add custom SAML app` from the `Add app` dropdown.                
+            </Step>
+            <Step title="Send us your IdP information">
+                Copy the provided SSO URL, Entity ID, and x509 certificate and send it to the Mintlify team.
+            </Step>
+            <Step title="Configure integration">
+                On the Service provider details page, enter the following:
+                * ACS URL (provided by Mintlify)
+                * Entity ID (provided by Mintlify)
+                * Name ID format: `EMAIL`
+                * Name ID: `Basic Information > Primary email`
+
+                On the next page, enter the following attribute statements:
+                | Google Directory Attribute | App Attribute |
+                | -------------------------- | ------------- |
+                | `First name` | `firstName`  |
+                | `Last name` | `firstName` |
+
+                Once this step is complete and users assigned to the application, let our team know and we'll enable SSO for your account!
+            </Step>
+        </Steps>
+    </Tab>
+</Tabs>
+