Настройка интерактивных карт

Сведения об интерактивных картах

Вы можете разрешить пользователям ваш экземпляр GitHub Enterprise Server создавать интерактивные карты с помощью синтаксиса GeoJSON или TopoJSON. Дополнительные сведения о создании интерактивных карт см. в разделе Создание схем.

Для включения интерактивных карт необходимо предоставить учетные данные для аутентификации Azure Maps.

Необходимые компоненты

• Для настройки интерактивных карт для вашего экземпляра необходимо иметь административный доступ к арендатору в Microsoft Entra ID. Для получения дополнительной информации свяжитесь с администратором ресурсов Microsoft в вашей компании или смотрите Быстрый старт: Создать нового арендатора в Microsoft Entra ID на Microsoft Learn.

• Необходимо знать идентификатор клиента для вашего клиента в идентификаторе Entra. Для получения дополнительной информации смотрите Получить идентификаторы подписки и арендаторов в Azure портале на Microsoft Learn.

• Экземпляр должен иметь доступ https://login.microsoftonline.com.

Generate credentials for Azure Maps

Для генерации учетных данных для Azure Maps необходимо создать приложение для вашего арендатора в Entra ID, предоставить приложению доступ к учетной записи Azure Maps и настроить управление доступом по ролям (RBAC).

1. Зарегистрируйте новое приложение в клиенте Идентификатора Записи. Дополнительные сведения см. в кратком руководстве. Регистрация приложения с помощью платформа удостоверений Майкрософт в Microsoft Learn.

   • При указании поддерживаемых типов учетных записей выберите только учетные записи в этом каталоге организации.

2. Добавление секрета клиента. Дополнительные сведения см. в кратком руководстве. Регистрация приложения с помощью платформа удостоверений Майкрософт в Microsoft Learn.

3. Сохраните значение секрета в безопасном расположении, которое можно ссылаться при настройке проверки подлинности на ваш экземпляр GitHub Enterprise Server. Запись никогда не будет отображать значение после выхода страницы.

4. Настройте доступ к секрету с помощью Azure Maps.

   1. При просмотре сведений о приложении, настроенном в клиенте идентификатора записи, на боковой панели слева щелкните разрешения API.
   2. Нажмите кнопку "Добавить разрешение".
   3. Нажмите Azure Maps.
   4. Выберите Делегированные разрешения.
   5. В разделе "Выбор разрешений" выберите "user_impersonation".
   6. Чтобы сохранить разрешения, нажмите кнопку "Добавить разрешения".

5. Войдите в аккаунт Azure Maps. Если у вас нет учетной записи, вы можете создать ее. Для получения дополнительной информации посетите сайт Azure Maps Account.

6. Configure RBAC for Azure Maps. Для получения дополнительной информации см. Аутентификация с Azure Maps и Назначить Azure роли через портал Azure в Microsoft Learn.

   • В вашем арендаторе Entra ID, начиная с Access Control (IAM) вы должны назначить роль «Azure Maps Data Reader» для «Пользователь, группа или принципал сервиса», выбрать ранее созданное приложение в этих инструкциях и заполнить форму.

Включение интерактивных карт

После создания приложения на вашем Entra ID и генерации секрета для Azure Maps, вы можете настроить интерактивные карты на ваш экземпляр GitHub Enterprise Server.

1. В учетной записи администратора GitHub Enterprise Server, в правом верхнем углу любой страницы щелкните .

2. Если вы еще не на странице "Администратор сайта", в левом верхнем углу щелкните Администратор сайта.

3. На боковой панели " "Администратор сайта" щелкните Консоль управления.

4. На боковой панели "Параметры" щелкните "Конфиденциальность " и снимите флажок "Закрытый режим".

5. Чтобы включить интерактивные карты, выберите "Включить отрисовку GeoJSON".

6. Создайте 32-символьную строку, используемую в качестве секрета, чтобы предотвратить подделку запросов между сайтами (CSRF). Например, можно получить доступ к административной оболочке и использовать openssl ваш экземпляр GitHub Enterprise Server для создания строки. Дополнительные сведения см. в разделе Доступ к административной оболочке (SSH).

   Shell

   openssl rand -hex 32
   

   Сохраните строку в безопасном расположении, на которое можно ссылаться на следующем шаге.

7. Под заголовками введите или вставьте данные аутентификации для Azure Maps.

   • Если ваш экземпляр запускает GitHub Enterprise Server 3.20, под «Azure Maps API Token» введите или вставьте свой токен.

   • Если экземпляр выполняет GitHub Enterprise Server 3.20 или более поздней версии, под заголовками введите или вставьте следующие сведения.

     • При необходимости для изменения стиля отрисованных карт в разделе "Базовый идентификатор" введите идентификатор для используемого стиля.

     • В разделе заголовков введите или вставьте сведения о проверке подлинности.

       значение	Описание	Дополнительные сведения
       Azure Map Client ID	Client ID для вашего аккаунта Azure Maps

          [Управление аутентификацией в Azure Maps](https://learn.microsoft.com/azure/azure-maps/how-to-manage-authentication#view-authentication-details) на Microsoft Learn |
       

       | Azure App Client ID | Идентификатор приложения (клиента) для приложения, созданного в клиенте идентификатора записи | Создать Microsoft Entra приложение и принципал сервиса, который сможет получать доступ к ресурсам в Microsoft Learn | | Идентификатор арендатора Azure | Идентификатор клиента в идентификаторе Entra | Prerequisites | | Azure App Client Secret | Секрет клиента, созданный для приложения в клиенте Идентификатора записи | Генерируя учетные данные для Azure Maps | Секрет CSRF | 32-символьная строка для предотвращения атак CSRF | См. предыдущий шаг. |

8. На боковой панели "Параметры" нажмите кнопку "Сохранить параметры".

   Примечание.

   Сохранение параметров в Консоль управления перезапускает системные службы, что может привести к простоям, видимым пользователем.

9. Подождите завершения запуска конфигурации.

Отключение интерактивных карт

1. В учетной записи администратора GitHub Enterprise Server, в правом верхнем углу любой страницы щелкните .

2. Если вы еще не на странице "Администратор сайта", в левом верхнем углу щелкните Администратор сайта.

3. На боковой панели " "Администратор сайта" щелкните Консоль управления.

4. На боковой панели "Параметры" щелкните "Конфиденциальность " и снимите флажок "Закрытый режим".

5. Чтобы отключить интерактивные карты, отключите флажок "Включить отрисовку GeoJSON".

6. На боковой панели "Параметры" нажмите кнопку "Сохранить параметры".

   Примечание.

   Сохранение параметров в Консоль управления перезапускает системные службы, что может привести к простоям, видимым пользователем.

7. Подождите завершения запуска конфигурации.