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.
Warning
La autenticación con Azure Maps mediante un token de API está retirada en GitHub Enterprise Server 3.12 y versiones posteriores. Si actualiza a la versión más reciente de GitHub Enterprise Server en una instancia ya configurada para autenticarse con un token de API, se deshabilitarán los mapas interactivos. Debes volver a configurar la autenticación mediante el control de acceso basado en roles (RBAC) para una aplicación en un inquilino de Microsoft Entra ID (anteriormente Azure AD). Para obtener más información, consulta la sección Características en desuso en las notas de la versión.
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).
-
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.
-
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.
-
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.
-
Configure el acceso al secreto mediante Azure Maps.
- 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.
- Haga clic en Agregar un permiso.
- Haga clic en Azure Maps.
- Seleccione Permisos delegados.
- En "Seleccionar permisos", seleccione "
user_impersonation
". - Para guardar los permisos, haga clic en Agregar permisos.
-
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.
-
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.
-
Desde una cuenta administrativa de GitHub Enterprise Server, en la esquina superior derecha de cualquier página, haz clic en .
-
Si todavía no está en la página "Administrador del sitio", en la esquina superior izquierda, haga clic en Administrador del sitio.
-
En la barra lateral " Administrador del sitio", haz clic en Consola de administración .
-
En la barra lateral "Configuración", haga clic en Privacidad y desactive Modo de privacidad.
-
Para habilitar los mapas interactivos, selecciona "Habilitar representación de GeoJSON".
-
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
openssl rand -hex 32
Almacene la cadena en una ubicación segura a la que pueda hacer referencia en el paso siguiente.
-
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.
-
-
-
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.
-
Espera que se complete la fase de configuración.
Deshabilitación de mapas interactivos
-
Desde una cuenta administrativa de GitHub Enterprise Server, en la esquina superior derecha de cualquier página, haz clic en .
-
Si todavía no está en la página "Administrador del sitio", en la esquina superior izquierda, haga clic en Administrador del sitio.
-
En la barra lateral " Administrador del sitio", haz clic en Consola de administración .
-
En la barra lateral "Configuración", haga clic en Privacidad y desactive Modo de privacidad.
-
Para deshabilitar mapas interactivos, anule la selección de "Habilitar la representación de GeoJSON".
-
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.
-
Espera que se complete la fase de configuración.