Configurar mapas interativos

Sobre mapas interativos

Você pode permitir que os usuários de sua instância do GitHub Enterprise Server criem mapas interativos usando a sintaxe GeoJSON ou TopoJSON. Para saber mais sobre como criar mapas interativos, confira Criando diagramas.

Para habilitar mapas interativos, você deve fornecer credenciais de autenticação para Azure Maps.

Pré-requisitos

• Para configurar mapas interativos para sua instância, você deve ter acesso administrativo a um locatário no Microsoft Entra ID. Para obter mais informações, entre em contato com o administrador dos recursos da Microsoft em sua empresa ou consulte Quickstart: Criar um novo locatário no Microsoft Entra ID no Microsoft Learn.

• Você deve saber a ID do seu inquilino no Entra ID. Para obter mais informações, consulte Obter IDs de assinatura e locatário no portal do Azure, no Microsoft Learn.

• Sua instância deve ser capaz de acessar https://login.microsoftonline.com.

Gerando credenciais para Azure Maps

Para gerar credenciais para Azure Maps, você deve criar um aplicativo para seu locatário na ID do Entra, fornecer ao aplicativo acesso a uma conta Azure Maps e configurar o RBAC (controle de acesso baseado em função).

1. Registre um novo aplicativo em seu locatário do Entra ID. Para obter mais informações, consulte Início rápido: Registrar um aplicativo na plataforma de identidade da Microsoft no Microsoft Learn.

   • Ao especificar tipos de contas com suporte, selecione Somente contas neste diretório organizacional.

2. Adicionar um segredo do cliente. Para obter mais informações, consulte Início rápido: Registrar um aplicativo na plataforma de identidade da Microsoft no Microsoft Learn.

3. Armazene o valor do segredo em um local seguro que você possa referenciar ao configurar a autenticação em sua instância do GitHub Enterprise Server. O Entra nunca exibirá o valor depois que você sair da página.

4. Configure o acesso ao segredo pelo Azure Maps.

   1. Ao visualizar os detalhes do aplicativo que você configurou no locatário do Entra ID, na barra lateral esquerda, clique em Permissões da API.
   2. Clique em Adicionar uma permissão.
   3. Clique em Azure Maps.
   4. Selecione Permissões delegadas.
   5. Em “Selecionar permissões”, selecione “user_impersonation”.
   6. Para salvar as permissões, clique em Adicionar permissões.

5. Entre em uma conta Azure Maps. Se não tiver uma conta, você poderá criar uma. Para obter mais informações, consulte o site Azure Maps Account.

6. Configure o RBAC para Azure Maps. Para obter mais informações, consulte Autenticação com o Azure Maps e Atribuir funções do Azure usando o portal do Azure no Microsoft Learn.

   • No locatário do Entra ID, em Controle de acesso (IAM), você deve atribuir a função de “Leitor de Dados do Azure Mapas” a “Usuário, grupo ou entidade de serviço”, selecionar o aplicativo criado anteriormente nestas instruções e preencher o formulário.

Habilitar mapas interativos

Depois de criar um aplicativo em seu locatário do Entra ID e gerar um segredo para o uso do Azure Mapas, você pode configurar mapas interativos em sua instância do GitHub Enterprise Server.

1. Em uma conta administrativa no GitHub Enterprise Server, no canto superior direito de qualquer página, clique em .

2. Se você ainda não estiver na página "Administração do site", no canto superior esquerdo, clique em Administração do site.

3. Na barra lateral " Site admin", clique em Console de Gerenciamento.

4. Na barra lateral "Settings", clique em Privacy e desmarque Private mode.

5. Para habilitar mapas interativos, selecione "Habilitar renderização de GeoJSON".

6. Gere uma cadeia de 32 caracteres para usar como segredo a fim de evitar falsificações de solicitação entre sites (CSRF). Por exemplo, você pode acessar o shell administrativo e usar openssl em sua instância do GitHub Enterprise Server para gerar uma sequência de caracteres. Para saber mais, confira Acessar o shell administrativo (SSH).

   Shell

   openssl rand -hex 32
   

   Armazene a sequência de caracteres em um local seguro que você possa referenciar na próxima etapa.

7. Abaixo dos títulos, digite ou cole os detalhes de autenticação para Azure Maps.

   • Se a sua instância executa o GitHub Enterprise Server 3.20, digite ou cole o token abaixo de "Azure Mapas API Token".

   • Se a sua instância executa o GitHub Enterprise Server 3.20 ou versões posteriores, digite ou cole abaixo dos títulos as informações a seguir.

     • Opcionalmente, para alterar o estilo dos mapas renderizados, em “ID do mapa base”, digite a ID do estilo que você deseja usar.

     • Sob os títulos, digite ou cole seus detalhes de autenticação.

       Valor	Descrição	Mais Informações
       ID do cliente do Azure Maps	ID do cliente para sua conta de Azure Maps	Gerenciar autenticação no Azure Maps no Microsoft Learn
       Azure App ID do cliente	ID do aplicativo (cliente) para o aplicativo que você criou no locatário do Entra ID

          [Criar uma aplicação e um principal de serviço do Microsoft Entra que podem acessar recursos](https://learn.microsoft.com/entra/identity-platform/howto-create-service-principal-portal#sign-in-to-the-application) no Microsoft Learn |
       

       | ID do locatário do Azure | ID do seu locatário no Entra ID | Pré-requisitos | | Segredo do Cliente do Aplicativo Azure | O segredo do cliente que você gerou para o aplicativo em seu locatário do Entra ID | Gerando credenciais para Azure Maps | Segredo CSRF | Sequência de 32 caracteres para evitar ataques CSRF | Veja a etapa anterior. |

Desabilitar mapas interativos

1. Em uma conta administrativa no GitHub Enterprise Server, no canto superior direito de qualquer página, clique em .
2. Se você ainda não estiver na página "Administração do site", no canto superior esquerdo, clique em Administração do site.
3. Na barra lateral " Site admin", clique em Console de Gerenciamento.
4. Na barra lateral "Settings", clique em Privacy e desmarque Private mode.
5. Para desabilitar mapas interativos, desmarque “Habilitar renderização de GeoJSON”.