Configure SAML with Okta catalog application

Fri, 03 Apr 2026 19:43:06 +0000

Configure SAML with Okta catalog application

Grafana offers multiple ways to configure the SAML authentication flow. This guide focuses on configuring the authentication flow using the Okta Integration Network (OIN) application.

The Grafana Labs application can be found in the Okta Integration Network catalog.

Prerequisites

Grafana Enterprise or a paid Grafana Cloud account.
Admin privileges in both Grafana and Okta.

Supported features

SAML Single Sign-On (SSO)
SAML Attribute Mapping
SAML Group Mapping
SAML External ID Mapping for SCIM provisioning

Configure SAML using the OIN application

At the Okta Integration Network catalog

Visit the Okta Integration Network catalog and search for Grafana Labs.
Within the Grafana Labs application page, click on +Add Integration.
Select the tenant to add the integration to.

At the Grafana Labs application page

If needed, update the Application label.
Set the domain name. For example, your-grafana-domain.grafana.net.
Click on Done.

Field	Description
Application label	The name of the application.
Domain name	The domain name of the Grafana instance.

At the Grafana Labs Integration page

At the Assignments tab, add the groups or users that should have access to the application.
At the Sign On tab, copy the Metadata URL.

Update SAML configuration at Grafana

At the Grafana Labs SAML settings page

Navigate to the SAML settings page within the Authentication section from the left-hand menu.
The only required step is pasting the Metadata URL in the IdP Metadata URL field, located at the 3. Connect Grafana with Identity Provider tab.
Save and apply the changes.

With this configuration, the users will be able to access Grafana using their Okta credentials.

Configure SAML authentication with Okta on Grafana Labs

Configure SAML with Okta catalog application

Configure SAML with Okta catalog application

Prerequisites

Supported features

Configure SAML using the OIN application

At the Okta Integration Network catalog

At the Grafana Labs application page

At the Grafana Labs Integration page

Update SAML configuration at Grafana

At the Grafana Labs SAML settings page