Définir les autorisations pour les ressources dans les Declarative Automation Bundles
Cet article décrit comment définir les permissions pour les ressources dans les Declarative Automation Bundles. Pour des informations sur les ressources prises en charge dans les bundles, consultez Ressources des Declarative Automation Bundles.
Dans les fichiers de configuration de bundle Databricks, vous pouvez définir des autorisations au niveau supérieur pour les appliquer à toutes les Ressources définies dans le bundle, ou vous pouvez définir des autorisations à appliquer à des Ressources spécifiques.
Vous pouvez définir des autorisations pour le même utilisateur, groupe ou service principal à la fois dans le mappage permissions de niveau supérieur et dans le mappage permissions d’une ressource. Pour cette ressource, l’autorisation au niveau de la ressource est prioritaire. Voir Ordre de priorité des autorisations.
Pour empêcher les utilisateurs non administrateurs de modifier des assets une fois qu'ils ont été déployés, déployez votre bundle dans un dossier immuable en lecture seule. Voir Déploiements immuables.
Définir les autorisations à appliquer à toutes les ressources
Vous pouvez définir des permissions à appliquer à toutes les Ressources prises en charge définies dans resources en utilisant le mappage de niveau supérieur permissions. Databricks recommande cette approche pour la gestion des permissions de ressources des Declarative Automation Bundles.
Les autorisations définissent le niveau d'autorisation autorisé pour un user_name, group_name ou service_principal_name. Les niveaux d'autorisation supérieurs autorisés sont CAN_VIEW, CAN_MANAGE et CAN_RUN. Pour plus d'information sur le mappage permissions de niveau supérieur, consultez les autorisations.
L'exemple suivant définit les autorisations de niveau supérieur pour la cible dev. L'utilisateur someone@example.com aura les autorisations CAN_RUN sur my-job:
bundle:
name: my-bundle
resources:
jobs:
my-job:
# ...
targets:
dev:
# ...
permissions:
- user_name: someone@example.com
level: CAN_RUN
Définissez les autorisations pour une ressource spécifique
Vous pouvez utiliser le mappage permissions dans un tableau de bord, une expérimentation, un job, un modèle ou une définition de pipeline dans resources pour définir une ou plusieurs autorisations pour cette ressource.
Chaque autorisation de la correspondance permissions doit inclure les éléments suivants :
- Soit
user_name,group_name, ouservice_principal_name, défini respectivement sur le nom de l'utilisateur, du groupe, ou du Service Principal. level, défini sur le nom du niveau d'autorisation. Les niveaux d'autorisation autorisés pour chaque ressource sont les suivants :- Alertes:
CAN_EDIT,CAN_MANAGE,CAN_READ,CAN_RUN - Applications:
CAN_MANAGE,CAN_USE - Clusters:
CAN_ATTACH_TO,CAN_MANAGE,CAN_RESTART - Tableaux de bord:
CAN_EDIT,CAN_MANAGE,CAN_RUN,CAN_READ* - Instances de base de données:
CAN_MANAGE,CAN_USE,CAN_CREATE - Agents Genie:
CAN_EDIT,CAN_MANAGE,CAN_RUN,CAN_VIEW - Experimentations:
CAN_EDIT,CAN_MANAGE,CAN_READ,CAN_RUN - Jobs:
CAN_MANAGE,CAN_MANAGE_RUN,CAN_VIEW,IS_OWNER - Modèles:
CAN_EDIT,CAN_MANAGE,CAN_MANAGE_STAGING_VERSIONS,CAN_MANAGE_PRODUCTION_VERSIONS,CAN_READ - Pipelines:
CAN_MANAGE,CAN_RUN,CAN_VIEW,IS_OWNER - Secret scopes:
READ,WRITE,MANAGE - SQL Warehouse:
CAN_MANAGE,CAN_USE,CAN_VIEW,CAN_MONITOR,IS_OWNER
- Alertes:
* L'interface utilisateur du Workspace désigne l'accès en lecture seule comme CAN VIEW, tandis que l'API Permissions utilise CAN READ pour représenter le même niveau d'accès.
Les niveaux d'autorisation autorisés pour les ressources ne peuvent pas nécessairement être appliqués aux ressources utilisant le mappage permissions de niveau supérieur. Pour les niveaux d'autorisation valides pour le mappage permissions de niveau supérieur, consultez les autorisations.
La syntaxe suivante montre comment déclarer des autorisations pour un type de ressource (dans cet exemple, les pipelines) dans le mappage resources de niveau supérieur et dans un mappage resources au sein d'une cible :
# ...
resources:
pipelines:
<some-programmatic-identifier-for-this-pipeline>:
# ...
permissions:
- user_name: <user-name> # Or:
group_name: <group-name-1> # Or:
service_principal_name: <service-principal-name>
level: <permission-level>
# ...
targets:
<some-programmatic-identifier-for-this-target>:
resources:
pipelines:
<some-programmatic-identifier-for-this-pipeline>:
# ...
permissions:
- user_name: <user-name> # Or:
group_name: <group-name> # Or:
service_principal_name: <service-principal-name>
level: <permission-level>
# ...
# ...
Toutes les autorisations déclarées pour une ressource dans le mappage resources de niveau supérieur sont combinées avec toutes les autorisations déclarées pour ce même mappage resources dans une cible individuelle. Par exemple, étant donné le mappage resources suivant pour la même ressource au niveau supérieur et dans une cible :
bundle:
name: my-bundle
resources:
jobs:
my-job:
# ...
permissions:
- group_name: test-group
level: CAN_VIEW
# ...
targets:
dev:
# ...
resources:
jobs:
my-job:
# ...
permissions:
- user_name: someone@example.com
level: CAN_MANAGE_RUN
# ...
Lorsque vous exécutez databricks bundle validate pour cet exemple, le graphe résultant est le suivant :
{
"...": "...",
"resources": {
"jobs": {
"my-job": {
"permissions": [
{
"level": "CAN_VIEW",
"group_name": "test-group"
},
{
"level": "CAN_MANAGE_RUN",
"user_name": "someone@example.com"
}
],
"...": "..."
}
}
}
}
Ordre de priorité des autorisations
Si vous définissez permissions pour le même utilisateur, groupe ou service principal à plusieurs endroits de votre configuration de bundle, les Bundles d’automatisation déclarative déterminent l’autorisation configurée pour chaque principal sur chaque ressource comme suit :
- Les autorisations au niveau de la ressource remplacent les autorisations de haut niveau : si une ressource définit une autorisation pour un principal, soit dans le mappage
resourcesde haut niveau, soit dans le mappageresourcesd’une cible, les autorisations définies pour la ressource s’appliquent à cette ressource. Declarative Automation Bundles ignore toutes les autorisations de haut niveau ou autorisations de cible pour ce principal sur cette ressource, même si elles accordent un niveau plus élevé. - Les autorisations au même niveau se combinent au niveau le plus élevé : Si un principal a plus d’une autorisation au même niveau, il obtient le plus élevé de ces niveaux d’autorisation. Cela s’applique aux autorisations d’une ressource dans le mappage
resourcesde haut niveau et dans le mappageresourcesd’une cible, ainsi qu’au mappagepermissionsde haut niveau et au mappagepermissionsd’une cible. En conséquence, une cible peut augmenter une autorisation qui est définie au même niveau, mais elle ne peut pas la diminuer.
Ces règles combinent des entrées d’autorisation pour le même user_name, group_name ou service_principal_name. Elles ne déterminent pas l’accès effectif d’un utilisateur, qui peut également provenir des groupes auxquels l’utilisateur appartient. Par exemple, si un job accorde CAN_VIEW à un utilisateur et que le mappage permissions de haut niveau accorde CAN_MANAGE à un groupe auquel appartient l’utilisateur, le job possède deux entrées d’autorisation et l’utilisateur peut gérer le job via le groupe.
Dans la configuration suivante, le groupe test-group possède des autorisations CAN_MANAGE pour le job dans la cible dev, et des autorisations CAN_MANAGE_RUN pour le job dans la cible prod. L’autorisation CAN_VIEW de haut niveau ne s’applique pas au job, car le job définit sa propre autorisation pour test-group. Dans la cible dev, les autorisations CAN_MANAGE_RUN et CAN_MANAGE du job se combinent pour obtenir CAN_MANAGE, le niveau le plus élevé. Si la cible dev définit CAN_VIEW pour le job à la place, test-group conserve CAN_MANAGE_RUN:
bundle:
name: my-bundle
permissions:
- group_name: test-group
level: CAN_VIEW
resources:
jobs:
my-job:
# ...
permissions:
- group_name: test-group
level: CAN_MANAGE_RUN
# ...
targets:
dev:
# ...
resources:
jobs:
my-job:
# ...
permissions:
- group_name: test-group
level: CAN_MANAGE
# ...
prod:
# ...
resources:
jobs:
my-job:
# ...