Skip to main content

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

GitHub Enterprise CloudのTeamをサポートされているアイデンティティプロバイダ(IdP) グループと同期して、自動的にTeamメンバーの追加や削除を行えます。

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

Note: If your enterprise uses Enterprise Managed Users, you cannot use team synchronization and must instead configure SCIM to manage membership with your identity provider. For more information, see "Configuring SCIM provisioning for Enterprise Managed Users."

Team の同期について

If team sync is enabled for your organization or enterprise account, you can synchronize a GitHub team with an IdP group. When you synchronize a GitHub team with an IdP group, membership changes to the IdP group are reflected on GitHub Enterprise Cloud automatically, reducing the need for manual updates and custom scripts. For more information, see "Managing team synchronization for your organization" and "Managing team synchronization for organizations in your enterprise".

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

Team同期は5000以上のメンバーを持つIdPグループをサポートしません。

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

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

IdP を通じた Team メンバーシップ変更はすべて、Team 同期ボットによる変更として GitHub Enterprise Cloud の 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 Enterprise Cloud で変更を行う必要があります。 詳細は「Team について」および「Organization リポジトリへの Team のアクセスを管理する」を参照してください。

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

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

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

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

これらの条件を満たしていない既存の Team またはグループメンバーは、GitHub Enterprise Cloud の Team から自動的に削除され、リポジトリにアクセスできなくなります。 ユーザのリンクされた ID を取り消すと、IdP グループにマップされている Team からユーザが削除されます。 詳しい情報については「OrganizationへのメンバーのSAMLアクセスの表示と管理」及び「EnterpriseへのユーザのSAMLアクセスの表示と管理」を参照してください。

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

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

必要な環境

GitHub Enterprise Cloud チームに接続する前に、Organization またはEnterprise のオーナーは、Organization または Enterprise アカウントの Team 同期を有効にする必要があります。 詳しい情報については、「Organization の Team 同期を管理する」と「Enterprise アカウントで Team 同期を管理する」を参照してください。

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

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

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

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

  1. In the top right corner of GitHub.com, click your profile photo, then click Your organizations. プロフィールメニューのあなたのOrganization

  2. Click the name of your organization. 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. In the top right corner of GitHub.com, click your profile photo, then click Your organizations. プロフィールメニューのあなたのOrganization

  2. Click the name of your organization. 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] をクリックします。