# Setup SSO with Okta

Follow these steps in your Okta account:<br>

1. Create a new App Integration in Okta and choose the SAML2 option\
   \
   ![](/files/Kg43FrmRKWWxmEMnq22C)<br>
2. Give it a name, and when asked for `Single sign-on URL` paste Birdie's Service Provider ACS, when asked for the`Audience URI (SP Entity ID)` paste Birdie's Service Provider EntityID, as illustrated in the following screenshot. Let everything else as-is with Okta defaults… \
   \
   ![](/files/TwALT1Qq27SygYWMlZ8y)<br>
3. Now your app is created on Okta side, go back Enable SAML2 into your Birdie settings, that will open a form where you must enter a few informations: at first you can label this connection as you wish, call it "Okta" for example, and add your domain name (separated with commas if you get some). \
   \
   You will then need to fill-in 3 fields in Birdie with infos coming from your Okta app: \
   1\. the field <mark style="background-color:yellow;">Entity ID</mark> (called *"Issuer"* in Okta) \
   2\. the field <mark style="background-color:yellow;">Single SignOn URL</mark> (called *"Sign on URL"* in Okta)\
   3\. the field <mark style="background-color:yellow;">X.509 certificate</mark>: to do this, download your Okta Signin Certificate (do not click on Copy, but download the file), open this file in a text editor, and copy the whole text content of your certificate into Birdie's X.509 certificate field. \
   Once you get those 3 informations in Birdie, click the Enable SAML button. \
   \
   ![](/files/sNpQwXJ4wmfAfKp5ODIw)<br>
4. If there was no error, you should be able to connect to Birdie with your SSO.


---

# Agent Instructions: 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:

```
GET https://docs.birdie.so/birdie-docs/security/saml-sso/setup-sso-with-okta.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
