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

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

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

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

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

• Чтобы настроить интерактивные карты для своего экземпляра, необходимо иметь административный доступ к клиенту в идентификаторе Microsoft Entra. Дополнительные сведения см. в кратком руководстве по созданию нового клиента в Microsoft Entra ID в Microsoft Learn.

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

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

Создание учетных данных для Azure Maps

Чтобы создать учетные данные для Azure Maps, необходимо создать приложение для клиента в идентификаторе Entra, предоставить приложению доступ к учетной записи 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.

6. Настройка RBAC для Azure Maps. Дополнительные сведения см. в статье "Проверка подлинности с помощью Azure Maps" и назначение ролей Azure с помощью портал Azure в Microsoft Learn.

   • В клиенте Идентификатора записи из управления доступом (IAM) необходимо назначить роль "Читатель данных Azure Maps" пользователю, группе или субъекту-службе, выбрать приложение, созданное ранее в этих инструкциях, и завершить форму.

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

После создания приложения в клиенте идентификатора Записи и создания секрета для использования 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.13, ниже "Токен API Azure Maps", введите или вставьте маркер.

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

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

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

       значение	Описание	Дополнительные сведения
       Идентификатор клиента Azure Map	Идентификатор клиента для учетной записи Azure Maps	Управление проверкой подлинности в Azure Maps в Microsoft Learn
       идентификатор клиента приложение Azure	Идентификатор приложения (клиента) для приложения, созданного в клиенте идентификатора записи	Создание приложения и субъекта-службы Microsoft Entra, доступ к ресурсам в Microsoft Learn
       Azure Tenant ID	Идентификатор клиента в идентификаторе Entra	Необходимые условия
       секрет клиента приложение Azure	Секрет клиента, созданный для приложения в клиенте Идентификатора записи	Создание учетных данных для Azure Maps
       Секрет CSRF	32-символьная строка для предотвращения атак CSRF	См. предыдущий шаг.

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

   Note

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

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

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

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

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

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

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

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

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

   Note

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

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