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 AUTOTITLE.

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

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 Obtenha IDs de assinatura e locatário no portal do Azure no Microsoft Learn.

• Sua instância deve ser capaz de acessar .

Gerando credenciais para Azure Mapas

Para gerar credenciais para Azure Mapas, você deve criar um aplicativo para seu locatário na ID do Entra, fornecer ao aplicativo acesso a uma conta Azure Mapas 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 Mapas.

   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 Mapas.
   4. Selecione Permissões delegadas.
   5. Em “Selecionar permissões”, selecione “”.
   6. Para salvar as permissões, clique em Adicionar permissões.

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

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

   • Em seu tenant do Entra ID, do Access control (IAM), você deve atribuir a função "Azure Mapas Data Reader" a "Usuário, grupo ou entidade de serviço", selecionar o aplicativo criado anteriormente nestas instruções e concluir o formulário.

Habilitar mapas interativos

Depois de criar um aplicativo no seu locatário do Entra ID e gerar um segredo para uso no 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 em sua instância do GitHub Enterprise Server para gerar uma sequência de caracteres. Para saber mais, confira AUTOTITLE.

   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 Mapas.

   • Se sua instância executar GitHub Enterprise Server 3.15, abaixo de "token de API Azure Mapas", digite ou cole seu token.

   • Se a sua instância executa o GitHub Enterprise Server 3.15 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 Mapas	Gerenciar autenticação no Azure Mapas 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 Mapas | 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”.