Устранение неполадок с использованием лицензий для GitHub Enterprise

Сведения о непредвиденном использовании лицензий

Если для вашего предприятия используется непредвиденное число лицензий, с помощью отчета об используемых лицензиях вы можете выполнить аудит использования лицензий во всех развертываниях и подписках предприятия. Дополнительные сведения см. в разделах Просмотр использования лицензий для GitHub Enterprise и Просмотр подписки и сведений об использовании для корпоративной учетной записи.

При обнаружении ошибок вы можете выполнить действия по устранению неполадок.

По соображениям конфиденциальности владельцы предприятия не могут получить прямой доступ к сведениям об учетных записях пользователей, если не используется Enterprise Managed Users.

Сведения о вычислении количества используемых лицензий

Если пользователь соответствует одному или нескольким из следующих условий, GitHub выставляет счета за пользователя.

Пользователь использует развертывания GitHub Enterprise Server.
Пользователь является членом одной из ваших организаций в GitHub Enterprise Cloud.
Пользователь имеет доступ на запись к одному из частных репозиториев вашей организации.
Пользователь является Подписчик Visual Studio.

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

Чтобы каждый пользователь занимал одно место вне зависимости от количества используемых им развертываний, необходимо синхронизировать использование лицензий между GitHub Enterprise Server и GitHub Enterprise Cloud. Дополнительные сведения см. в разделе Синхронизация потребления лицензий между GitHub Enterprise Server и GitHub Enterprise Cloud.

После синхронизации использования лицензий GitHub сопоставляет учетные записи пользователей в GitHub Enterprise Server с учетными записями пользователей в GitHub Enterprise Cloud по адресу электронной почты.

Сначала проверяется основной адрес электронной почты каждого пользователя в GitHub Enterprise Server. Затем выполняется его сопоставление с адресом электронной почты учетной записи пользователя в GitHub Enterprise Cloud. Если в предприятии используется единый вход SAML, сначала выполняется поиск адресов электронной почты в следующих атрибутах SAML:

http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name
http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress
username
NameID
emails

Если в этих атрибутах не обнаружены адреса электронной почты, совпадающие с основным адресом в GitHub Enterprise Server, или в предприятии не используется единый вход SAML, выполняется проверка каждого проверенного адреса электронной почты пользователя в GitHub Enterprise Cloud. Дополнительные сведения о проверке адресов электронной почты в GitHub.com см. в разделе Подтверждение адреса электронной почтыдокументации по GitHub Enterprise Cloud.

Поля в файлах с показателями использования лицензий

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

Отчет об использовании лицензии (CSV-файл) на веб-сайте GitHub.com

Отчет об использовании лицензий для вашего предприятия — это CSV-файл, который содержит следующие сведения о членах вашей организации. Некоторые поля относятся к развертыванию GitHub Enterprise Cloud (GHEC), подключенным средам GitHub Enterprise Server (GHES) или вашим подпискам Visual Studio (VSS) в GitHub Enterprise.

Поле	Описание
github_com_login	Имя учетной записи пользователя GHEC
github_com_name	Отображаемое имя учетной записи пользователя GHEC
github_com_profile	URL-адрес страницы профиля пользователя в GHEC
github_com_user	Указывает, имеется ли у пользователя учетная запись в GHEC
github_com_member_roles	Имя организации и роль пользователя в ней (`Owner` или `Member`) через двоеточие для каждой организации, членом которой пользователь является в GHEC Организации разделяются запятыми
github_com_enterprise_role	Может принимать значение `Owner`, `Member` или `Outside collaborator`
github_com_verified_domain_emails	Все адреса электронной почты, связанные с учетной записью пользователя GHEC и совпадающие с проверенными доменами вашего предприятия
github_com_saml_name_id	Имя пользователя SAML
github_com_orgs_with_pending_invites	Все приглашения, ожидающие присоединения к организациям в предприятии, для учетной записи пользователя GHEC
license_type	Может принимать значение `Visual Studio subscription` или `Enterprise`
enterprise_server_user	Указывает, имеется ли у пользователя как минимум одна учетная запись в GHES
enterprise_server_primary_emails	Основной адрес электронной почты, связанный с каждой учетной записью пользователя в GHES
enterprise_server_user_ids	Идентификатор пользователя учетной записи для каждой учетной записи пользователя в GHES
total_user_accounts	Общее количество учетных записей пользователя в GHEC и GHES
visual_studio_subscription_user	Является ли пользователь Подписчик Visual Studio
visual_studio_subscription_email	Адрес электронной почты, связанный с VSS пользователя
visual_studio_license_status	Указывает, сопоставлена ли лицензия Visual Studio с пользователем GitHub

Подписчик Visual Studio, которые еще не являются участниками хотя бы одной организации в вашем предприятии, будут включены в отчет с состоянием ожидающего приглашения, а значения поля "Имя" или "Ссылка на профиль" отсутствуют.

Экспортированные сведения об использовании лицензий GitHub Enterprise Server (файл JSON)

Сведения об использовании лицензии GitHub Enterprise Server содержатся в JSON-файле, который обычно используется при выполняемой вручную синхронизации пользовательских лицензий между развертываниями GitHub Enterprise Server и GitHub Enterprise Cloud. Файл содержит следующие сведения, относящиеся к вашей среде GitHub Enterprise Server.

Поле	Описание
Компоненты	Функции GitHub Connect, включенные в вашем экземпляре GitHub Enterprise Server, а также дата и время включения.
Имя узла	Имя узла вашего экземпляра GitHub Enterprise Server.
Только HTTP	Включен и настроен ли протокол TLS в вашем экземпляре GitHub Enterprise Server. Это может быть `True` или `False`.
Лицензия	Хэш вашей лицензии GitHub Enterprise Server.
Открытый ключ	Часть открытого ключа вашей лицензии GitHub Enterprise Server.
Идентификатор сервера	UUID, созданный для вашего экземпляра GitHub Enterprise Server.
Версия	Версия вашего экземпляра GitHub Enterprise Server.

Устранение неполадок с используемыми лицензиями

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

Чтобы определить пользователей, которые занимают несколько мест, если в предприятии используются проверенные домены для GitHub Enterprise Cloud, просмотрите список членов предприятия, у которых нет адреса электронной почты из проверенного домена, связанного с их учетной записью на GitHub.com. Часто это пользователи, которые ошибочно используют более одного рабочего места по лицензии. Дополнительные сведения см. в разделе Просмотр пользователей в организации.

Примечание. Чтобы упростить устранение неполадок, рекомендуется использовать проверенные домены с корпоративной учетной записью на GitHub.com. Дополнительные сведения см. в разделе Проверка или утверждение домена для вашего предприятия.
После определения пользователей, которые занимают несколько мест, убедитесь, что с учетными записями связан один адрес электронной почты. Дополнительные сведения о том, какие адреса электронной почты должны совпадать, см. в разделе "Сведения о вычислении используемых лицензий".
Если адрес электронной почты был недавно обновлен или проверен для исправления несоответствия, просмотрите метку времени последнего задания синхронизации лицензий. Если задание не выполнялось после исправления, активируйте новое задание вручную. Дополнительные сведения см. в разделе Синхронизация потребления лицензий между GitHub Enterprise Server и GitHub Enterprise Cloud.

Если у вас остались вопросы об используемых лицензиях после просмотра приведенных выше сведений об устранении неполадок, вы можете связаться со службой Поддержка GitHub с помощью Портал поддержки GitHub.