# Okta SSO

{% stepper %}
{% step %}

### Set up Okta IdP <a href="#set-up-okta-idp" id="set-up-okta-idp"></a>

Lenses is available directly in Okta’s [Application catalog](https://www.okta.com/integrations/lenses-io/).
{% endstep %}

{% step %}

### Add application in the Catalog <a href="#add-application-in-the-catalog" id="add-application-in-the-catalog"></a>

* Go to **Applications->Applications**
* Click **Add Application**
* Search for **Lenses**
* Select by pressing **Add**
  {% endstep %}

{% step %}

### Set General Settings <a href="#set-general-settings" id="set-general-settings"></a>

* App label: **Lenses**
* Set the base url of your lenses installation e.g. **<https://lenses-dev.example.com>**
* Click Done
  {% endstep %}

{% step %}

#### Download SAML Certificates

Download the **Federation Metadata XML file** with the OktaIdP details.
{% endstep %}

{% step %}

### Configure SAML in HQ

SAML configuration is set in HQ's **config.yaml** file. See [here ](https://docs.lenses.io/latest/deployment/hq#samlconfig)for more details.
{% endstep %}
{% endstepper %}