Aller au contenu principal
Dernière mise à jour le

SSO vers Databricks avec Keycloak

Cette page explique comment configurer Keycloak comme fournisseur d'identité pour le Single Sign On (SSO) dans votre compte Databricks. Keycloak prend en charge OpenID Connect (OIDC) et SAML 2.0. Keycloak ne prend pas en charge SCIM pour synchroniser les utilisateurs et les groupes avec Databricks.

attention

Pour éviter d'être déconnecté de Databricks pendant le test du Single Sign-On, gardez la console de compte ouverte dans une autre fenêtre de navigateur. Vous pouvez également configurer l’accès d’urgence avec des clés de sécurité pour éviter le verrouillage. Voir Accès d’urgence pour prévenir les verrouillages.

Activer Keycloak Single Sign On​

Choisissez votre protocole d'identité :

  1. En tant qu'administrateur de compte, connectez-vous à la console de compte et cliquez sur **Sécurité**.

  2. Cliquez sur la tab Authentification .

  3. À côté de **Authentification**, cliquez sur **Gérer**.

  4. Choisissez Single Sign On avec mon fournisseur d’identité .

  5. Cliquez sur **Continuer**.

  6. Sous Protocole d’identité , sélectionnez OpenID Connect .

  7. Sur l'onglet **Authentification**, notez la valeur de l'**URL de redirection Databricks**.

  8. Dans un nouveau browser tab, connectez-vous à votre console d'administration Keycloak.

  9. Sélectionnez le domaine pour l'intégration Databricks ou créez-en un nouveau.

  10. Créer un nouveau client :

    1. Cliquez sur **Clients** et cliquez sur **Créer un client**.

    2. Dans **Type de client**, sélectionnez **OpenID Connect**.

    3. Saisissez un ID client et un Nom .

    4. Cliquez sur Suivant et Enregistrer .

    Keycloak : créer un nouveau client.

  11. Configurez le client Databricks :

    1. Dans les **Paramètres d’accès**, définissez l’**URL d’accueil** sur l’URL de votre compte Databricks.
    2. Définissez les **URI de redirection valides** sur l'**URL de redirection Databricks** que vous avez copiée ci-dessus.
    3. Dans Configuration de la capacité , définissez Authentification du client sur Activé pour un accès confidentiel.

    Keycloak : configurer les paramètres d'accès.

  12. Configurer le mappage d'appartenance au groupe :

    1. Cliquez sur Périmètres client et sélectionnez le périmètre dédié à votre client.
    2. Dans l’onglet Mappers , cliquez sur Configurer un nouveau mapper .
    3. Dans Type de mappeur , sélectionnez Appartenance au groupe .
    4. Définissez à la fois Name et Token Claim Name sur groupes .
    5. Basculez le **Chemin complet du groupe** sur **Activé** ou **Désactivé** selon votre préférence.

    Keycloak : configurer les paramètres de groupe.

  13. Retournez à la console de compte Databricks, à la tab Authentification et saisissez les valeurs que vous avez copiées de Keycloak :

    1. Client ID : le Client ID de Keycloak.
    2. Secret client : se trouve dans l'onglet Identifiants de votre client Keycloak.
    3. URL d’émetteur OpenID : votre URL Keycloak avec un domaine (par exemple, https://keycloak.example.com/realms/your-realm).

  14. Cliquez sur Enregistrer .

  15. Cliquez sur Test SSO pour vérifier que votre configuration SSO fonctionne correctement. Databricks ouvre une nouvelle fenêtre de navigateur et tente de s'authentifier à l'aide de Keycloak. Complétez le flux de connexion et examinez les résultats de test.

  16. Cliquez sur Activer le SSO pour activer l'authentification unique pour votre compte.

  17. Testez la connexion à la console de compte avec l'authentification unique (SSO). Pour connaître les étapes de test, veuillez consulter Tester votre configuration SSO.

Ajouter des utilisateurs à Databricks​

Après avoir configuré la SSO, ajoutez des utilisateurs à votre compte. Databricks recommande de synchroniser les utilisateurs de votre fournisseur d'identité à l'aide de la gestion automatique des identités, qui synchronise automatiquement les utilisateurs et les groupes de votre fournisseur d'identité vers votre compte Databricks. Consultez Configurer Microsoft Entra ID pour la gestion automatique des identités. Sinon, si votre fournisseur d'identité ne prend pas en charge la gestion automatique des identités, vous pouvez configurer le provisionnement SCIM. Consultez Synchroniser les utilisateurs et les groupes depuis votre fournisseur d'identité à l'aide de SCIM.

Le provisionnement juste-à-temps (JIT), qui ajoute automatiquement les utilisateurs à Databricks lorsqu'ils se connectent pour la première fois en utilisant le SSO, est activé par default pour les comptes créés après le 1er mai 2025. Voir provisionnement automatique des utilisateurs (JIT).

Activer la connexion unifiée​

Pour la plupart des comptes, la connexion unifiée est déjà activée, ce qui signifie que la configuration SSO au niveau du compte s'applique à tous les Workspace. Si votre compte a été créé avant le 21 juin 2023, vous pourriez avoir besoin de l'activer. Consultez Activer la connexion unique.

Sur cette page