# Google Workspace

[Google documentation can be found here.](https://support.google.com/a/answer/12032922?hl=en\&visit_id=638730966356313471-4225845320\&p=sso_profiles\&rd=1)

To setup Google Workspace, we just need two pieces of information.

The only required parameter is the user email address, so we will assign the default SamlID field as that parameter.

1. Workplace Domain:Enter the domain you registered with Google Workspace (do not include https\://). Example: yourcompany.com
2. Start App:This is the default Google Application that you will be redirected to after login (lowercase). Examples: dashboard, mail, calendar

You will need to be able to access the Admin Console to setup SSO.

After you have created your Key9 application, click the **SSO** tab in the side navigation. This will contain information needed to configure Google Workspace.

1. Sign in to your **Google Admin console**.
2. In the Admin console, go to Menu and then **Security** and then **Authentication** and then **SSO with third party IdP**.
3. In **Third-party SSO profiles**, click **Add SAML profile**.
4. Enter a name for the profile (Key9 Identity).
5. (Optional) You can **Download SAML Metadata** file from the side navigation of your Key9 application, then click upload XML file to provide IdP information, then skip to Step 8
6. Fill in the following information:
   1. Copy the Key9 **SSO** url to the **Sign-in page URL** field.
   2. Copy the Key9 **SLO** to the **Sign-out page URL** field.
7. Enter a change password URL for your IdP... **LOL, just kidding we don't use those things!**
8. Click **Upload certificate** to upload your certificate file.\
   (To view and copy the x509 certificate in Key9, select **View Certificate Details** from the **Certificate Options** dropdown menu, then click the copy icon.)
9. Click **Save**.

\-------------------

By default, applications are not active upon creation. Active applications are immediately available to assign groups. Applications should only be activated when you have configured the Service Provider (SP).