# How do I set up SAML SSO with Google?

In this article, you will receive a step-by-step guide to setting up SAML SSO, provided you use Google as your identity provider. If you are looking for instructions on setting up the SSO login at sipgate,[ you can find them here](https://help.sipgate.de/hc/de/articles/13437518031645-Wie-richte-ich-einen-SSO-Login-f%C3%BCr-mein-Unternehmen-ein-).

{% stepper %}
{% step %}
**Open admin menu**

In the first step, log in to your Google account as an admin and select in the right **Menu Apps** **-->** **Web and mobile apps** .

![sipgate help center SSO Google1.png](/files/029bbb376ce507d82510646e0a7975f3e314fd8f)
{% endstep %}

{% step %}
**Create SAML app**

In the selected area, open the dropdown menu **Add App** and select **Add custom SAML App** .

![sipgate help center SSO Google2.png](/files/dc27e78784be4f7284381dc554598180446f48c3)
{% endstep %}

{% step %}
**Name app**

In the next step, you have the option of giving the created app any name you like, adding a description and an icon. Then continue by clicking **Continue**.

![sipgate help center SSO Google3.png](/files/14b31a764c3c0443efdd71904dc504d6fe799312)
{% endstep %}

{% step %}
**Import IdP data**

You will receive the identity provider data (**SSO URL**, **Entity ID** and **Certificate**), which you must enter in the interface configuration at sipgate. Then click **Continue**.

![sipgate help center SSO Google5.png](/files/a29bd03de5820e6355c467719cc4089c0ab6821b)
{% endstep %}

{% step %}
**Enter SP data**

In the next step, enter the service provider data generated by sipgate.

![sipgate help center SSO Google6.png](/files/0cc70a1a8d3233eec5b9297e4b688eceda2da7f3)

Set the point **Name ID Format** on **EMAIL** and **Name ID Format** on **Basic Information > Primary email**, and then click **Continue**.

![sipgate help center SSO Google7.png](/files/e12da2cae5f332b9d83cd46571fed1c4cff85341)
{% endstep %}

{% step %}
**Complete setup**

To complete the setup, click in the next step on **Finish**.

![sipgate help center SSO Google8.png](/files/bcdb1e1a83a76810f8c04380da4f512a79579000)

The SAML app for sipgate is set up and must be activated in the next step.

![sipgate help center SSO Google9.png](/files/5f5475e196d0877585ff55212d6b89ba8fc07340)
{% endstep %}

{% step %}
**Activate app**

To activate the app, simply navigate to the **User Access**- area or use the dropdown menu, and set the status to **ON for everyone**.

![sipgate help center SSO Google10.png](/files/3c938bbb416cd0e47acc1838bfd744025a5c8008)
{% endstep %}

{% step %}
**Enable SSO at sipgate**

In the final step, enable the SSO login method at sipgate by switching the toggle.

![sipgate help center SSO7.3.png](/files/38dab78462641afbd757a7da853048c8733600f4)
{% endstep %}
{% endstepper %}

#### Errors and solutions

<details>

<summary>Error message: "An error has occurred. Please try again. Back to login."</summary>

Cause: The web user with Google SSO was deleted and created as a new web user. In the Google SSO database, the old web user is still linked.\
Workaround: ask sipgate Support to delete the Google SSO entry so that the next Google SSO login works.\
Solution: We are working on a solution so that when a web user is deleted, the Google SSO deletion is also performed.

</details>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.sipgate.de/cloud-telefonanlage/en/account-management/login/wie-richte-ich-saml-sso-mit-google-ein.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.