Skip to main content

Esta versión de GitHub Enterprise Server se discontinuará el 2025-03-05. No se realizarán lanzamientos de patch, ni siquiera para problemas de seguridad críticos. Para obtener rendimiento mejorado, seguridad mejorada y nuevas características, actualice a la versión más reciente de GitHub Enterprise Server. Para obtener ayuda con la actualización, póngase en contacto con el soporte técnico de GitHub Enterprise.

Configuración de mapas interactivos

Puede habilitar la visualización de mapas interactivos en la interfaz web de tu instancia de GitHub Enterprise Server.

¿Quién puede utilizar esta característica?

People with access to the Consola de administración can configure interactive maps.

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

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.

  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.