| tipo_de_página | idiomas | produtos | descrição | urlFragmento |
|---|
amostra | | azul | mapas azuis | aspnetcore | anúncio azul |
| Uma coleção de exemplos que mostram como integrar o Azure Active Directory ao Azure Maps. | Exemplos de AzureMapsAADS |
Exemplos de Mapas do Azure e Azure Active Directory
Estas são 4 amostras diferentes usando AspNetCore C# para iniciar rapidamente a autenticação do Azure AD no Azure Maps. Cada amostra utiliza diferentes protocolos de autenticação, dependendo da necessidade da aplicação, que são suportados pelo Azure AD e pelo Azure Role Based Access Control (RBAC).
Conteúdo
Descreva o conteúdo do arquivo do repositório. Ele ajuda os usuários a navegar na base de código, construir a configuração e quaisquer ativos relacionados.
| Arquivo/pasta | Descrição |
|---|
src/ImplicitGrant | Amostras usadas para mostrar a autenticação do usuário sem um componente de servidor. |
src/OpenIdConnect | Amostras usando o protocolo recomendado pela Microsoft para aplicativos Web seguros |
src/ClientGrant | Amostras mostrando autenticação de aplicativo sem interação do usuário. |
.gitignore | Defina o que ignorar no momento do commit. |
CONTRIBUTING.md | Diretrizes para contribuir com a amostra. |
README.md | O leia-me inicial. |
LICENSE | A licença da amostra. |
Pré-requisitos
Antes de baixar essas amostras
- Visual Studio 2019 ou Visual Studio Code com ASP.NET e carga de trabalho de desenvolvimento web .
- Você precisará de uma assinatura do Azure. Inscreva-se para obter uma conta gratuita, se necessário.
- um SKU gratuito para o Azure Active Directory associado à assinatura do Azure.
Configurar
No Azure Active Directory, crie um novo registro de aplicativo
- Este registro de aplicativo representará o(s) aplicativo(s) web.
- Cada amostra específica descreverá as etapas necessárias para os diferentes protocolos de autenticação.
- Para este repositório de amostra, o mesmo registro de aplicativo pode ser usado.
- Para produção recomendamos um registro de aplicação distinto para cada aplicação web. Além disso, é altamente recomendável usar a Identidade Gerenciada do Azure para qualquer autenticação não interativa no Azure Mapas. Isso economizará custos de gerenciamento de credenciais.
- Para o nome de exibição, podemos chamá-lo de "WebApp" e deixar o uri de redirecionamento vazio por enquanto e seguir as amostras individuais
README.md .
No Portal do Azure, crie uma conta do Azure Maps
- Pesquise "Azure Maps" em criar novo recurso e siga o portal para criar uma nova conta.
- Assim que a conta for criada, recupere o ID do Cliente Azure Mapas e mantenha-o disponível para a amostra específica que deseja executar.
- Este valor deve ser usado no x-ms-client-id com todas as solicitações HTTP.
- Se estiver usando qualquer SDK, adicione-o às opções de autenticação (JS).
Executando a amostra
- A execução dos exemplos do Web Applicaton é baseada na documentação do AspNetCore MVC v2.2
- Depois que todos os README.md de amostra individual tiverem sido configurados, Debug (tecla F5) deverá compilar e iniciar o aplicativo.
- Certifique-se de executar o aplicativo da web com HTTPS configurado.
- Se for solicitado o desenvolvimento do certificado HTTPS via IIS ou AspNetCore, aceite a solicitação para confiar no certificado.
Conceitos-chave
- A utilização do Azure Maps Web SDK suporta 2 abordagens para tokens de acesso Azure AD.
- Se um componente de servidor como o AspNetCore MVC estiver disponível para sua aplicação, recomendamos o OpenID Connect.
- No caso de nenhum componente de servidor, você deverá usar a concessão implícita para uma experiência de entrada interativa do usuário. No entanto, no caso de não haver entrada interativa, deve existir algum componente do servidor para recuperar um token de acesso e fornecê-lo ao SDK Web do Azure Mapas.
- A utilização da Biblioteca de Autenticação de Serviço do Azure ajudará a reduzir a complexidade e o custo da gestão de credenciais e permitirá que as Identidades Geridas do Azure sejam utilizadas na plataforma hospedada, como as Máquinas Virtuais do Azure ou o Serviço de Aplicações do Azure.
Contribuindo
Este projeto aceita contribuições e sugestões. A maioria das contribuições exige que você concorde com um Contrato de Licença de Colaborador (CLA), declarando que você tem o direito de nos conceder, e realmente nos concede, os direitos de uso de sua contribuição. Para obter detalhes, visite https://cla.opensource.microsoft.com.
Quando você envia uma solicitação pull, um bot CLA determinará automaticamente se você precisa fornecer um CLA e decorará o PR adequadamente (por exemplo, verificação de status, comentário). Basta seguir as instruções fornecidas pelo bot. Você só precisará fazer isso uma vez em todos os repositórios que usam nosso CLA.
Este projeto adotou o Código de Conduta de Código Aberto da Microsoft. Para obter mais informações, consulte as Perguntas frequentes sobre o Código de Conduta ou entre em contato com [email protected] com perguntas ou comentários adicionais.
