gerenciar solicitações de acesso
Visualização
Este recurso está em pré-visualização pública.
O recurso de solicitação de acesso permite que os usuários solicitem privilégios para objetos protegíveis no Unity Catalog. Esta página explica como configurar destinos de solicitação de acesso como administrador. Esses destinos determinam para onde as solicitações de acesso são enviadas quando os usuários solicitam acesso a objetos de dados.
O que são destinos de solicitação de acesso?
Quando os usuários solicitam acesso a um objeto em Unity Catalog (como uma tabela ou view), a solicitação é enviada para um ou mais destinos configurados. Os destinos podem ser qualquer um dos seguintes:
-
endereços de e-mail
-
Canal do Slack
-
Microsoft Canal de equipes
-
Ponto final do Webhook
-
Um URL de redirecionamento (para o sistema de solicitação de acesso externo da sua organização)
Somente um URL de redirecionamento pode ser configurado por objeto. Se um URL estiver definido, nenhum outro destino poderá ser definido e os usuários serão redirecionados para esse URL em vez de visualizar o formulário de solicitação no produto.
Como funcionam os destinos de solicitação de acesso
Os destinos de solicitação de acesso podem ser configurados em qualquer objeto no Unity Catalog, incluindo metastores, catálogos, esquemas, tabelas, volumes, visualizações, credenciais de armazenamento, credenciais de serviço, locais externos e conexões. Se um objeto tiver um destino de solicitação de acesso configurado, os usuários poderão solicitar acesso se tiverem o privilégio BROWSE ou um URL direto para o objeto.
Ao enviar uma solicitação, os usuários podem solicitar acesso para uma ou mais entidades. Isso inclui a si mesmos, a entidade de serviço, outros usuários ou grupos. A solicitação é encaminhada para os destinos configurados.
Se vários destinos estiverem configurados, a solicitação será enviada para todos eles. Se nenhum destino for configurado, os usuários não poderão solicitar acesso ao objeto. Por default, os objetos não têm um destino configurado. No entanto, como administrador do metastore e workspace , você pode habilitar destinos email default para entregar solicitações de acesso ao proprietário apropriado, mesmo quando nenhum destino estiver explicitamente configurado.
Se um URL de redirecionamento estiver configurado, os usuários serão levados para o URL e não verão o formulário de solicitação de acesso. Os administradores do espaço de trabalho podem configurar destinos externos seguindo as instruções em gerenciar destinos de notificação.
Comportamento de herança de destino
Ao configurar um destino em níveis superiores da hierarquia de objetos Unity Catalog , essa configuração também se aplica a todos os objetos filhos que ainda não possuem um destino definido. Por exemplo, se você configurar um destino em um catálogo, esse destino será herdado por todos os esquemas e objetos do catálogo, exceto aqueles que já possuem um destino.

Habilite destinos default email
Databricks Recomenda-se habilitar destinos default email . Isso garante que as solicitações de acesso sejam entregues mesmo quando nenhum destino é configurado manualmente. Quando ativado, as solicitações de objetos do catálogo são enviadas para o endereço email do proprietário do catálogo, e as solicitações de objetos fora de um catálogo, como locais externos, são enviadas para o endereço email do proprietário do objeto.
A ativação de destinos default email garante que as solicitações de acesso sejam entregues mesmo quando nenhum destino estiver configurado manualmente para um objeto. Esta é a maneira mais rápida de começar a receber e responder a solicitações em toda a sua metastore do Unity Catalog.
Para habilitar destinos de default, é necessário ser administrador do metastore e administrador d workspace.
- No canto superior direito da sua página inicial do workspace, clique na sua foto de perfil e selecione Configurações .
- Clique em Notificações .
- Ative a opção "Habilitar destinos email default para solicitações de acesso em UC" .
Configure os destinos das solicitações de acesso em um objeto.
Para configurar destinos de solicitação de acesso em um objeto, você deve ser o proprietário do objeto, ter o privilégio MANAGE no objeto ou ser um administrador do metastore.
Os passos desta seção mostram como configurar destinos de solicitação de acesso usando o Catalog Explorer. Você também pode configurar destinos usando a API de Destinos de Solicitação de Acesso.
Configurar destinos para objetos existentes
-
Em Databricks workspace, clique em
Catalog .
-
Selecione um objeto protegível.
-
Clique no menu kebab “
” e selecione “gerenciar destinos de solicitações de acesso ”.
-
Selecione um ou mais destinos email ou externos, ou configure um URL de redirecionamento. Se um URL for selecionado, nenhum outro tipo de destino poderá ser adicionado.

-
Clique em Atualizar .
Configure os destinos ao criar um catálogo.
- Em Databricks workspace, clique em
Catalog .
- Clique no
ícone de mais. Em seguida, clique em Criar um catálogo .
- Insira um nome para o seu catálogo e clique em Criar catálogo .
- Na próxima janela modal, clique em Configurar catálogo .
- Na seção "Solicitações de Acesso" , adicione, modifique ou remova destinos conforme necessário. O email do proprietário do catálogo é incluído como destino por default.

- Clique em Avançar e, em seguida, clique em Salvar .
Os destinos são herdados na hierarquia de objetos Unity Catalog . Ao criar um esquema dentro de um catálogo que possui um destino de solicitação de acesso, o modal Criar um novo esquema menciona os destinos herdados:

Para modificar esses destinos no esquema, consulte Configurar destinos para objetos existentes.
Exemplos de solicitações de acesso
A seção a seguir mostra exemplos de solicitações de acesso enviadas para destinos diferentes.
e-mail
Os e-mails de solicitação de acesso são enviados a partir do endereço noreply@databricks.com.

Slack

Webhook (JSON)
{
"requesterName": "<first-name> <last-name> (<email>)",
"objectName": "<catalog>.<schema>.<table>",
"objectType": "Table",
"privileges": "SELECT",
"principalName": "<group-name>",
"onBehalfOf": "<group-name>",
"onBehalfOfType": "Group",
"comment": "My team needs access to run queries on this table.",
"databricksWorkspaceUrl": "https:/<account>.databricks.com/explore/data/<catalog>/<schema>/<table>?o=<table-id>&activeTab=permissions&showGrantModal=true&requestedPrivileges=SELECT&groupId=<group-id>"
}
Para obter informações sobre como integrar webhooks com ferramentas comuns, consulte o seguinte:
Aprovar uma solicitação de acesso
Para aprovar uma solicitação de acesso, siga o link enviado para sua notificação de solicitação de acesso. O link abre uma caixa de diálogo modal no seu workspace que exibe o solicitante, o objeto e os privilégios solicitados.

Em seguida, selecione um dos seguintes métodos de aprovação:
-
Adicione o principal ao (s) grupo (s) para adicionar o solicitante a um ou mais grupos existentes que tenham pelo menos um dos privilégios solicitados.

-
Conceda privilégios ao diretor para permitir que eles acessem o objeto diretamente. Você também pode selecionar predefinições de privilégios, como Data Reader , para conceder a um usuário uma coleção de privilégios.
