Tutoriel : Utilisez un rôle RBAC pour l’administration de l’espace de travail

Utilisez le contrôle d’accès basé sur les rôles (RBAC) pour séparer le travail quotidien des tâches nécessitant des autorisations d’administrateur d’espace de travail dans Azure Databricks. Les utilisateurs endossent un rôle d’administrateur lorsque nécessaire et reviennent ensuite à leur identité utilisateur, empêchant ainsi les permissions administratives de se retrouver dans leurs sessions quotidiennes.

Scenario

Les ingénieurs en fiabilité du site (SRE) dans sre-team disposent d’un accès permanent à l’administration de l’espace de travail via une adhésion directe ou héritée au groupe système admins de l’espace de travail. Vous créez un groupe vide role-workspace-admin, accordez à sre-team l’autorisation d’endosser ce rôle, puis ajoutez le rôle à admins.

Après avoir testé le rôle, vous retirez l’accès administrateur permanent pour les SRE que vous transférez dans le rôle tout en préservant leur accès quotidien au workspace. D’autres administrateurs d’espaces de travail conservent leur accès existant. Les SRE choisissent quand endosser le rôle et quand quitter ce rôle. Cette configuration ne configure pas les flux de travail d’approbation ni l’expiration automatique de l’accès élevé.

Prerequisites

  • Un espace de travail activé pour la fédération d’identités, avec RBAC activé. Voir Activer le RBAC.
  • Des permissions d’administrateur de compte ou d’administrateur d’espace de travail pour créer le rôle, accorder l’autorisation « Assume », puis l’assigner à l’espace de travail. Voir Qui peut gérer des groupes ?.
  • Autorisations d’administrateur de l’espace de travail pour gérer le admins groupe et les droits de l’espace de travail.
  • Un groupe de comptes que vous souhaitez configurer et qui contient les SRE. Ce didacticiel utilise sre-team. Remplacez le nom de votre groupe partout.
  • Un SRE de sre-team pouvant participer à la validation en utilisant sa propre connexion, séparément de l’administrateur effectuant les modifications de configuration.
  • Un lecteur d’audit ayant accès à system.access.audit. Si l’espace de travail de test n’est pas activé pour Unity Catalog, utilisez un espace de travail compatible avec Unity Catalog dans le même compte et la même région cloud pour interroger les événements d’audit. Voir Vérifier l’attribution de l’audit.

Choisissez des utilisateurs sans rôles Azure qui accordent automatiquement un accès administrateur à l’espace de travail lorsqu’ils ouvrent l’espace de travail depuis le portail Azure. Sinon, lancer l’espace de travail peut restaurer les droits d’administrateur existants et l’attribution de l’espace de travail de l’utilisateur. Voir Autorisations d’administration Azure requises.

Étape 1 : Créer le rôle

Pour ce tutoriel, créez un groupe de compte vide pour servir de rôle.

Console de compte

  1. En tant qu’administrateur de compte, connectez-vous à la console de compte.
  2. Dans la barre latérale, cliquez sur Gestion des utilisateurs.
  3. Dans l’onglet Groupes, cliquez sur Ajouter un groupe.
  4. Appuyez sur role-workspace-admin. N’ajoutez pas de membres.
  5. Cliquez sur Confirmer.
  6. Assignez le groupe directement à l’espace de travail avec Accès à l’espace de travail. Voir Affecter un groupe à un espace de travail.

Paramètres d’administrateur de l’espace de travail

  1. En tant qu’administrateur d’espace de travail, connectez-vous à l’espace de test.
  2. Cliquez sur votre nom d’utilisateur dans la barre supérieure, puis sélectionnez Paramètres.
  3. Cliquez sur l’onglet Identité et accès .
  4. À côté de Groupes, cliquez sur Gérer.
  5. Cliquez sur Ajouter un groupe, puis sur Ajouter un nouveau groupe.
  6. Saisissez role-workspace-admin et sélectionnez Accès à l’espace de travail.
  7. Cliquez sur Ajouter. N’ajoutez pas de membres.

Cela assigne également le groupe directement à l’espace de travail et vous accorde l’autorisation Gérer sur celui-ci.

Important

Gardez ce champ vide. Après que vous avez ajouté le rôle à admins, un membre du rôle hérite des permissions d’administrateur de l’espace de travail comme identité utilisateur.

L’autorisation de gestion permet de modifier l’appartenance au rôle et d’accorder l’autorisation Assume. Examinez l’onglet Autorisations du rôle et limitez la gestion aux administrateurs chargés de contrôler l’accès à celui-ci. Si ce rôle doit être contrôlé par les administrateurs de compte, créez-le dans la console de compte pour éviter d’attribuer automatiquement Gérer à un administrateur d’espace de travail. Voir Qui peut gérer des groupes ?

