--- title: "Enabling Google Workspace SSO connections with your OVHcloud account" description: "Learn how to associate your OVHcloud account with an external Google Workspace service." url: https://docs.us.ovhcloud.com/en/account/account-information/sso-google-workspace lang: en --- > For AI agents: the complete documentation index is available at https://docs.us.ovhcloud.com/en/llms.txt, the full documentation bundle is available at https://docs.us.ovhcloud.com/en/llms-full.txt. # Enabling Google Workspace SSO connections with your OVHcloud account **Learn how to associate your OVHcloud account with an external Google Workspace service.** You can use **Single Sign-On** (SSO) to sign in to your OVHcloud account. To enable these connections, your account and Google Workspace accounts have to be using SAML (_Security Assertion Markup Language_) authentication.   ## Requirements - Being an administrator of a Google Workspace service - An [OVHcloud account](https://docs.us.ovhcloud.com/en/account/account-information/create-account.md) - Access to the [OVHcloud Control Panel](https://manager.us.ovhcloud.com/#/hub)   ## Instructions **Note:** For a service provider (i.e. your OVHcloud account) to establish an SSO connection with an identity provider (i.e. your Google Workspace service), the key is to establish a mutual trust relationship by registering the SSO connection in both services. ### Registering OVHcloud into Google Workspace Your Google Workspace acts as an identity provider. Requests to authenticate your OVHcloud account will only be accepted if you have first declared it as a trusted third party. This means that it must be added as **Web and mobile apps**. Log in to the [Google Workspace](https://admin.google.com/) administration interface with your administrator account. Go to `Apps` then `Web and mobile apps`. Click `Add app` then `Add custom SAML app`. In the **App details** step, add a name for this interconnection, "OVHcloud" for example. Click `Continue`. In the **Google Identity Provider details **step, download the metadata file by clicking `Download metadata` then click `Continue`. In the **Service provider details** step, complete the `ACS URL` and `Entity ID` fields with the following information: - **ACS URL**: `https://us.ovhcloud.com/auth/` and - **Entity ID**: `https://us.ovhcloud.com/auth/` Click `Continue`. In the **Attribute mapping** step, add the following mapping: - **First Name**: Name - **Last Name**: Surname - **Primary email**: E-mail Address Click `Finish`. Enable access to this application by clicking `OFF for everyone` in the "User access" section. Click `ON for everyone` then the `SAVE` button. **Note:** Adding application access to users can take several hours to take effect. Your Google Workspace service now trusts OVHcloud as a service provider. The next step is to ensure that the OVHcloud account trusts your Google Workspace as an identity provider.   ### Registering Google Workspace into the OVHcloud account and configuring the connection To add Google Workspace as a trusted identity provider, you must provide the identity provider metadata in the [OVHcloud Control Panel](https://manager.us.ovhcloud.com/#/hub). 1. Click your `name` and then your `initials`. 2. Select `Identity and Access Management (IAM)` from the left-hand menu. 3. Click the `Identities` tab to access local users management. Click the `SSO connection` button. Fill in the XML metadata of your Google Workspace service. Enter `Group` in the **Group attribute name** box. Click on `Confirm`. **Note:** You can keep local users by ticking the `Keep active OVHcloud users` box. Now you need to retrieve your Google Workspace as the identity provider, as well as default groups. For more information, click on the link under **SSO Service URL**. The _more options_ `...` button allows you to update or delete the SSO, and view its details. Your Google Workspace is now considered a trusted identity provider. However, you still need to add groups to your OVHcloud account. **Warning:** **NOTE:** If you try to connect via SSO at this point, you will probably receive a `Not in valid groups` error message.\ \ That is because your OVHcloud account checks whether the authenticating user belongs to an existing group on the account. To resolve this, authorize the groups that will be transmitted from Google Workspace to OVHcloud. These groups are the same as those used to categorize your users. To do this, log on to the [Google Workspace](https://admin.google.com/) administration interface with your administrator account. Go to `Apps` then `Web and mobile apps`. Click on the line for the application you added in the previous step. Click `SAML attribute mapping` to edit the mapping of information shared between Google Workspace and OVHcloud. In the **Group membership (optional)** section, add any groups that you want to allow to connect to OVHcloud. In the **App attribute **field, enter `Group`. You must then assign roles to these user groups at OVHcloud. Otherwise, your OVHcloud account does not know what the user is allowed to do and, by default, no rights are assigned. From the OVHcloud Control Panel, add a group by clicking the `Declare a group` button and filling in the fields: - **Group name**: Group name within Google Workspace - **Role**: Level of rights granted to this group Then click `Confirm`. You can then verify that the group is added to your OVHcloud account in the **Groups** section: When you later log in with a user from the **Intern** group, your OVHcloud account will recognize that the user has the role "UNPRIVILEGED" specified by his group. **Warning:** **NOTE:** If you set the privileges to `NONE`, you will need to assign permissions to this group via the [IAM policies](https://docs.us.ovhcloud.com/en/account/account-information/use-iam-policies-console.md). You will then be able to log out of your account and log back in with your Google Workspace as an identity provider.   ### Connecting via SSO On the [OVHcloud login page](https://auth.us.ovhcloud.com/signin/?action=disconnect\&onsuccess=https%3A%2F%2Fmanager.us.ovhcloud.com%2F%23%2Fhub), enter your [customer code](https://docs.us.ovhcloud.com/en/account/account-information/create-account.md#what-is-my-customer-code) followed by **/idp** without entering a password, and click the `Login` button. You are then redirected to your Google Workspace login page. Enter the login and password for a user of your Google Workspace, then click the `Sign in` button. You are now logged in with the same customer code but through your Google Workspace user.   ## Go further Browse all the [Account information guides](https://docs.us.ovhcloud.com/en/account/account-information/landing-page-account-information.md). Browse the rest of the [OVHcloud US documentation](https://docs.us.ovhcloud.com/en/index.md) for guides on our other products and services.