> For the complete documentation index, see [llms.txt](https://support.docstudio.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://support.docstudio.com/admin-panel/account-settings/how-to-set-up-sso-with-google.md).
# How to Set Up SSO with Google
#### Single Sign-On (SSO) Providers
**Single Sign-On (SSO)** is an authentication method that allows users to securely log in to different applications, platforms or websites using only one set of credentials
Single sign-on (SSO) works based on a trust relationship between an application known as a service provider and an identity provider (IdP), such as Google, Okta, OneLogin, Microsoft AD FS, etc.\
This trust relationship is often based on a certificate exchanged between the identity provider and the service provider
**Benefits of Using SSO:**
* Users can authenticate using their existing credentials without repeatedly entering them for different applications.
* Your existing IdP remains the system of record for user authentication.
* You do not need to synchronise passwords with your IdP provider.
In DocStudio, you can set up Single Sign-On, allowing employees to access the platform through their Identity Provider (IdP), which streamlines the login process by eliminating passwords for secure and fast access.
DocStudio's SSO system is based on Security Assertion Markup Language 2.0 (SAML 2.0). SAML is designed to enable single sign-on for web applications across different domains, and SAML 2.0 is the leading industry standard for exchanging authentication and authorisation data.
In the SSO Providers tab, you can add your SSO providers to configure SSO authentication for your corporate users. To create an SSO provider, click the corresponding button and complete the fields in the modal window:
You can choose the type of metadata to use (either URL or XML). Once all the information is filled out, click the button.
Providers added this way can be edited or deleted, with deletion requiring confirmation:
***
#### Setting Up SSO with Google
To initiate the setup, log in to **admin.google.com** using an administrator account for Google services, such as Google Workspace or Cloud Identity:
Next, navigate to Applications -> Mobile and Web Applications from the menu:
If this is your first time setting up SSO, you will not see the SAML application in your list; you will need to select ‘Add’ > ‘Add custom SAML application’:
In the form that opens, specify the name of the new application, attach an icon if needed, and click ‘Continue’:
Google will provide connection data in two options; we recommend using ‘Upload metadata’ in one file and then clicking ‘Continue’ to proceed with the settings:
In the next window, fill in the connection data for the DocStudio platform:
* ACS URL =
* Entity ID =
Also, select the name identifier (which in our case is an email), then click ‘Continue’ to proceed with the setup:
For DocStudio, the required attributes are First Name and Last Name, so you will need to ensure these attributes are provided:
Once you have completed the settings on the Google side as an Identity Provider (IdP), the application should appear in the list of Mobile and Web Apps. You can access the app to view its settings:
To complete the settings on the DocStudio side when creating an SSO provider, you need to select the metadata type ‘XML’, copy and paste the content from the previously uploaded Google metadata file (the file is available in the application settings) and click the ‘Add’ button:
SSO provider is successfully created:
Don't forget to enable access for your users on the Google side
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://support.docstudio.com/admin-panel/account-settings/how-to-set-up-sso-with-google.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
