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 Crear diagramas.

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

Requisitos previos

• Para configurar mapas interactivos para la instancia, debes tener acceso administrativo a un inquilino de Microsoft Entra ID. Para más información, ponte en contacto con el administrador de los recursos de Microsoft de la empresa, o bien consulta Inicio rápido: Creación de un inquilino en Microsoft Entra ID en Microsoft Learn.

• Debe conocer el id. del inquilino en Entra ID. Para más información, consulta Obtención de identificadores de suscripción y cuentas empresariales en Azure Portal 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 a la aplicación acceso a una cuenta de Azure Maps y configurar el control de acceso basado en roles (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 de la cuenta de Azure Maps.

6. Configuración de RBAC para Azure Maps. Para más información, consulta Autenticación con Azure Maps y Asignación de roles de Azure mediante Azure Portal 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 " Administrador del sitio", haz clic en Consola de administración .

4. En la barra lateral "Configuración", haga clic en Privacidad y desactive 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. Bajo los encabezados, escribe o pega los detalles de autenticación para Azure Maps.

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

   • Si la instancia ejecuta GitHub Enterprise Server 3.12 o versiones posteriores, bajo 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 Azure Maps	Id. de cliente de la cuenta de Azure Maps	Administración de la autenticación en Azure Maps en Microsoft Learn
       Id. de cliente de la App de Azure	Id. de aplicación (cliente) de la aplicación que creó en el inquilino de Entra ID	Creación de una aplicación de Microsoft Entra y una entidad de servicio con acceso a los recursos en Microsoft Learn
       Id. de inquilino de Azure	Identificador del inquilino en Entra ID	Requisitos previos
       Secreto de cliente de la App de Azure	Secreto de cliente que generó para la aplicación en el inquilino de Entra ID	Generación de 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.

   Note

   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 " Administrador del sitio", haz clic en Consola de administración .

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

5. Para deshabilitar mapas interactivos, anule la selección de "Habilitar la representación de GeoJSON".

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

   Note

   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.