Configuración de mapas interactivos

Acerca de los mapas interactivos

Puedes permitir que los usuarios de tu instancia de GitHub Enterprise Server creen mapas interactivos mediante la sintaxis GeoJSON o TopoJSON. Para más información sobre la creación de mapas interactivos, consulta Creación de diagramas.

Para habilitar mapas interactivos, debe proporcionar credenciales de autenticación para Azure Maps.

Requisitos previos

• Para configurar mapas interactivos para su instancia, debe tener acceso administrativo a un inquilino en Microsoft Entra ID. Para obtener más información, póngase en contacto con el administrador de recursos de Microsoft en su empresa o consulte Quickstart: Crear un nuevo inquilino en Microsoft Entra ID en Microsoft Learn.

• Debe conocer el id. del inquilino en Entra ID. Para obtener más información, consulte Obtener los ID de suscripción y de inquilino en el portal de Azure en Microsoft Learn.

• La instancia debe poder acceder a https://login.microsoftonline.com.

Generación de credenciales para Azure Maps

Para generar credenciales para Azure Maps, debe crear una aplicación para el inquilino en Entra ID, proporcionar acceso a la aplicación a una cuenta de Azure Maps y configurar el control de acceso basado en rol (RBAC).

1. Registre una nueva aplicación en su inquilino de Microsoft Entra ID. Para más información, consulta Inicio rápido: Registro de una aplicación con la plataforma de identidad de Microsoft en Microsoft Learn.

   • Cuando especifique los tipos de cuenta admitidos, seleccione Solo las cuentas de este directorio organizativo.

2. Agregar un secreto de cliente. Para más información, consulta Inicio rápido: Registro de una aplicación con la plataforma de identidad de Microsoft en Microsoft Learn.

3. Almacene el valor del secreto en una ubicación segura a la que pueda hacer referencia al configurar la autenticación en tu instancia de GitHub Enterprise Server. Entra nunca mostrará el valor después de salir de la página.

4. Configure el acceso al secreto mediante Azure Maps.

   1. Al ver los detalles de la aplicación que ha configurado en el inquilino de Entra ID, en la barra lateral izquierda, haga clic en Permisosde API.
   2. Haga clic en Agregar un permiso.
   3. Haga clic en Azure Maps.
   4. Seleccione Permisos delegados.
   5. En "Seleccionar permisos", seleccione "user_impersonation".
   6. Para guardar los permisos, haga clic en Agregar permisos.

5. Inicie sesión en una cuenta de Azure Maps. Si no tiene una cuenta, puede crear una. Para obtener más información, consulte el sitio web Azure Maps Account.

6. Configurar RBAC para Azure Maps. Para obtener más información, consulte Autenticación con Azure Maps y Asignar roles de Azure mediante el portal de Azure en Microsoft Learn.

   • En el inquilino de Entra ID, desde Control de acceso (IAM), debe asignar el rol de "Lector de datos de Azure Maps" a "Usuario, grupo o entidad de servicio", seleccionar la aplicación que creó anteriormente en estas instrucciones y completar el formulario.

Habilitación de mapas interactivos

Después de crear una aplicación en el inquilino de Entra ID y generar un secreto para el uso de Azure Maps, puede configurar mapas interactivos en tu instancia de GitHub Enterprise Server.

1. Desde una cuenta administrativa de GitHub Enterprise Server, en la esquina superior derecha de cualquier página, haz clic en .

2. Si todavía no está en la página "Administrador del sitio", en la esquina superior izquierda, haga clic en Administrador del sitio.

3. En la barra lateral " Site admin", haz clic en Consola de administración.

4. En la barra lateral "Configuración", haz clic en Privacidad y desactiva Modo de privacidad.

5. Para habilitar los mapas interactivos, selecciona "Habilitar representación de GeoJSON".

6. Genere una cadena de 32 caracteres para usarla como secreto a fin de evitar la falsificación de solicitud entre sitios (CSRF). Por ejemplo, puede acceder al shell administrativo y usar openssl en tu instancia de GitHub Enterprise Server para generar una cadena. Para más información, consulta Acceder al shell administrativo (SSH).

   Shell

   openssl rand -hex 32
   

   Almacene la cadena en una ubicación segura a la que pueda hacer referencia en el paso siguiente.

7. Debajo de los encabezados, escriba o pegue los detalles de autenticación para Azure Maps.

   • Si la instancia ejecuta GitHub Enterprise Server 3.19, bajo "Azure Maps API Token", escribe o pega tu token.

   • Si la instancia ejecuta GitHub Enterprise Server 3.19 o una versión posterior, debajo de los encabezados, escribe o pega la siguiente información.

     • Opcionalmente, para cambiar el estilo de los mapas representados, en "Id. de mapa base", escriba el identificador para el estilo que desea usar.

     • En los encabezados, escriba o pegue los detalles de autenticación.

       Valor	Descripción	Más información
       ID de cliente de Mapas de Azure	Identificador de cliente de la cuenta de Azure Maps	autenticación Administrar la autenticación en Azure Maps en Microsoft Learn
       id. de cliente de Azure App	Id. de aplicación (cliente) de la aplicación que creó en el inquilino de Entra ID

          [Crear una aplicación de Microsoft Entra y un principal de servicio que pueda acceder a recursos](https://learn.microsoft.com/entra/identity-platform/howto-create-service-principal-portal#sign-in-to-the-application) en Microsoft Learn |
       

       | Id. de inquilino de Azure | Identificador del inquilino en Entra ID | Requisitos previos | | Secreto de cliente de la aplicación Azure | Secreto de cliente que generó para la aplicación en el inquilino de Entra ID | Generar credenciales para Azure Maps | Secreto CSRF | Cadena de 32 caracteres para evitar ataques CSRF | Consulte el paso anterior. |

8. En la barra lateral "Configuración" , haga clic en Guardar configuración.

   Nota:

   Al guardar la configuración en Consola de administración se restablecen los servicios del sistema, lo que podría generar un tiempo de inactividad visible para el usuario.

9. Espera que se complete la fase de configuración.

Deshabilitación de mapas interactivos

1. Desde una cuenta administrativa de GitHub Enterprise Server, en la esquina superior derecha de cualquier página, haz clic en .

2. Si todavía no está en la página "Administrador del sitio", en la esquina superior izquierda, haga clic en Administrador del sitio.

3. En la barra lateral " Site admin", haz clic en Consola de administración.

4. En la barra lateral "Configuración", haz clic en Privacidad y desactiva Modo de privacidad.

5. Para deshabilitar los mapas interactivos, desmarque "Habilitar la representación de GeoJSON".

6. En la barra lateral "Configuración" , haga clic en Guardar configuración.

   Nota:

   Al guardar la configuración en Consola de administración se restablecen los servicios del sistema, lo que podría generar un tiempo de inactividad visible para el usuario.

7. Espera que se complete la fase de configuración.