Gerenciar autenticação no Azure Mapas

Quando você cria uma conta do Azure Mapas, a ID do cliente e as chaves compartilhadas são criadas automaticamente. Esses valores são necessários para autenticação ao usar a ID do Microsoft Entra ou a autenticação de chave compartilhada.

Pré-requisitos

Entre no portal do Azure. Se você não tiver uma assinatura do Azure, crie uma conta gratuita antes de começar.

• Uma familiarização com identidades gerenciadas para recursos do Azure. Lembre-se de entender os dois tipos de identidade gerenciados e como eles diferem.
• Uma conta do Azure Mapas.
• Uma familiarização com a Autenticação do Azure Mapas.

Exibir detalhes da autenticação

Para exibir os detalhes da autenticação do Azure Mapas:

1. Entre no portal do Azure.

2. Selecione Todos os recursos na seção serviços do Azure e selecione sua conta do Azure Mapas.

   

3. Selecione Autenticação na seção de configurações do painel esquerdo.

   

Escolher uma categoria de autenticação

Dependendo das necessidades do aplicativo, há caminhos específicos para a segurança do aplicativo. A ID do Microsoft Entra define categorias de autenticação específicas para dar suporte a uma ampla gama de fluxos de autenticação. Para escolher a melhor categoria para seu aplicativo, consulte as categorias de aplicativo.

Como adicionar e remover identidades gerenciadas

Para habilitar a autenticação de token sas (assinatura de acesso compartilhado) com a API REST do Azure Mapas, você precisa adicionar uma identidade gerenciada atribuída pelo usuário à sua conta do Azure Mapas.

Criar uma identidade gerenciada

Você pode criar uma identidade gerenciada atribuída pelo usuário antes ou depois de criar uma conta de mapa. Você pode adicionar a identidade gerenciada por meio do portal, dos SDKs de gerenciamento do Azure ou do modelo do ARM (Azure Resource Manager). Para adicionar uma identidade gerenciada atribuída pelo usuário por meio de um modelo do ARM, especifique o identificador de recurso da identidade gerenciada atribuída pelo usuário.

"identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
        "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/example/providers/Microsoft.ManagedIdentity/userAssignedIdentities/exampleidentity": {}
    }
}

Remover uma identidade gerenciada

Você pode remover uma identidade atribuída pelo sistema desabilitando o recurso por meio do portal ou do modelo do Azure Resource Manager da mesma forma que ele foi criado. As identidades atribuídas pelo usuário podem ser removidas individualmente. Para remover todas as identidades, defina o tipo de identidade como "None".

Remover uma identidade atribuída pelo sistema dessa maneira também a exclui da ID do Microsoft Entra. As identidades atribuídas pelo sistema também são removidas automaticamente da ID do Microsoft Entra quando a conta do Azure Mapas é excluída.

Para remover todas as identidades usando o modelo do Azure Resource Manager, atualize esta seção:

"identity": {
    "type": "None"
}

Escolher um cenário de autenticação e autorização

Esta tabela descreve cenários comuns de autenticação e autorização no Azure Mapas. Cada cenário descreve um tipo de aplicativo que pode ser usado para acessar a API REST do Azure Mapas. Use os links para aprender informações detalhadas de configuração para cada cenário.

Exibir definições de função predefinidas do Azure Maps

Para exibir a definição de função incorporada do Azure Maps:

1. No painel esquerdo, selecione Controle de acesso (IAM) .

2. Selecione a guia Funções.

3. Na caixa de pesquisa, insira Azure Mapas.

Os resultados exibem as definições de função interna disponíveis para o Azure Mapas.

Exibir atribuições de função

Para exibir usuários e aplicativos que receberam acesso para o Azure Mapas, acesse o Controle de Acesso (IAM). Lá, selecione atribuições de função e, em seguida, filtre pelo Azure Mapas.

1. No painel esquerdo, selecione Controle de acesso (IAM) .

2. Selecione a guia Atribuições de função.

3. Na caixa de pesquisa, insira Azure Mapas.

Os resultados exibem as atribuições de função atuais do Azure Mapas.

Exiba os usuários e aplicativos do View incorporados que receberam acesso.

Solicitar tokens para o Azure Maps

Solicite um token do ponto de extremidade do Microsoft Entra. Em sua solicitação de ID do Microsoft Entra, use os seguintes detalhes:

Para obter mais informações sobre como solicitar tokens de acesso da ID do Microsoft Entra para usuários e entidades de serviço, consulte cenários de autenticação para a ID do Microsoft Entra. Para exibir cenários específicos, consulte a tabela de cenários.

Gerenciar e rotacionar chaves compartilhadas

Suas chaves de assinatura do Azure Mapas são semelhantes a uma senha raiz para sua conta do Azure Mapas. Sempre tenha cuidado para proteger suas chaves de assinatura. Use o Azure Key Vault para gerenciar e girar suas chaves com segurança. Evite distribuir chaves de acesso para outros usuários, codificá-las ou salvá-las em qualquer lugar em texto sem formatação acessível para outras pessoas. Se você acredita que suas chaves podem ter sido comprometidas, gire-as.

Girar manualmente as chaves de assinatura

Para ajudar a manter sua conta do Azure Mapas segura, recomendamos girar periodicamente suas chaves de assinatura. Se possível, use o Azure Key Vault para gerenciar suas chaves de acesso. Se você não estiver usando o Key Vault, precisará girar manualmente suas chaves.

Duas chaves de assinatura são atribuídas para que você possa alternar suas chaves. Ter duas chaves garante que seu aplicativo mantenha o acesso ao Azure Mapas durante todo o processo.

Para rotacionar suas chaves de assinatura do Azure Maps no portal do Azure:

1. Atualize o código do aplicativo para fazer referência à chave secundária da conta do Azure Mapas e implantar.
2. No portal do Azure, navegue até sua conta do Azure Mapas.
3. Em Configurações, selecione Autenticação.
4. Para regenerar a chave primária para sua conta do Azure Mapas, selecione o botão Regenerar ao lado da chave primária.
5. Atualize o código do aplicativo para fazer referência à nova chave primária e implantar.
6. Regenerar a chave secundária da mesma maneira.

Próximas etapas

Localize as métricas de uso da API de sua conta dos Azure Mapas:

Explore amostras que mostram como integrar o Microsoft Entra ID ao Azure Mapas: