Atribuir uma identidade gerenciada a um tópico ou domínio personalizado da Grade de Eventos

Este artigo mostra como usar o portal do Azure ou a CLI para atribuir uma identidade gerenciada atribuída pelo sistema ou pelo usuário a um tópico ou domínio personalizado da Grade de Eventos.

Habilitar identidade ao criar um tópico ou domínio

Azure portal

No portal do Azure, ao criar um tópico ou um domínio, você pode atribuir uma identidade atribuída pelo sistema ou duas identidades atribuídas pelo usuário, mas não os dois tipos de identidades. Depois que o tópico ou domínio for criado, você poderá atribuir os dois tipos de identidades seguindo as etapas na seção Habilitar identidade para um tópico ou domínio existente.

Habilitar identidade atribuída ao sistema

Na página Segurança do tópico ou assistente de criação de domínio, selecione Ativar identidade atribuída ao sistema.

Habilitar identidade atribuída ao usuário

1. Na página Segurança do tópico ou assistente de criação de domínio, selecione Adicionar identidade atribuída ao usuário.

2. Na janela Selecionar identidade atribuída ao usuário, selecione a assinatura que tem a identidade atribuída ao usuário, selecione a identidade atribuída ao usuário e clique em Selecionar.

   

CLI do Azure

Você também pode usar a CLI do Azure para criar um tópico ou um domínio personalizado com uma identidade atribuída pelo sistema. No momento, a CLI do Azure não dá suporte à atribuição de uma identidade atribuída pelo usuário a um tópico ou a um domínio.

Use o comando az eventgrid topic create com o parâmetro --identity definido como systemassigned. Se você não especificar um valor para este parâmetro, o valor padrão noidentity será usado.

# create a custom topic with a system-assigned identity
az eventgrid topic create -g <RESOURCE GROUP NAME> --name <TOPIC NAME> -l <LOCATION>  --identity systemassigned

Da mesma forma, você pode usar o comando az eventgrid domain create para criar um domínio com uma identidade atribuída ao sistema.

Habilitar identidade para um tópico ou domínio personalizado existente

Nesta seção, você aprende a habilitar uma identidade atribuída ao sistema ou ao usuário para um tópico ou domínio personalizado existente.

Azure portal

Ao usar portal do Azure, você pode atribuir uma identidade atribuída pelo sistema e até duas identidades atribuídas pelo usuário a um tópico ou domínio existente.

Os procedimentos a seguir mostram como habilitar uma identidade para um tópico personalizado. As etapas para habilitar uma identidade para um domínio são semelhantes.

1. Acesse o portal do Azure.
2. Procure Tópicos da Grade de Eventos na barra de pesquisa na parte superior.
3. Selecione o tópico personalizado para o qual deseja habilitar a identidade gerenciada.
4. Selecione identidade no menu à esquerda.

Para atribuir uma identidade atribuída ao sistema a um tópico

1. Na guia Sistema atribuído, ative a chave para habilitar a identidade.

2. Selecione Salvar na barra de ferramentas para salvar a configuração.

   

Para atribuir uma identidade atribuída ao usuário a um tópico

1. Crie uma identidade atribuída ao usuário seguindo as instruções no artigo Gerenciar identidades gerenciadas e atribuídas ao usuário.

2. Na página Identidade, alterne para a guia Usuário atribuído no painel direito e selecione + Adicionar na barra de ferramentas.

   

3. Na janela Adicionar identidade gerenciada pelo usuário, siga estas etapas:

   1. Selecione a Assinatura do Azure que possui a identidade atribuída pelo usuário.
   2. Selecione a identidade atribuída pelo usuário.
   3. Selecione Adicionar.

4. Atualize a lista na guia Usuário atribuído para ver a identidade atribuída ao usuário adicionada.

É possível usar etapas semelhantes para habilitar uma identidade para um domínio de Grade de Eventos.

CLI do Azure

Você também pode usar a CLI do Azure para atribuir uma identidade atribuída pelo sistema a um domínio ou tópico personalizado existente. No momento, a CLI do Azure não dá suporte à atribuição de uma identidade atribuída pelo usuário a um tópico ou a um domínio.

Use o comando az eventgrid topic update com --identity definido como systemassigned para habilitar a identidade atribuída pelo sistema para um tópico personalizado existente. Se quiser desabilitar a identidade, especifique noidentity como o valor.

# Update the topic to assign a system-assigned identity. 
az eventgrid topic update -g $rg --name $topicname --identity systemassigned --sku basic 

O comando para atualizar um domínio existente é semelhante (az eventgrid domain update).

Próximas etapas

Adicione a identidade a uma função apropriada (por exemplo, remetente de dados do Barramento de Serviço) no destino (por exemplo, uma fila do Barramento de Serviço). Para etapas detalhadas, confira Conceder à identidade gerenciada o acesso ao destino da Grade de Eventos.