ドキュメントには頻繁に更新が加えられ、その都度公開されています。本ページの翻訳はまだ未完成な部分があることをご了承ください。最新の情報については、英語のドキュメンテーションをご参照ください。本ページの翻訳に問題がある場合はこちらまでご連絡ください。

Team をアイデンティティプロバイダグループと同期する

GitHub Team をアイデンティティプロバイダ (IdP) グループと同期して、Team メンバーを自動的に追加あるいは削除することができます。

Organization owners and team maintainers can synchronize a GitHub team with an IdP group.

Teamの同期は、GitHub Enterprise Cloudを使用するOrganization及びEnterpriseアカウントで利用できます。 詳しい情報については「GitHubの製品」を参照してください。

ここには以下の内容があります:

メモ: Oktaを利用するTeam の同期は現在ベータであり、変更されることがあります。 ベータへの登録については、GitHubセールス顧客担当にお問い合わせください。

Team の同期について

GitHub TeamをIdPグループと同期すると、IdPグループへの変更はGitHubに自動的に反映され、手動での更新やカスタムスクリプトの必要を減らせます。 IdPをTeam同期と共に使い、新しいメンバーのオンボーディング、Organization内での移動に応じた新しい権限の付与、Organizationからのメンバーアクセスの削除といった管理タスクを扱うことができます。

最大 5 つの IdP グループを GitHub チームに接続できます。 IdP グループを複数の GitHub Team に割り当てることができます。

Team 同期は、5000 以上のメンバーがいる IdP グループをサポートしていません。

いったん GitHub Team が IdP グループに接続されたら、IdP 管理者はアイデンティティプロバイダを通して Team メンバーシップを変更する必要があります。 GitHub または API を使用して Team のメンバーシップを管理することはできません。

IdP を通じた Team メンバーシップ変更はすべて、Team 同期ボットによる変更として GitHub の Audit log に記載されます。 IdP は、Team メンバーシップのデータを 1 時間に 1 回 GitHub に送信します。 Team を IdP グループに接続すると、Team メンバーが削除される場合があります。 詳細は「同期される Team のメンバーに関する要件」を参照してください。

親チームは IdP グループと同期できません。 IdP グループに接続したい Team が親チームの場合、新しい Team を作るか、Team と親チームのネスト関係を削除することをお勧めします。 詳細は、「Team について」、「Team の作成」、「Organization 階層内で Team を移動する」を参照してください。

IdP グループに接続された Team を含めて GitHub Team のリポジトリに対するアクセスを管理するには、GitHub で変更を行う必要があります。 詳細は「Team について」および「Organization リポジトリへの Team のアクセスを管理する」を参照してください。

API を使用して Team の同期を管理することもできます。 詳しい情報については、「Team 同期」を参照してください。

同期される Team のメンバーに関する要件

チームを IdP グループに接続した後、Team 同期により、次の場合にのみ IdP グループの各メンバーが GitHub 上の対応するチームに追加されます。

  • そのユーザが GitHub の Organization のメンバーの場合。
  • そのユーザがすでに GitHub のユーザアカウントでログインしており、少なくとも 1 回は SAML シングルサインオンを介して Organization または Enterprise アカウントに認証されている場合。
  • そのユーザの SSO ID が IdP グループのメンバーである場合。

これらの条件を満たしていない既存の Team またはグループメンバーは、GitHub の Team から自動的に削除され、リポジトリにアクセスできなくなります。 ユーザのリンクされた ID を取り消すと、IdP グループにマップされている Team からユーザが削除されます。 For more information, see "Viewing and managing a member's SAML access to your organization" and "Viewing and managing a user's SAML access to your enterprise."

削除された Team メンバーは、SSO を使って Organization または Enterprise アカウントに認証され、接続先の IdP グループに移動すれば、再び Team に自動的に追加できます。

意図しない Team メンバーの削除を避けるために、Organization または Enterprise アカウントで SAML SSO を施行し、メンバーシップデータを同期するため新しい Team を作成し、IdP グループのメンバーシップを確認してから既存の Team を同期することをおすすめします。 詳しい情報については、「Organization で SAML シングルサインオンを施行する」と「Enterprise アカウントで Organization 用に SAML シングルサインオンを有効にする」を参照してください。

Organization が Enterprise アカウントによって所有されている場合、その Enterprise アカウントに Team の同期を有効化すると、Organization レベルの Team の同期はオーバーライドされます。 詳しい情報については、「Enterprise アカウントで Organization の Team 同期を管理する」参照してください。

必要な環境

Before you can connect a GitHub team with an identity provider group, an organization or enterprise owner must enable team synchronization for your organization or enterprise account. For more information, see "Managing team synchronization for your organization" and "Managing team synchronization for organizations in your enterprise account."

Team メンバーを誤って削除しないように、お使いの IdP の管理ポータルにアクセスし、現在の各 Team メンバーが、接続しようとしている IdP グループにも属していることを確認してください。 アイデンティティプロバイダにこうしたアクセスができない場合は、IdP 管理者にお問い合わせください。

SAML SSO を使って認証する必要があります。 詳しい情報については「SAMLシングルサインオンで認証する」を参照してください。

IdP グループをTeam に接続する

IdP グループを GitHub Team に接続すると、グループ内のすべてのユーザが自動的に Team に追加されます。

  1. GitHubの右上で、プロフィール画像をクリックし、続いてYour profile(あなたのプロフィール)をクリックしてください。 プロフィール画像

  2. プロフィールページの左側で、"Organizations"の下であなたのOrganizationのアイコンをクリックしてください。 organizationのアイコン

  3. Organization名の下で、 Teamsをクリックしてください。 Teamsタブ

  4. Teamsタブで、Teamの名前をクリックしてください。 Organization の Team のリスト

  5. Team ページの上部で、 Settings(設定)をクリックしてください。 Team設定タブ

  6. [Identity Provider Groups] で、ドロップダウンメニューを使用して最大 5 つまでアイデンティティプロバイダグループを選択します。 Drop-down menu to choose identity provider groups

  7. [Save changes] をクリックします。

IdP グループをTeam から切断する

GitHub Team から IdP グループを切断すると、その IdP グループを介して GitHub Team に割り当てられている Team メンバーは Team から削除されます。

  1. GitHubの右上で、プロフィール画像をクリックし、続いてYour profile(あなたのプロフィール)をクリックしてください。 プロフィール画像

  2. プロフィールページの左側で、"Organizations"の下であなたのOrganizationのアイコンをクリックしてください。 organizationのアイコン

  3. Organization名の下で、 Teamsをクリックしてください。 Teamsタブ

  4. Teamsタブで、Teamの名前をクリックしてください。 Organization の Team のリスト

  5. Team ページの上部で、 Settings(設定)をクリックしてください。 Team設定タブ

  6. [Identity Provider Groups] で、切断したい IdP グループの右にある をクリックします。 Unselect a connected IdP group from the GitHub team

  7. [Save changes] をクリックします。

Did this doc help you?

Privacy policy

Help us make these docs great!

All GitHub docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

OR, learn how to contribute.