Condições do IAM para acesso granular

Nesta página, descrevemos como restringir o acesso às suas conexões usando as condições do IAM.

Uma condição do IAM permite ter controle granular sobre os recursos do Integration Connectors. Por padrão, um usuário do conector ou papel do Integration Connectors pode realizar todas as operações compatíveis em uma conexão. Ao usar as condições do IAM, é possível restringir um usuário ou papel específico para realizar apenas as operações selecionadas em uma conexão. Por exemplo, é possível restringir um usuário para que ele só possa modificar as conexões com nomes que começam com test-connection e não tenha outras permissões nas conexões, como assinar eventos ou visualizar os metadados do esquema.

Antes de começar

O Integration Connectors usa o Identity and Access Management (IAM) do Google Cloud para gerenciar papéis e permissões para os recursos do Integration Connectors. Portanto, antes de especificar ou modificar condições do IAM para seus recursos do Integration Connectors, familiarize-se com os seguintes conceitos do IAM:

Como adicionar condições do IAM

Para adicionar uma condição do IAM a um recurso do Integration Connectors, você precisa das seguintes informações:

  • URI de recurso nomeado: todo recurso no Integration Connectors tem um URI de recurso exclusivo. Por exemplo, o URI do recurso de conexão é projects/PROJECT_ID/locations/CONNECTION_LOCATION/connections/{connection_name}. Para ver a lista completa de todos os URIs disponíveis, consulte Recursos REST do Integration Connectors. Para controlar as permissões de acesso de um recurso em um nível granular, nomeie seu recurso de acordo com uma convenção de nomenclatura. Com base nos seus requisitos, você pode decidir qual convenção de nomenclatura quer usar. Por exemplo, é possível prefixar a palavra marketing- para todas as conexões que pertencem à equipe de marketing. Neste exemplo, o URI de recurso das conexões da equipe de marketing começará com projects/PROJECT_ID/locations/CONNECTION_LOCATION/connections/marketing-.
  • Permissões somente para o pai: verifique se um recurso ou os recursos filhos dele exigem permissão somente para o pai. Para mais informações, consulte Permissões somente para pais.
  • Tipo de recurso: é possível restringir ainda mais o escopo dos recursos, filtrando um tipo de recurso na condição. O Integration Connectors é compatível com as condições dos seguintes recursos:
    Nome do recurso Tipo de recurso
    Conexão connectors.googleapis.com/Connection
    ManagedZone connectors.googleapis.com/ManagedZone
    EndpointAttachment connectors.googleapis.com/EndpointAttachment
    EventSubscription connectors.googleapis.com/EventSubscription
    ConnectionSchemaMetadata connectors.googleapis.com/ConnectionSchemaMetadata

Exemplos

A tabela a seguir lista as Condições de recursos de amostra que podem ser aplicadas a um Usuário do conector ou a um papel do Integration Connectors.

Condição de recurso do IAM Descrição
(resource.name.startsWith
("projects/PROJECT_ID/locations/CONNECTION_LOCATION/
connections/marketing-") && resource.type == "connectors.googleapis.com/Connection")
|| (resource.type != "connectors.googleapis.com/Connection"
&& resource.name.extract("/operations/{operation}") == "")
Um usuário ou um papel ao qual você aplica essa condição só pode realizar as seguintes operações:
  • Listar todas as conexões e operações de longa duração.
  • Realizar operações de recebimento, criação, atualização e exclusão em conexões com nome que começa com marketing-.

O usuário não pode visualizar, cancelar ou excluir operações de longa duração individuais. Para permitir que o usuário acompanhe o progresso das operações, consulte Permitir que usuários restritos acompanhem operações.

(resource.name.startsWith
("projects/PROJECT_ID/locations/CONNECTION_LOCATION/
connections/marketing-") && resource.type == "connectors.googleapis.com/Connection") ||
(resource.name.startsWith ("projects/PROJECT_ID/locations/CONNECTION_LOCATION/
connections/marketing-") && resource.type == "connectors.googleapis.com/ConnectionSchemaMetadata")
|| (resource.type != "connectors.googleapis.com/Connection"
&& resource.type != "connectors.googleapis.com/ConnectionSchemaMetadata"
&& resource.name.extract("/operations/{operation}") == "")
Um usuário ou papel ao qual você aplica essa condição só pode realizar as seguintes operações:
  • Listar todas as conexões e operações de longa duração.
  • Realizar operações de recebimento, criação, atualização e exclusão somente para conexões com nome que começa com marketing-.
  • Receber metadados do esquema de conexão somente para conexões com nomes que começam com marketing-.

O usuário não pode visualizar, cancelar ou excluir operações de longa duração individuais.

Permitir que usuários restritos acompanhem operações

Quando as condições nos exemplos anteriores excluem operações, um usuário restrito ainda pode criar, atualizar e excluir as conexões que tem permissão para gerenciar, mas não pode verificar o status das operações de longa duração resultantes. Se um usuário restrito precisar rastrear operações, conceda a ele um papel personalizado separado sem uma condição, que contenha apenas a permissão connectors.operations.get.

Com esse papel, o usuário pode visualizar qualquer operação no projeto, incluindo operações para conexões que não podem ser acessadas de outra forma. Essas são as mesmas informações de conexão que o usuário já pode visualizar, porque ele pode listar todas as conexões. Não conceda as permissões connectors.operations.cancel ou connectors.operations.delete a usuários com acesso restrito por uma condição, porque essas permissões permitiriam que eles cancelassem ou excluíssem operações de qualquer conexão no projeto.

Adicionar condições do IAM para contas de serviço do Application Integration

É possível aplicar as condições do IAM à conta de serviço do Application Integration, o que permite restringir as conexões que a conta de serviço pode acessar durante a execução da integração. Por exemplo, é possível restringir uma conta de serviço para que ela possa acessar apenas conexões com nomes que começam com marketing-. Para mais informações, consulte Aplicar condições do IAM a uma conta de serviço.

A tabela a seguir lista as condições de recursos de amostra que podem ser aplicadas a uma conta de serviço do Application Integration.

Condição de recurso do IAM Descrição
resource.name.startsWith
("projects/PROJECT_ID/locations/CONNECTION_LOCATION/
connections/marketing-")
A conta de serviço à qual você aplica essa condição só pode executar as conexões com nomes que começam com marketing-.

A seguir

Analise as seguintes informações na documentação do IAM: