> 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

You can use your Google credentials to sign in to BugBase.

#### 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="https://1542818622-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsYaOURvSKmQ57SN2CBT%2Fuploads%2FHfP6iFNzhm8QTkCGT674%2Fimage.png?alt=media&amp;token=d153d1d6-62d8-45ee-a6ed-c31c6485ffd6" alt="" width="170"><figcaption></figcaption></figure></div>

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

<div align="center"><figure><img src="https://1542818622-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsYaOURvSKmQ57SN2CBT%2Fuploads%2FpVLeB52QUO5iQ6m97GKd%2Fimage.png?alt=media&amp;token=f3f5cdd1-a851-4c5e-b9ba-63609f5a0a16" 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="https://1542818622-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsYaOURvSKmQ57SN2CBT%2Fuploads%2F6bnkVd5o0ftXvniT8Cyv%2Fimage.png?alt=media&amp;token=8d07de3d-db76-4138-ac1d-c5c959da4ab6" 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="https://1542818622-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsYaOURvSKmQ57SN2CBT%2Fuploads%2FlsIsdEzUsLCXB82iGyuB%2Fimage.png?alt=media&amp;token=72dd97ba-12c7-4405-81ca-4b751f041933" 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="https://1542818622-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsYaOURvSKmQ57SN2CBT%2Fuploads%2FNc12mzEJgQpMNB7AnouL%2Fimage.png?alt=media&amp;token=c26f2ef7-9915-4832-a539-329ab7670da9" 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="https://1542818622-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsYaOURvSKmQ57SN2CBT%2Fuploads%2FBhJs7kJARH8nM4sZPutR%2Fimage.png?alt=media&amp;token=3c6394e3-9410-4537-9390-da1c1d29dcfc" alt=""><figcaption></figcaption></figure>

6. Click **Finish**.

### Adding User Access to Custom SAML app

<figure><img src="https://1542818622-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsYaOURvSKmQ57SN2CBT%2Fuploads%2FNXQdLI1m6mQ29AiBNIIG%2Fimage.png?alt=media&amp;token=c0a35555-33bb-4bc6-a6fa-043ba68e0609" 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="https://1542818622-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsYaOURvSKmQ57SN2CBT%2Fuploads%2FDmZKsiUqO4oKNd1ntXTd%2Fimage.png?alt=media&amp;token=73e0c66e-983f-4701-8faa-157e41e14503" 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="https://1542818622-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsYaOURvSKmQ57SN2CBT%2Fuploads%2FzEAM8YkFX1bhNNSrH8WK%2Fimage.png?alt=media&amp;token=c11325be-1d9e-4da7-8bc0-168f8024dc27" alt="" width="375"><figcaption></figcaption></figure>

3. Enter your email, then click Login.