GitHub Enterprise のライセンス使用状況のトラブルシューティング

想定外のライセンス使用状況について

エンタープライズの使用済みライセンス数が想定外� った� �合、使用済みライセンスレポートを確認し、エンタープライズのデプロイとサブスクリプション全体のライセンス使用状況を監査することができます。詳しくは、「GitHub Enterprise のライセンス使用状況の表示」と「エンタープライズアカウントのサブスクリプションと使用状況の表示」を参照してく� さい。

エラーが見つかった� �合は、トラブルシューティング手� �を試すことができます。

プライバシー上の理由から、Enterprise Managed Users を使用しない限り、Enterprise 所有者はユーザーアカウントの詳細に直接アクセスできません。

使用済みライセンスの計算について

ユーザーが次の条件の 1 つ以上を満たしている� �合、GitHub はユーザーに対して課金を行います。

ユーザーが GitHub Enterprise Server のデプロイを利用する
ユーザーが GitHub Enterprise Cloud の Organization のいずれかのメンバーである
ユーザーが Organization のいずれかのプライベートリポジトリへの書き込みアクセス権を持っている
ユーザーが Visual Studio subscriber である

これらのロールの招待は、招待が承諾されるか期限切れになるまでライセンスを使用します。ライセンスを使用している Enterprise 内の個人について詳しくは「ユーザーごとの価� �付けについて」を参照してく� さい。

使用するデプロイの数に関係なく、各ユーザーが 1 つのシートを使用するには、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 のユーザーアカウントのメールアドレスを照合します。 Enterprise で SAML SSO を使用している� �合は、まず次の 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 のプライマリメールアドレスと一致しない� �合、または Enterprise が SAML SSO を使用していない� �合は、GitHub Enterprise Cloud のユーザーの検証済みメールアドレスを確認します。 GitHub.com 上のメールアドレスの確認の詳細については、「メールアドレスを検証する」(GitHub Enterprise Cloud ドキュメント)を参照してく� さい。

使用済みライセンスファイルのフィールド

GitHub.com ライセンス使用状況レポートと GitHub Enterprise Server のエクスポートされたライセンス使用状況ファイルには、エンタープライズのライセンス使用状況のトラブルシューティングに役立つさまざまなフィールドが含まれています。

GitHub.com ライセンス使用状況レポート (CSV ファイル)

エンタープライズのライセンス使用状況レポートは、エンタープライズのメンバーに関する以下の情� �を含む CSV ファイルです。一部のフィールドは、GitHub Enterprise Cloud (GHEC) のデプロイ、GitHub Enterprise Server (GHES) の接続環境、または GitHub Enterprise との Visual Studio サブスクリプション (VSS) に固有のものです。

フィールド	説明
github_com_login	ユーザーの GHEC アカウントのユーザー名
github_com_name	ユーザーの GHEC アカウントの表示名
github_com_profile	GHEC のユーザーのプロファイルページの URL
github_com_user	ユーザーが GHEC のアカウントを持っているかどうか
github_com_member_roles	GHEC でユーザーが所属する Organization ごとの、コロンで区切られた Organization 名とその Organization 内の個人のロール (`Owner` または `Member`) コンマで区切られた Organization
github_com_enterprise_role	`Owner`、`Member`、`Outside collaborator` のいずれかです
github_com_verified_domain_emails	Enterprise の検証済みドメインに一致するユーザーの GHEC アカウントに関連付けられているすべてのメールアドレス
github_com_saml_name_id	SAML ユーザー名
github_com_orgs_with_pending_invites	ユーザーの GHEC アカウントが Enterprise 内の Organization に参� するための保留中のすべての招待
license_type	`Visual Studio subscription` か `Enterprise` のいずれかです
enterprise_server_user	ユーザーが GHES に少なくとも 1 つのアカウントを持っているかどうか
enterprise_server_primary_emails	各ユーザーの GHES アカウントに関連付けられているプライマリメールアドレス
enterprise_server_user_ids	ユーザーの GHES アカウントごとの、アカウントのユーザー ID
total_user_accounts	個人が GHEC と GHES の両方で持っているアカウントの合計数
visual_studio_subscription_user	ユーザーが Visual Studio subscriber であるかどうか
visual_studio_subscription_email	ユーザーの VSS に関連付けられているメールアドレス
visual_studio_license_status	Visual Studio ライセンスが GitHub ユーザーに一致しているかどうか

エンタープライズ内の 1 つ以上の組織のメンバーになっていない Visual Studio subscriber は、保留中の招待状態でレポートに含まれ、[名前] または [プロファイルリンク] フィールドの値がありません。

GitHub Enterprise Server のエクスポートされたライセンス使用状況 (JSON ファイル)

GitHub Enterprise Server のライセンス使用状況は JSON ファイルであり、通常、GitHub Enterprise Server と GitHub Enterprise Cloud のデプロイ間でユーザーライセンスの手動同期を実行するときに使われます。このファイルには、GitHub Enterprise Server 環境に固有の次の情� �が含まれています。

フィールド	説明
機能	GitHub Enterprise Server インスタンスで有効な GitHub Connect 機能と、有効になった日時。
ホスト名	GitHub Enterprise Server インスタンスのホスト名。
HTTP のみ	GitHub Enterprise Server インスタンス上でトランスポート層セキュリティ (TLS) が有効であり、構成されているかどうか。 `True` または `False` のいずれかにすることができます。
ライセンス	GitHub Enterprise Server ライセンスのハッシュ。
公開キー	GitHub Enterprise Server ライセンスの公開キーの部分。
サーバー ID	GitHub Enterprise Server インスタンス用に生成された UUID。
Version	GitHub Enterprise Server インスタンスのバージョン。

使用済みライセンスのトラブルシューティング

各ユーザーが異なるデプロイとサブスクリプションに対して 1 つのシートのみを使用していることを確認するには、次のトラブルシューティングの手� �を試してみてく� さい。

複数のシートを使用しているユーザーを特定するために、Enterprise で GitHub Enterprise Cloud の検証済みドメインが使われている� �合は、GitHub.com のアカウントに関連付けられている検証済みドメインのメールアドレスを持たない Enterprise メンバーのリストを確認します。多くの� �合、これらは誤って複数のライセンスシートを使っているユーザーです。詳細については、「検証済みドメインのメールアドレスを持たないメンバーの表示」を参照してく� さい。

注: トラブルシューティングを簡単に行えるようにするため GitHub.com の Enterprise アカウントで、検証済みドメインを使うことをお勧めします。詳細については、「エンタープライズのドメインの確認または承認」を参照してく� さい。
複数のシートを使用しているユーザーを特定したら、同じメールアドレスがすべてのユーザーのアカウントに関連付けられていることを確認します。一致する必要があるメールアドレスについて詳しくは、「使用されるライセンスの計算について」を参照してく� さい。
メールアドレスが最近更新されたか、不一致を修正するために検証された� �合は、最後のライセンス同期ジョブのタイ� スタンプを表示します。修正が行われた後にジョブが実行されていない� �合は、手動で新しいジョブをトリガーします。詳細については、「GitHub Enterprise Server と GitHub Enterprise Cloud 間のライセンス使用状況の同期」を参照してく� さい。

前述のようにトラブルシューティング情� �を確認した後も、使用済みライセンスについて不明な点がある� �合は、GitHub Support ポータルを使って GitHub Support に問い合わせることができます。