> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usenerve.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Google SAML

> Configure single sign-on with Google Workspace using SAML

Set up SAML-based single sign-on so your team can log in to Nerve using their Google Workspace accounts.

## Prerequisites

* Google Workspace admin access
* A Nerve account on a plan that supports SSO

## Setup

<Steps>
  <Step title="Open the Google Admin console">
    Navigate to **Apps** → **Web and mobile apps** in your [Google Admin console](https://admin.google.com/u/1/ac/apps/unified). Click **Add app**, then select **Add custom SAML app**.
  </Step>

  <Step title="Fill in app details">
    On the **App details** screen, enter the following:

    | Field           | Value                  |
    | --------------- | ---------------------- |
    | **App name**    | Nerve                  |
    | **Description** | Your AI Chief of Staff |

    For the app icon, download and upload this image: [Nerve icon](https://app.usenerve.com/assets/icon-256-spacing.png).

    Click **Continue**.
  </Step>

  <Step title="Download IdP metadata">
    On the **Google Identity Provider details** screen, click **Download Metadata** to download the IdP metadata XML file.

    Send this file to us at [support@usenerve.com](mailto:support@usenerve.com), or via your shared Slack support channel if you have one.

    Click **Continue**.
  </Step>

  <Step title="Configure service provider details">
    On the **Service provider details** screen, you will need to enter the **ACS URL** and **Entity ID**. Both values will be provided by the Nerve team after we receive your IdP metadata from the previous step.

    <Note>
      We will respond within 24 hours with the ACS URL and Entity ID you need to complete this step.
    </Note>

    Once you have the values, enter them and click **Continue**.
  </Step>

  <Step title="Configure attribute mapping">
    On the **Attribute mapping** screen, add the following mappings:

    | Google Directory attribute | App attribute |
    | -------------------------- | ------------- |
    | Primary email              | email         |
    | First name                 | firstName     |
    | Last name                  | lastName      |

    Click **Finish**.
  </Step>
</Steps>

## Verify SSO

Once setup is complete:

1. Go to [app.usenerve.com](https://app.usenerve.com).
2. Log out if you are currently logged in.
3. Log back in with an email address on the same domain as your Google Workspace account.
4. You should be automatically redirected to Google to authenticate, and then redirected back to Nerve.

<Warning>
  After SSO is configured, all users on your domain will be required to use SSO to log in to Nerve.
</Warning>

## Need Help?

If you run into any issues during setup, contact us at [support@usenerve.com](mailto:support@usenerve.com).