Créez un rôle administrateur distinct pour chaque espace de travail afin que l’autorisation d’endosser un rôle ne permette pas d’administrer plusieurs espaces de travail.

Étape 2 : Accorder aux SRE l’autorisation d’assumer le rôle

Accordez l’autorisation « Assume » à sre-team en utilisant l’une ou l’autre méthode :

Console de compte

  1. En tant qu’administrateur de compte, ouvrez la console de compte et cliquez sur Gestion utilisateur.
  2. Dans l’onglet Groupes, cliquez sur role-workspace-admin.
  3. Cliquez sur l’onglet Permissions , puis cliquez sur Accorder l’accès.
  4. Recherchez et sélectionnez sre-team, sélectionnez Assumer, puis cliquez sur Enregistrer.

Paramètres d’administrateur de l’espace de travail

  1. En tant qu’administrateur d’espace de travail avec la permission de gérer le rôle, ouvrez Paramètres>Identité et accès dans l’espace de travail de test.
  2. À côté de Groupes, cliquez sur Gérer, puis sélectionnez role-workspace-admin.
  3. Cliquez sur Autorisations, puis sur Octroyer l’accès.
  4. Recherchez et sélectionnez sre-team, sélectionnez Assumer, puis cliquez sur Enregistrer.

Les membres de sre-team peuvent désormais assumer ce rôle. Pour modifier les utilisateurs pouvant l’assumer, gérez les membres de ce groupe ou l’octroi de l’autorisation d’assumer. Lorsque vous retirez l’accès, vérifiez la présence d’autres autorisations ou appartenances qui permettent également à l’utilisateur d’assumer ce rôle.

Étape 3 : Ajouter le rôle au groupe d’administration de l’espace de travail

En tant qu’administrateur d’espace de travail, ajoutez le rôle à admins:

  1. Dans l’espace de travail, cliquez sur votre nom d’utilisateur dans la barre du haut et sélectionnez Paramètres.
  2. Cliquez sur Identité et accès.
  3. À côté de Groupes, cliquez sur Gérer.
  4. Sélectionnez admins.
  5. Sous l’onglet Membres, cliquez sur Ajouter des membres.
  6. Sélectionnez role-workspace-admin, puis cliquez sur Confirmer.

Le rôle hérite des autorisations d’administrateur de admins. Les SRE ont la permission de prendre ce rôle sans en faire partie.

Étape 4 : Vérifiez l’accès aux rôles et l’accès quotidien

Avant de changer l’accès administrateur permanent, l’un de vos SRE se connecte à l’espace de travail avec son propre compte et effectue ces vérifications :

  1. Cliquez sur le nom de l’espace de travail dans la barre supérieure et passez le curseur sur l’espace de travail actuel.
  2. Sélectionnez role-workspace-admin depuis le sélecteur de rôle.
  3. Vérifiez que l’espace de travail se recharge avec le nom du rôle sous le nom de l’espace de travail.
  4. Ouvrez Paramètres>Identité et accès, puis cliquez sur Gérer à côté de Groupes. Vérifiez que vous pouvez ouvrir l’onglet adminsMembres du groupe. Cette vérification ne nécessite de modifier aucune appartenance.
  5. Retournez au sélecteur de rôle et sélectionnez votre nom d’utilisateur.

En tant qu’administrateur de l’espace de travail, vérifiez également que sre-team est attribué à l’espace de travail avec les droits d’accès dont ses membres ont besoin pour le travail quotidien :

  • Accès à l’espace de travail : accorde l’accès aux fonctionnalités principales de l’espace de travail, telles que les blocs-notes, les travaux, les modèles et les pipelines.
  • Accès Databricks SQL : accorde l’accès aux fonctionnalités Databricks SQL, notamment les tableaux de bord, les requêtes et les entrepôts SQL.

Si les SRE ne reçoivent ces droits que par l’intermédiaire de admins, accordez-les explicitement à sre-team. Cela préserve leur accès quotidien après avoir supprimé l’appartenance permanente au rôle d’administrateur. Consultez les droits d’accès.

Étape 5 : Supprimer l’accès administrateur permanent des SRE sélectionnés

En tant qu’administrateur de l’espace de travail, examinez l’appartenance directe et héritée des SRE sélectionnés à admins:

  1. Ouvrez Paramètres>Identité et accès>Groupes>Gérer.
  2. Ouvre admins, puis son onglet Membres.
  3. Supprimer les adhésions directes des SRE sélectionnés et supprimer sre-team s’il est membre direct. Conserver role-workspace-admin et administrateurs non associés.
  4. Vérifiez s’il y a d’autres groupes auxquels appartiennent les SRE sélectionnés, y compris les groupes parents, qui leur donnent tout de même un accès administrateur. Si un groupe partagé contient également des personnes qui doivent conserver l’accès administrateur, donnez à ces personnes un autre accès administrateur avant de retirer le groupe partagé de cet élément admins. Changer l’appartenance aux groupes de compte peut également affecter l’accès en dehors de cet espace de travail.

