> For the complete documentation index, see [llms.txt](https://help.sipgate.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.sipgate.de/cloud-telefonanlage/en/account-management/login/wie-richte-ich-saml-sso-mit-google-ein.md).

# 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 if you use Google as your identity provider. If you are looking for instructions for setting up SSO login at sipgate,[ you can find it 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 **Apps menu** **-->** **Web and mobile apps** out.

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

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

In the selected area, open the drop-down menu **Add App** and select **Add custom SAML App** out.

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

{% step %}
**Name the app**

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

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

{% step %}
**Transfer 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-Hilfecenter-SSO-Google5.png](/files/a29bd03de5820e6355c467719cc4089c0ab6821b)
{% endstep %}

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

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

![sipgate-Hilfecenter-SSO-Google6.png](/files/0cc70a1a8d3233eec5b9297e4b688eceda2da7f3)

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

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

{% step %}
**Complete setup**

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

![sipgate-Hilfecenter-SSO-Google8.png](/files/bcdb1e1a83a76810f8c04380da4f512a79579000)

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

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

{% step %}
**Activate app**

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

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

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

In the final step, enable the SSO login method at sipgate by flipping the switch (using the toggle).

![sipgate-Hilfecenter-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. The old web user is still linked in the Google SSO database.\
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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
