Skip to content

Commit e033289

Browse files
EN proof
1 parent 03555eb commit e033289

File tree

1 file changed

+23
-23
lines changed
  • pages/account/customer/ovhcloud-account-connect-google-workspace

1 file changed

+23
-23
lines changed

pages/account/customer/ovhcloud-account-connect-google-workspace/guide.en-gb.md

Lines changed: 23 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: Enable Google Workspace SSO connections with your OVHcloud account
2+
title: Enabling Google Workspace SSO connections with your OVHcloud account
33
slug: connect-sso-googleworkspace
44
excerpt: "Learn how to associate your Google Workspace service with your OVHcloud account via SAML 2.0"
55
section: Advanced Usage
@@ -11,7 +11,7 @@ updated: 2023-03-30
1111

1212
## Objective
1313

14-
You can use a **unique** Single Sign-On to sign in to your OVHcloud account. To enable these connections, your OVHcloud account and Google Workspace accounts must be configured using Security Assertion Markup Language (SAML) authentication.
14+
You can use unique **single sign-on** (SSO) to sign in to your OVHcloud account. To enable these connections, your account and Google Workspace accounts have to be configured using Security Assertion Markup Language (SAML) authentication.
1515

1616
**This guide explains how to associate your OVHcloud account with an external Google Workspace service.**
1717

@@ -42,15 +42,15 @@ Go to `Apps`{.action} then `Web and mobile apps`{.action}.
4242

4343
Click `Add app`{.action} then `Add custom SAML app`{.action}.
4444

45-
In the "App details" step, add a name for this interconnection. If you are not inspired, **OVHcloud** is a good name. Click `Continue`{.action}.
45+
In the "App details" step, add a name for this interconnection, **OVHcloud** for example. Click `Continue`{.action}.
4646

4747
![Add SAML Application, Step 1](images/google_workspace_web_mobile_add_saml_app_step1.png){.thumbnail}
4848

49-
In the "Google Identity Provider details" step, download the metadata file by clicking `Download metadata`{.action} then click `Continue`{.action}.
49+
In the step "Google Identity Provider details", download the metadata file by clicking `Download metadata`{.action} then click `Continue`{.action}.
5050

5151
![Add SAML Application, Step 2](images/google_workspace_web_mobile_add_saml_app_step2.png){.thumbnail}
5252

53-
In the "Service provider details" step, complete the `ACS URL` and `Entity ID` fields with the values for your region:
53+
In the step "Service provider details", complete the `ACS URL` and `Entity ID` fields with the values for your region:
5454

5555
- EU region: **ACS URL**: `https://www.ovhcloud.com/eu/auth/saml/acs` and **Entity ID**: `https://www.ovhcloud.com/eu/auth/`
5656
- CA region: **ACS URL**: `https://www.ovhcloud.com/ca/auth/saml/acs` and **Entity ID**: `https://www.ovhcloud.com/ca/auth/`
@@ -59,7 +59,7 @@ Click `Continue`{.action}.
5959

6060
![Add SAML application, step 3](images/google_workspace_web_mobile_add_saml_app_step3.png){.thumbnail}
6161

62-
In the Attribute mapping step, add the following mapping:
62+
In the "Attribute mapping" step, add the following mapping:
6363

6464
- **First Name**: Name
6565
- **Last Name**: Surname
@@ -69,7 +69,7 @@ Click `Finish`{.action}.
6969

7070
![Add SAML application, step 4](images/google_workspace_web_mobile_add_saml_app_step4.png){.thumbnail}
7171

72-
Enable access to this application by clicking `OFF for everyone`{.action} in the "User Access" section. Click `ON for everyone`{.action} then the `SAVE`{.action} button.
72+
Enable access to this application by clicking `OFF for everyone`{.action} in the "User access" section. Click `ON for everyone`{.action} then the `SAVE`{.action} button.
7373

7474
![Enable app for all users](images/google_workspace_web_mobile_enable_app1.png){.thumbnail}
7575

@@ -86,11 +86,11 @@ Your Google Workspace service now trusts OVHcloud as a service provider. The nex
8686

