> 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, provided you are using Google as your identity provider. If you are looking for instructions on setting up 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** .
{% endstep %}
{% step %}
**Create SAML app**
In the selected area, open the dropdown menu **Add App** and select **Add custom SAML App** .
{% endstep %}
{% step %}
**Name 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 click on **Continue**.
{% endstep %}
{% step %}
**Take over 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 on **Continue**.
{% endstep %}
{% step %}
**Enter SP data**
In the next step, enter the Service Provider data generated by sipgate.
Set the point **Name ID Format** on **EMAIL** and **Name ID Format** on **Basic Information > Primary email**, and then click on **Continue**.
{% endstep %}
{% step %}
**Complete setup**
To complete the setup, click on **Finish**.
The SAML app for sipgate is set up and must be activated in the next step.
{% 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**.
{% endstep %}
{% step %}
**Activate SSO at sipgate**
In the final step at sipgate, activate the SSO login method by switching the toggle.
{% endstep %}
{% endstepper %}
#### Errors and solutions
Error message: "An error occurred. Please try again. Back to login."
Cause: The web user with Google SSO was deleted and recreated 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.
---
# 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=&goal=
```
`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.