Conservez les affectations quotidiennes des espaces de travail des SRE et l’octroi de l’autorisation Assume de l’étape 2. Supprimer l’accès administrateur permanent nécessite de traiter chaque voie d’accès menant à admins, et non seulement une seule adhésion directe.

Étape 6 : Vérifier l’altitude et la valeur de retour

Après avoir supprimé l’accès administrateur permanent actif, le même SRE vérifie ces résultats dans sa session de navigateur :

  1. Avec votre compte utilisateur, rafraîchissez l’espace de travail et vérifiez que les paramètres d’administration de l’espace de travail vérifiés à l’étape 4 ne sont pas disponibles.
  2. Utilisez le commutateur de rôle pour basculer vers role-workspace-admin.
  3. Vérifiez que vous pouvez ouvrir ces paramètres d’administration et voir les membres du groupe admins.
  4. Après avoir terminé la tâche administrative, utilisez le sélecteur de rôle pour sélectionner votre nom d’utilisateur.
  5. Vérifiez que ces paramètres d’administration ne sont de nouveau plus disponibles. L’accès à votre espace de travail quotidien reste disponible.

Revenir modifie l’identité utilisée par cette session de navigateur. Il ne modifie pas un profil CLI Databricks authentifié séparément ni ne révoque ses jetons. Le rôle d’administrateur possède tous les assets que vous créez lorsque vous agissez sous ce rôle.

Étape 7 : Vérifier l’attribution de l’audit

Pour inspecter l’activité sous le rôle d’administrateur, exécutez cette requête en tant que lecteur d’audit. Remplacez <workspace-id> par l’identifiant de l’espace de travail de test :

SELECT event_time, service_name, action_name,
       identity_metadata.run_by, identity_metadata.run_by_display_name,
       identity_metadata.run_as, identity_metadata.run_as_display_name
FROM system.access.audit
WHERE workspace_id = '<workspace-id>'
  AND identity_metadata.run_as_display_name = 'role-workspace-admin'
  AND event_date >= current_date() - INTERVAL 1 DAY
ORDER BY event_time DESC;

Consultez les événements pour la session de test du SRE. identity_metadata.run_by identifie le SRE qui a initié chaque demande, et run_as identifie le rôle d’administrateur utilisé pour l’autorisation. La requête filtre sur run_as_display_name, le nom lisible par l’humain du rôle. Les données d’audit sont mises à jour tout au long de la journée, donc un événement récent peut ne pas apparaître immédiatement. Consultez Référence des métadonnées d’identité.

Optionnel : Utilisez des profils de CLI Databricks séparés

Pour effectuer le travail administratif avec la CLI Databricks, authentifiez-vous séparément pour les tâches quotidiennes et d’administration. La vérification de gestion des jetons dans cette section nécessite que les jetons d’accès personnels soient activés et que la gestion des jetons soit disponible dans l’espace de travail. Consultez Superviser et révoquer les jetons d’accès personnels.

Le SRE participant au programme installe l’interface de ligne de commande Databricks comme décrit dans Installer ou mettre à jour l’interface de ligne de commande Databricks. Ils se connectent en utilisant leur propre identifiant, avec un profil nommé pour le travail quotidien et un autre pour le poste d’administrateur :

databricks auth login --host <workspace-url> --profile everyday
databricks auth login --host <workspace-url> --profile ws-admin

Pour everyday, le SRE sélectionne son identité utilisateur sous Autoriser en tant que… dans le navigateur. Pour ws-admin, ils sélectionnent role-workspace-admin.

Le SRE compare cette commande admin en lecture seule pour chaque profil :

databricks token-management list --profile everyday
databricks token-management list --profile ws-admin

Le profil quotidien rencontre une erreur d’autorisation. Le profil administrateur peut lister les métadonnées du jeton. Le SRE utilise --profile everyday pour les commandes quotidiennes suivantes. Sélectionner ce profil n’invalide pas le profil administrateur. Consultez l’interface CLI Databricks.

Nettoyage

Conservez la configuration si c’est le modèle d’accès que vous souhaitez utiliser. Pour un test temporaire, restaurez leurs adhésions administratives d’origine avant de retirer le rôle de admins ou de retirer l’autorisation Assume. Examinez toutes les ressources détenues par le rôle avant de les supprimer.

Étapes suivantes

Resource Description
Changer de rôle RBAC Utilisez d’autres méthodes prises en charge pour endosser un rôle.
Limitations du contrôle d’accès en fonction du rôle (RBAC) Vérifiez quelles fonctionnalités ne sont pas prises en charge ou se comportent différemment lorsqu’on agit avec un rôle.
Gérer les groupes Azure Databricks Gérez l’adhésion au groupe, les affectations d’espaces de travail et l’autorisation « Assume ».