Defina as permissões para o recurso em Pacotes de Automação Declarativa.
Este artigo descreve como definir permissões para recursos em Declarative Automation Bundles. Para informações sobre recursos suportados em bundles, consulte Recurso de Automação Declarativa Bundles.
Nos arquivos de configuração do pacote Databricks, o senhor pode definir permissões no nível superior para aplicar a todos os recursos definidos no pacote ou pode definir permissões para aplicar a recursos específicos.
Você pode definir permissões para o mesmo usuário, grupo ou service principal tanto no mapeamento permissions de nível superior quanto no mapeamento permissions de um recurso. Para esse recurso, a permissão de nível de recurso tem precedência. Consulte Ordem de precedência de permissões.
Para evitar que usuários não administradores modifiquem os ativos depois que eles forem implantados, implante seu bundle em uma pasta imutável e somente leitura. Consulte Implantações imutáveis.
Definir permissões a serem aplicadas a todos os recursos
Você pode definir permissões para se aplicarem a todos os recursos suportados definidos em resources usando o mapeamento de nível superior permissions . Databricks recomenda esta abordagem para gerenciar as permissões de recursos dos Declarative Automation Bundles.
As permissões definem o nível de permissões permitido para user_name, group_name ou service_principal_name. Os níveis de permissão de nível superior permitidos são CAN_VIEW, CAN_MANAGE e CAN_RUN. Para obter mais informações sobre o mapeamento de nível superior permissions, consulte permissões.
O exemplo a seguir define permissões de nível superior para o alvo dev. O usuário someone@example.com terá permissões CAN_RUN em my-job:
bundle:
name: my-bundle
resources:
jobs:
my-job:
# ...
targets:
dev:
# ...
permissions:
- user_name: someone@example.com
level: CAN_RUN
Definir permissões para um recurso específico
O senhor pode usar o mapeamento permissions em um dashboard, experimento, trabalho, modelo ou definição pipeline em resources para definir uma ou mais permissões para esse recurso.
Cada permissão no mapeamento permissions deve incluir o seguinte:
user_name,group_name, ouservice_principal_name, definido como o nome do usuário, grupo ou entidade de serviço, respectivamente.level, defina com o nome do nível de permissão. Os níveis de permissão permitidos para cada recurso são os seguintes:- alerta:
CAN_EDIT,CAN_MANAGE,CAN_READ,CAN_RUN - Aplicativos:
CAN_MANAGE,CAN_USE - clusters:
CAN_ATTACH_TO,CAN_MANAGE,CAN_RESTART - Painéis:
CAN_EDIT,CAN_MANAGE,CAN_RUN,CAN_READ* - Experimentos:
CAN_EDIT,CAN_MANAGE,CAN_READ,CAN_RUN - Empregos:
CAN_MANAGE,CAN_MANAGE_RUN,CAN_VIEW,IS_OWNER - Modelos:
CAN_EDIT,CAN_MANAGE,CAN_MANAGE_STAGING_VERSIONS,CAN_MANAGE_PRODUCTION_VERSIONS,CAN_READ - pipeline:
CAN_MANAGE,CAN_RUN,CAN_VIEW,IS_OWNER - Escopo secreto:
READ,WRITE,MANAGE - SQL warehouse:
CAN_MANAGE,CAN_USE,CAN_VIEW,CAN_MONITOR,IS_OWNER
- alerta:
* A interface do usuário workspace se refere ao acesso somente para viewcomo CAN VIEW, enquanto a API de Permissões usa CAN READ para representar o mesmo nível de acesso.
Os níveis de permissão permitidos para recurso não podem necessariamente ser aplicados a recurso usando o mapeamento de nível superior permissions. Para obter níveis de permissão válidos para o mapeamento permissions de nível superior, consulte permissões.
A sintaxe a seguir mostra como declarar permissões para um tipo de recurso (neste exemplo, pipeline) no mapeamento de nível superior resources e em um mapeamento resources dentro de um destino:
# ...
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>
# ...
# ...
Todas as permissões declaradas para um recurso no mapeamento resources de nível superior são combinadas com todas as permissões declaradas para o mesmo mapeamento resources em um destino individual. Por exemplo, dado o seguinte mapeamento resources para o mesmo recurso no nível superior e em um destino:
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
# ...
Quando o senhor executa databricks bundle validate para este exemplo, o gráfico resultante é o seguinte:
{
"...": "...",
"resources": {
"jobs": {
"my-job": {
"permissions": [
{
"level": "CAN_VIEW",
"group_name": "test-group"
},
{
"level": "CAN_MANAGE_RUN",
"user_name": "someone@example.com"
}
],
"...": "..."
}
}
}
}
Ordem de precedência das permissões
Se você definir permissions para o mesmo usuário, grupo ou service principal em vários lugares na configuração do seu pacote, os Declarative Automation Bundles determinarão a permissão configurada para cada principal em cada recurso da seguinte forma:
- As permissões de nível de recurso substituem as permissões de nível superior : Se um recurso definir uma permissão para um principal, no mapeamento
resourcesde nível superior ou no mapeamentoresourcesde um destino, as permissões definidas para o recurso se aplicarão a esse recurso. O Declarative Automation Bundles ignora quaisquer permissões de nível superior ou permissões de destino para esse principal nesse recurso, mesmo que elas concedam um nível mais alto. - As permissões no mesmo nível combinam-se para o nível mais alto : se um principal tiver mais de uma permissão no mesmo nível, o principal receberá o mais alto desses níveis de permissão. Isso se aplica às permissões para um recurso no mapeamento de nível superior
resourcese no mapeamentoresourcesde um destino, e ao mapeamento de nível superiorpermissionse ao mapeamentopermissionsde um destino. Como resultado, um destino pode aumentar uma permissão que esteja definida no mesmo nível, mas não pode diminuí-la.
Essas regras combinam entradas de permissão para o mesmo user_name, group_name ou service_principal_name. Eles não determinam o acesso efetivo de um usuário, que também pode vir dos grupos aos quais o usuário pertence. Por exemplo, se um job conceder CAN_VIEW a um usuário e o mapeamento permissions de nível superior conceder CAN_MANAGE a um grupo ao qual o usuário pertence, o job terá duas entradas de permissão e o usuário poderá gerenciar o job por meio do grupo.
Na seguinte configuração, o grupo test-group tem permissões CAN_MANAGE para o job no destino dev, e permissões CAN_MANAGE_RUN para o job no destino prod. A permissão de nível superior CAN_VIEW não se aplica ao job, porque o job define suas próprias permissões para test-group. No destino dev, as permissões CAN_MANAGE_RUN e CAN_MANAGE do job se combinam para CAN_MANAGE, o nível mais alto. Se o destino dev definir CAN_VIEW para o job, test-group manterá 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:
# ...