8787
To add Google workspace as a trusted identity provider, you need to provide the identity provider metadata in the [OVHcloud Control Panel](https://www.ovh.com/auth/?action=gotomanager&from=https://www.ovh.co.uk/&ovhSubsidiary=GB).
8888

89-
Once logged-in, click your profile at the top right.
89+
Once logged in, click your profile at the top right.
9090

9191
![Top menu OVHcloud](images/ovhcloud_top_menu.png){.thumbnail}
9292

93-
Click your name to access your profile management page.
93+
Click on your name to access your profile management page.
9494

9595
![OVHcloud User Information](images/ovhcloud_user_infos.png){.thumbnail}
9696

@@ -102,11 +102,11 @@ Click the `SSO Login`{.action} button.
102102

103103
![OVHcloud SSO connection step 1](images/ovhcloud_user_management_connect_sso_1.png){.thumbnail}
104104

105-
Complete the XML metadata for your Google Workspace service. Enter "Group Attribute Name" as `Group`. Click `Confirm`{.action}.
105+
Fill in the XML metadata of your Google Workspace service. Enter `Group` as the "Group Attribute Name". Click `Confirm`{.action}.
106106

107107
![OVHcloud SSO connection step 2](images/ovhcloud_user_management_connect_sso_2.png){.thumbnail}
108108

109-
Now you need to find your Google Workspace as identity provider, as well as default groups.
109+
Now you need to retrieve your Google Workspace as identity provider, as well as default groups.
110110

111111
![OVHcloud SSO connection step 3](images/ovhcloud_user_management_connect_sso_3.png){.thumbnail}
112112

@@ -121,37 +121,37 @@ The `...`{.action} button allows you to update or delete the SSO, and view its d
121121
Your Google Workspace is now considered a trusted identity provider. However, you still need to add groups to your OVHcloud account.
122122

123123
> [!warning]
124-
> If you try to connect via SSO at this point, you will probably obtain a `Not in valid groups` error message.
124+
> If you try to connect via SSO at this point, you will probably receive a `Not in valid groups` error message.
125125
>
126-
> Indeed, your OVHcloud account checks whether the authenticating user belongs to an existing group on the account.
126+
> That is because your OVHcloud account checks whether the authenticating user belongs to an existing group on the account.
127127
>
128128
129-
To do this, you must authorise the groups that will be transmitted from Google Workspace to OVHcloud. These groups are the same as those used to categorize your users.
129+
To resolve this, authorise the groups that will be transmitted from Google Workspace to OVHcloud. These groups are the same as those used to categorise your users.
130130

131-
To do this, log on to the [Google Workspace](https://admin.google.com) administration interface with your administrator account.
131+
To do this, log on to the [Google Workspace](https://admin.google.com) administration interface with your administrator account.
132132

133133
Go to `Apps`{.action} then `Web and mobile apps`{.action}.
134134

135135
![Manage web and mobile apps](images/google_workspace_web_mobile_add_saml_app.png){.thumbnail}
136136

137-
Click the application line you added earlier.
137+
Click on the line for the application you added in the previous step.
138138

139139
![List of web and mobile apps](images/google_workspace_web_mobile_list_app.png){.thumbnail}
140140

141141
Click `SAML attribute mapping`{.action} to edit the mapping of information shared between Google Workspace and OVHcloud.
142142

143143
![SAML Application Detail](images/google_workspace_web_mobile_show_app.png){.thumbnail}
144144

145-
In the "Group membership (optional)" category, add any groups that you want to allow to connect to OVHcloud. In the "App attribute" field, enter `Group`.
145+
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`.
146146

147147
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.
148148

149149
![Configuring user groups](images/google_workspace_web_mobile_setup_groups.png){.thumbnail}
150150

151-
From the OVHcloud Control Panel, add a group by clicking the `Declare Group`{.action} button and filling in the fields:
151+
From the OVHcloud Control Panel, add a group by clicking the `Declare a group`{.action} button and filling in the fields:
152152

153-
- **Group name**: group name within Google Workspace
154-
- **Role**: level of entitlement granted to this group
153+
- **Group name**: Group name within Google Workspace
154+
- **Role**: Level of rights granted to this group
155155

156156
![Google Workspace User Management Groups](images/ovhcloud_user_management_groups_1.png){.thumbnail}
157157

@@ -161,7 +161,7 @@ You can then verify that the group is added to your OVHcloud account in the "Gro
161161

162162
![Google Workspace User Management Groups](images/ovhcloud_user_management_groups_3.png){.thumbnail}
163163

164-
When you later log in with a user in the **Intern** group, your OVHcloud account will recognize that the user has the UNPRIVILEGED role specified by his group.
164+
When you later log in with a user from the **Intern** group, your OVHcloud account will recognise that the user has the role "UNPRIVILEGED" specified by his group.
165165

166166
You will then be able to log out of your account and log back in with your Google Workspace as an identity provider.
167167

@@ -171,15 +171,15 @@ On [the OVHcloud login page](https://www.ovh.com/auth/?action=gotomanager&from=h
171171

172172
![Connection to OVHcloud federation](images/ovhcloud_federation_login_1.png){.thumbnail}
173173

174-
You are then redirected to your Google Workspace login page. Enter a login/password for a user of your Google Workspace, then click the `Sign in`{.action} button.
174+
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`{.action} button.
175175

176176
![OVHcloud Federation login Redirection Google Workspace](images/ovhcloud_federation_login_2.png){.thumbnail}
177177

178178
You are now logged in with the same customer ID, but through your Google Workspace user.
179179

180180
![OVHcloud User Info Federation](images/ovhcloud_user_infos_federation.png){.thumbnail}
181181

182-
## Go Further
182+
## Go further
183183

184184
[Creating an OVHcloud account](https://docs.ovh.com/gb/en/customer/create-ovhcloud-account/)
185185

0 commit comments

Comments
 (0)