datahub/docs/managed-datahub/integrations/oidc-sso-integration.md

47 lines
1.9 KiB
Markdown
Raw Permalink Normal View History

2023-02-16 13:44:04 -08:00
---
description: >-
This page will help you set up OIDC SSO with your identity provider to log
into DataHub
2023-02-16 13:44:04 -08:00
---
import FeatureAvailability from '@site/src/components/FeatureAvailability';
2023-02-16 13:44:04 -08:00
# Enable OIDC SSO
2023-02-16 13:44:04 -08:00
<FeatureAvailability saasOnly />
This guide will walk you through configuring OIDC Single Sign-On in DataHub Cloud.
2023-02-16 13:44:04 -08:00
### Step 1. Complete OIDC Prerequisites
2023-02-16 13:44:04 -08:00
You will need the following in order to enable OIDC SSO in DataHub Cloud:
2023-02-16 13:44:04 -08:00
- Gather the **Client ID**, **Client Secret**, and **Discovery URI** for your OIDC provider, as detailed in [this guide](../../authentication/guides/sso/initialize-oidc.md).
- Confirm you have the `Manage Platform Settings` privilege in DataHub.
2023-02-16 13:44:04 -08:00
### Step 2. Enable OIDC SSO
2023-02-16 13:44:04 -08:00
1. In DataHub Cloud, navigate to **Settings > Platform > SSO** and choose **OIDC**.
2023-02-16 13:44:04 -08:00
<p align="center">
<img width="80%" src="https://raw.githubusercontent.com/datahub-project/static-assets/refs/heads/main/imgs/saas/configure-oidc.png"/>
</p>
2023-02-16 13:44:04 -08:00
2. Enter the **Client ID**, **Client Secret**, and **Discovery URI** from Step 1.
3. Confirm your preferred **User Provisioning Strategy**:
2023-02-16 13:44:04 -08:00
- **Just-in-Time (JIT) Provisioning** is enabled by default, automatically creating a DataHub User on login if one does not exist.
- **Pre-Provisioning DataHub Users** will only allow login for pre-provisioned DataHub Users. _Requires configuring SSO Ingestion._
2023-02-16 13:44:04 -08:00
4. Optionally enable **Extract Groups** to extract group memberships in the OIDC profile by default. _Requires JIT Provisioning._
5. Click **Connect**.
6. Log out and log back in through SSO to confirm connection succeeded.
<p align="center">
<img width="80%" src="https://raw.githubusercontent.com/datahub-project/static-assets/main/imgs/saas/image-(10).png"/>
</p>
:::note
We do not yet support LDAP or SAML authentication. Please let us know if either of these integrations would be useful for your organization.
:::