> For the complete documentation index, see [llms.txt](https://docs.bugbase.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bugbase.ai/company-guide/company-settings/security-and-authentication/sso-with-saml/google-sso-setup-via-saml.md).

# Google SSO setup via SAML

#### Configuring Single Sign-On through SAML using Google <a href="#configuring-single-sign-on-through-saml-using-okta" id="configuring-single-sign-on-through-saml-using-okta"></a>

### Pre-requisites <a href="#pre-requisites" id="pre-requisites"></a>

1. Be an administrator of that your Google Workspace Account.
2. All the Team members who will have access to sign in via SSO should have an Bugbase Account and should be a [member of your organization in BugBase](https://docs.bugbase.ai/company-guide/company-settings/organisation#add-member).

### Supported Features <a href="#supported-features" id="supported-features"></a>

The SAML integration currently supports the following features:

* SP-initiated SSO
* IdP-initiated SSO

### Configuration Steps <a href="#configuration-steps" id="configuration-steps"></a>

> To set up SSO via SAML for Google:

1. Login in to your **Google Workspace Admin Console**.
2. Navigate to **Apps -> Web and mobile apps** on the sidebar.

<div align="center"><figure><img src="/files/OQGQhqkm0rJZQN2ydD5T" alt="" width="170"><figcaption></figcaption></figure></div>

3. Click on **Add app and choose Add Custom SAML app**

<div align="center"><figure><img src="/files/zUV7lZgk0OloyWJmsJQr" alt="" width="375"><figcaption></figcaption></figure></div>

4. Add you app name, description and an app icon and click **continue**.

<div align="center"><figure><img src="/files/pEdXeUc0XUm2oGTaZZ3m" alt="" width="563"><figcaption></figcaption></figure></div>

5. On the next page, make sure to copy the **SSO URL** and **Certificate** and click **continue.**

<figure><img src="/files/Yg7ULiqgdCJ2M52pyhGs" alt="" width="563"><figcaption></figcaption></figure>

6. On the Service Provider Details page, add the following details:

   * ACS URL - `https://bugbase.ai/api/auth/sign-in/saml/callback`
   * Entity ID - `https://bugbase.ai/`
   * NAME ID Format - EMAIL

   <figure><img src="/files/k5vQMNg0EL84mKMUbMIP" alt="" width="563"><figcaption></figcaption></figure>
7. Click **Continue**.
8. On the next Attributes page. Add a Attribute mapping

| Google directory attributes | App attributes |
| --------------------------- | -------------- |
| Primary email               | email          |

<figure><img src="/files/1x9iWmq8rSkUd9ZWVqK0" alt=""><figcaption></figcaption></figure>

6. Click **Finish**.

### Adding User Access to Custom SAML app

<figure><img src="/files/PGHkKEiWoyjKAbJwT9ku" alt=""><figcaption></figcaption></figure>

1. Click on User access card to give access.
2. Ensure the service status is on, and add the group for which you want the service to be enabled.

<figure><img src="/files/EyewVdCdrILMIlSZRzpC" alt=""><figcaption></figcaption></figure>

3. Click Save.

{% hint style="info" %}
User configured within Okta with an email address and an account for that user exists on BugBase should have same email address, and the [user should be a member of your organization in BugBase](https://docs.bugbase.ai/company-guide/company-settings/organisation#add-member).
{% endhint %}

### Finishing the SAML Setup on BugBase:

1. [Open Bugbase](https://bugbase.in/login) in a new tab.
2. Follow the SAML setup instructions [here](https://docs.bugbase.ai/company-guide/company-settings/security-and-authentication/sso-with-saml).
   * Copy the SSO URL and the Certificate that you accessed in step 5 from [#configuring-single-sign-on-through-saml-using-okta](#configuring-single-sign-on-through-saml-using-okta "mention") and paste them in the corresponding fields during setup.

{% hint style="info" %}
If you encounter any issues or problems. Please reach out to us at <queries@bugbase.in>.
{% endhint %}

### SP-initiated SSO <a href="#sp-initiated-sso" id="sp-initiated-sso"></a>

1. Go to <https://bugbase.in/login>
2. Select **SSO**

<figure><img src="/files/3WeWGG31XCU6KIm2M2aG" alt="" width="375"><figcaption></figcaption></figure>

3. Enter your email, then click Login.
