> For the complete documentation index, see [llms.txt](https://docs.appetize.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.appetize.io/account/single-sign-on/google-workspace-gsuite.md).

# Google Workspace (GSuite)

For setup instructions, we recommend clients first follow our SAML instructions here:

{% content-ref url="/pages/3lL0B8KFkOeshqpkRKw0" %}
[SAML](/account/single-sign-on/saml.md)
{% endcontent-ref %}

Once basic SAML integration has been set up, there are a few additional steps required in order for a user's assigned roles to be contained in the SAML response from your server.

## SSO configuration in Google Workspace

<figure><img src="/files/CIms5vwyrpP6NoN7G9sT" alt=""><figcaption><p>ACS URL and Start URL will be provided by Appetize.io</p></figcaption></figure>

## Configure a new Role on the user object

<figure><img src="/files/NeSqD8pPVWdgljIdiwlj" alt=""><figcaption><p>Define the Appetize_role (or name it as you wish)</p></figcaption></figure>

## Map the newly defined role to the App attribute "groups"

<figure><img src="/files/gLCnvDUYEDPkkYb2HGic" alt=""><figcaption><p>Map user role to "groups" attribute</p></figcaption></figure>