# Google SSO

This page describes how to add Squadcast to G Suite and configure SSO support with SAML 2.0.

### Connecting Squadcast to G Suite <a href="#connecting-squadcast-to-g-suite" id="connecting-squadcast-to-g-suite"></a>

1. Log in to your <mark style="color:red;">`admin.google.com`</mark> account with your G Suite account
2. Select **Apps** on the main page

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-263b1fd4fac286174095ea14149f20a0d41c9d80%2Fgoogle_sso_gb_1.png?alt=media)

3\. Select **SAML apps**

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-f29d0f43066614927541870f51a5092cc8180b06%2Fgoogle_2.png?alt=media\&token=145466ab-fc06-41d8-b60a-73b58a7715ef)

4\. Create a new application by clicking the “**+**” button and then select **SETUP MY OWN CUSTOM APP**

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-ba8ba5839597701b3baeed3dfa17fed03ea854f9%2Fgoogle_3.png?alt=media\&token=3385d85a-7d85-4a9a-8506-8d72fd29c0e4)

5\. **Download** Certificate, copy **SSO URL** and keep them safe and click **NEXT**

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-4e0a57abf025b84576dacecd77df33347f93fe7d%2Fgoogle_sso_gb_2.png?alt=media)

6\. Enter the application name as **Squadcast** and optionally provide a description and upload the logo and click **NEXT**

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-0dba2c280836d18f05dfd880c2828c133766355c%2Fgoogle_sso_gb_3.png?alt=media)

7\. Log in to <mark style="color:red;">`app.squadcast.com`</mark> and navigate to its **Settings** > **Extensions**. Click the **Configure** button under SSO and select the Google tab

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-69adee17fda93cf3dbf0af41ae958fb5e437d2f5%2Fgoogle_sso_new_1.png?alt=media) ![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-50e69d268f4677c4c2e7d8b5ba89af509fd88bca%2Fsso_new_button%20\(1\)%20\(1\)%20\(1\)%20\(1\)%20\(1\)%20\(1\)%20\(1\)%20\(1\)%20\(1\)%20\(1\)%20\(1\)%20\(1\)%20\(1\)%20\(1\)%20\(1\)%20\(1\)%20\(1\)%20\(7\).png?alt=media)

8\. Click **Show configuration guide for Google** and copy the ACS URL displayed

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-231267a5500c7b2b4a4869b4e25ae4a8376d075e%2Fgoogle_sso_gb_4.png?alt=media)

9\. Go back to the Google custom app and in the Service Provider Details page and paste the copied **ACS URL** in both the **ACS URL** and **Entity ID** fields. Also select **Name ID** as **Basic Information** and **Primary Email** and **Name ID Format** as **EMAIL** and click **Next**

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-bf458b906ca0b20a9c82a5d77a4ec94b0d2461b4%2Fgoogle_sso_gb_5.png?alt=media)

10\. In the Attribute Mapping page, click the **ADD NEW MAPPING** button and add the following attributes and click **Finish** and **OK** in the next pop-up

```
Required

first_name |  Basic Information  | First Name
last_name  |  Basic Information  | Last Name
email      |  Basic Information  | Primary Email

Optional - For overwriting the default configured role (choose 1)

role | Custom Attribute | Admin
role | Custom Attribute | User
role | Custom Attribute | Stakeholder
```

By default Squadcast lets you create a user via SSO with a configured default Role ( Admin / User / Stakeholder) in the SSO screen as shown below but it can be overwritten by sending an optional custom field <mark style="color:red;">`role`</mark> and its value along with the above attribute.

{% hint style="info" %}
**Note:**

**Members** trying to log into Squadcast through SSO who aren't already added to the Squadcast platform will be added to the platform by default as **Users**.
{% endhint %}

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-973041975133e4ca991ae8d7ae6abcf4402b5c9d%2Fgoogle_10.png?alt=media\&token=07c858f1-6a1e-4e7b-8dfc-18c8fd229f5f) ![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-a4e15fde92e56c45145933a0aefbed22159ba199%2Fgoogle_11.png?alt=media\&token=665bc7d0-d78c-4d23-a31b-352a78238246)

11\. Enable the Squadcast application for all users

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-a22911145d16441042a553b4b3de42e9b53071ac%2Fgoogle_sso_gb_6.png?alt=media)

12\. Back in Squadcast, in the previously opened modal:

* Paste the SSO URL we have obtained from Step 5 above in the **SAML 2.0 Endpoint** text box
* Copy the certificate details in the **X.509 Certificate** field
* Enter the domain name of your Organization

{% hint style="info" %}
Make sure to add the **Domain Name** of your Organization, for SSO login to work
{% endhint %}

Configure other options like the default User role and click **Save**

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-655fe62720ab261f442dab16b3675c51c8c1b093%2Fgoogle_sso_gb_7.png?alt=media)

13\. You can allow Account Owners and Admins to also log in using their email credentials in addition to SSO. This can be done by checking the box as shown in the screenshot below

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-ce1e9d6e2db2843d6eab17b241c75b0ceddeeb94%2Fgoogle_sso_gb_8.png?alt=media)

14\. You can enable the toggle button on the top to Enable Google SSO for Squadcast and you are good to go your users will be able to use Google SSO to log in to Squadcast without needing a password

15\. Your users can access SSO from the Google Board

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-1f8c2189ddf585e44e30cc321e7a903975e059b1%2Fgoogle_sso_gb_9.png?alt=media)

{% hint style="info" %}
**Note:**

1. After enabling SSO (step 14), if you are facing **any** issues login using SSO, we advise you to do the following: on the webpage (depending on the browser that is being used), navigate to Inspect -> Application -> Storage -> click **Clear site data**
2. After enabling SSO (step 14), if you see the error `403: no_saml_app` on the browser, we advise you to do the following: on the webpage (depending on the browser that is being used), navigate to Inspect -> Application -> Storage -> click **Clear site data**
   {% endhint %}

*Have any questions?* [*Ask the community*](https://community.squadcast.com/view/home)*.*
