# Okta SSO setup via SAML

### Configuring Single Sign-On through SAML using Okta

## Pre-requisites

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

## Supported Features

The Okta/BugBase 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 Okta:

1. Login in to your **Okta Application**.
2. Click on the **Admin** button on the top right corner.

<figure><img src="https://1542818622-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsYaOURvSKmQ57SN2CBT%2Fuploads%2FDgQKcgslkauWBq7qrLAe%2Fimage.png?alt=media&#x26;token=26317e36-65d3-472b-8969-965a17ab216a" alt="" width="354"><figcaption></figcaption></figure>

4. Go to **Application Tab** on the sidebar.

<figure><img src="https://1542818622-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsYaOURvSKmQ57SN2CBT%2Fuploads%2FOc7LaD7XHGhQ0AAdPwyl%2Fimage.png?alt=media&#x26;token=25255dc3-588d-4e37-98ac-21d7787958c4" alt="" width="275"><figcaption></figcaption></figure>

4. Click on **Browse App Catalog** button

<figure><img src="https://1542818622-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsYaOURvSKmQ57SN2CBT%2Fuploads%2FfOkjk6kbyuhmEidnPFPJ%2Fimage.png?alt=media&#x26;token=94fd483b-83dd-44ad-8084-df3b4b72bff2" alt="" width="563"><figcaption></figcaption></figure>

4. Search for the **BugBase** application and click **Add Integration**
5. Select the options you'd like in your General Settings.
6. Click Next.
7. Make sure to get the required details from the **Sign-on Tab:**
   * **Sign-on URL**: Located on the Sign On tab > Sign on methods > SAML 2.0 > More details > Sign-on URL
   * **X509 Certificat**e: Located on the Sign On tab > Sign on methods > SAML 2.0 > More details > Signing Certificate
8. Click Done.
9. Assign the BugBase application to the people or groups that should have access to the application on the **Assignments tab.**

{% 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/organisation#add-member).
{% endhint %}

10. [Open Bugbase](https://bugbase.in/login) in a new tab.
11. Follow the SAML setup instructions [here](https://docs.bugbase.ai/company-guide/company-settings/security-and-authentication/sso-with-saml).
    * Copy the Single-Sign On URL and the X.509 Certificate that you accessed in step 7 and paste them in the corresponding fields during setup.

## Notes

The following SAML attributes are supported:

| Name  | Value      |
| ----- | ---------- |
| email | user.email |

## SP-initiated SSO

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%2FcrvK4tIsupuwGUZx2EdN%2Fimage.png?alt=media&#x26;token=c8f8cf32-1fb3-44cc-83a7-b13456f83b26" alt="" width="375"><figcaption></figcaption></figure>

3. Enter your email, then click Login.

## Troubleshooting

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