# Managed SSO への移行

> [!WARNING]
> この機能はEnterprise Plusプランの一部です。

このガイドは、既存の組織を標準組織から[Managed SSO](./enterprise-advanced-sso)組織へ移行する組織管理者向けです。

始める前に理解しておく最も重要な点: **メンバーの既存の個人用 Hugging Face アカウントは、管理アカウントに変換されません**。各メンバーには、Identity Provider (IdP) によってプロビジョニングされる、まったく新しい管理アカウントが割り当てられます。メンバーがプロビジョニングされる前に、そのメンバーは個人用アカウント上で業務用のメールアドレスを解放する必要があります。

本ガイドでは、`my-org`を組織名の例として使用します。

## 前提条件

[SSO](./security-sso-basic)は、すでに組織内で設定、テスト、有効化されている必要があります。移行では、既存のOIDCまたはSAMLアプリケーションが再利用されます。

## 移行手順

1. **メンバーの準備をします。** メンバーと[移行前チェックリスト](#before-you-migrate)を確認します。
2. **Hugging Face に連絡します。** Hugging Face チームに連絡し、切り替えを確認してください。組織の変換を行い、`my-org:owner` の break-glass アカウントの認証情報を送信します。
3. **メンバーに業務用メールアドレスを解放してもらいます。** [業務用メールアドレスの解放](#freeing-up-work-email-addresses)を参照してください。プロビジョニングを有効化する前に実行してください。SSO アプリケーションに割り当てられているユーザーは、SCIM がオンになるとすぐにプロビジョニングされます。Hugging Face チームから、まだ個人アカウントに業務用メールアドレスが設定されているメンバーの一覧を送ってもらうことで、それらのメンバーにフォローアップを行うことができます。
4. **IdPにSCIMを設定します。** 組織の**SSO → SCIM**設定からSCIMテナントURLとトークンを取得し、既存のOIDCまたはSAMLアプリケーションでそれらを使用してから、お使いのIdP向けのガイドに従ってください。
   - **Okta**: [Oktaガイド](./security-sso-okta-scim)に従ってください。[ステップ3](./security-sso-okta-scim#step-3-check-your-saml-settings)も含まれます。Name IDはOktaのユーザーIDである必要があります。
   - **Microsoft Entra ID**: [Entra ID ガイド](./security-sso-entra-id-scim)に従ってください。`userName` は [ユーザー名ルール](./security-sso-entra-id-scim#step-4-configure-attribute-mappings) に従う必要があるため、`jdoe@example.com` のようなメール形式の値は拒否されます。
   - **その他の IdP**: [ユーザープロビジョニング (SCIM)](./enterprise-scim)を参照してください。ユーザー名のルールは同じです。
5. **IdPでユーザーとグループを割り当てます。** ユーザーのプロビジョニングに伴って、マネージドアカウントが作成されます。
6. 各メンバーの管理アカウントがプロビジョニングされたら、**組織から残った個人アカウントを削除**してください。この手順はセキュリティ上必須です。[個人アカウントは削除されるまでアクセスを維持](#existing-personal-accounts-in-the-organization)するためです。これらを削除すると、組織のリソースグループからも削除されます。
7. **（オプション）グループを Resource Groups およびロールにマッピングします。** [SCIM グループを Resource Groups にリンク](./enterprise-scim#linking-a-scim-group-to-a-resource-group)し、[Role Mapping](./security-sso-user-management#role-mapping)を設定して、IdP から組織ロールを割り当てます。Resource Group は、メンバーが誰も存在せず、自動参加がオフになっている場合のみ、SCIM グループにリンクできます。自動参加がオンになっている場合、新規プロビジョニングされた管理アカウントもグループに追加されるため、ユーザーのプロビジョニングの前に自動参加をオフにするか、リンクする前に残っているメンバーを削除してください。

## 変更点

### 変換が実行する処理

- **変換は Hugging Face チームによって行われます。**セルフサービスでの切り替えはできません。リクエストを受け付けると、Hugging Face チームがあなたの組織をマネージドモードに切り替えます。
- **組織のコンテンツと設定はそのまま維持されます。** リポジトリ、設定、[Resource Groups](./enterprise-resource-groups) および既存の SSO 設定（OIDC または SAML アプリ）は保持されます。同じ IdP アプリケーションを継続して使用できますが、SCIM 用に一部の設定を調整する必要がある場合があります（[ステップ 4](#migration-steps) を参照）。
- **破格の管理者アカウントが作成されます**。名前は`my-org:owner`です。このアカウントはユーザー名とパスワードでログインします（SSO経由ではありません）。また、組織の管理者でもあります。Hugging Faceチームから認証情報が共有されます。安全に保管してください。このアカウントは、IdPが利用不可または誤設定されている場合でも組織にアクセスできるようにします。
- **SSOをオプションにすることはできなくなりました。** 完全に無効にすることは引き続き可能です。

> [!WARNING]
> 管理対象組織でSSOを無効にすると、管理対象アカウントにはパスワードがないため、すべての管理対象ユーザーがロックアウトされます。

### マネージドアカウントは新しいアカウントです

- 既存の個人用 Hugging Face アカウントは、管理アカウントに変換、統合、またはリンクされ**ません**。各メンバーには、IdP でユーザーが割り当てられた際に、IdP が [SCIM](./enterprise-scim) を通じて新しいアカウントを作成します。
- 管理対象のユーザー名には、組織名がプレフィックスとして付与されます: `<org-name>:<username>`。例えば `my-org:jdoe` のようにです。
- Managed usersは、IdP経由でのみログインします。Hugging Faceのパスワードは持っておらず、「パスワードを忘れた場合」の機能も使用できません。
- マネージドアカウントは、[マネージドアカウントに関する制限](./enterprise-advanced-sso#restrictions-on-managed-accounts)の対象となります。

### メンバーシップ

- 通常メンバーは、招待によって追加できなくなりました。内部メンバーは、SCIMを通じてプロビジョニングする必要があります。
- 招待は、[外部のコラボレーター](./security-sso-user-management#external-collaborators)のみが利用可能です。

### 組織内の既存の個人アカウント

変換後も組織のメンバーであり続ける個人アカウントは、そのロールを維持します。これらのアクセス トークン、すでに承認済みの OAuth アプリ、および git over SSH は引き続き機能します。これは、これらが SSO に対してチェックされないためです。これらでは、組織への新しい SSO ログインを開始できなくなります。

- ユーザーが個人アカウントでサインインしている場合、またはそのアカウントがすでにあなたの IdP にリンクされている場合、以下が表示されます: `You cannot login with SSO with this account because it's not managed by this organization. Contact your organization administrators.`
- それ以外の場合、`User not found`が表示されます。

## 移行の前に

変換をリクエストする前に、メンバーとこのチェックリストを確認してください:

- **個人リポジトリ**: 個人ネームスペース内にあり、新しいマネージドアカウントでも引き続きアクセスしたいリポジトリを持つメンバーは、切り替え前にそれらを組織へ[転送](./repositories-settings#renaming-or-transferring-a-repo)する必要があります。マネージドアカウントは、個人ネームスペース内のコンテンツを所有できません。メンバーは、個人（非マネージド）アカウントを通じて、個人ネームスペース配下のリポジトリに引き続きアクセスできます。
- **トークンと自動化**: 個人アカウントのトークンは、そのアカウントが組織から削除されるまで、組織へのアクセスを維持します。スクリプト、CIジョブ、パイプラインを[サービスアカウント](./enterprise-service-accounts)、または切り替え後に作成された管理アカウントのトークンに移行し、その後古いアカウントを削除してください。
- **他の組織**: 管理アカウントは他の組織に参加できません。他の組織での作業を継続する必要があるメンバーは、別の個人アカウントを保持してください（[オプション 2](#option-2-keep-the-personal-account)を参照）。
- **業務用メールアドレス**: プロビジョニングの前に、各メンバーは業務用メールアドレスを解放する必要があります。[業務用メールアドレスの解放](#freeing-up-work-email-addresses)を参照してください。

## フリーの業務用メールアドレス

メールアドレスは1つのHugging Faceアカウントにのみ紐付けられます。これは、プライマリおよびセカンダリを含む、アカウントの**すべての**メールアドレスに適用されます。一致判定は、大文字と小文字を区別しません。

SCIMが、すでに個人アカウントで使用されている業務用メールアドレスで管理アカウントの作成を試みると、プロビジョニングは`409`エラーで失敗します:

```
The email address (jdoe@example.com) is already associated with another Hugging Face account. Please delete the account.
```

IdPでは、そのユーザーについてプロビジョニングエラーとして表示されます。

これを回避するために、各メンバーはプロビジョニングの**前に**、以下の2つのオプションのいずれかを使用して、業務用メールアドレスを解放する必要があります。

> [!TIP]
> **どちらのオプションを選択すべきですか？** - Hugging Face アカウントをこの組織での業務にのみ使用している場合は、**オプション 1**（個人アカウントの削除）を選択してください。 - オープンソースの作業、個人プロジェクト、または他の組織でも使用している場合は、**オプション 2**（個人アカウントを保持し、業務用メールアドレスを削除）を選択してください。

### オプション1: 個人アカウントを削除する

[アカウント設定](https://huggingface.co/settings/account)から個人アカウントを削除してください。これにより、個人ネームスペース内のすべてのリポジトリが恒久的に削除され、すべての組織から退会します。

> [!WARNING]
> アカウントの削除は恒久的です。保持したいリポジトリは、先に組織へ移行してください。

別の組織で唯一の管理者である場合、削除はブロックされます。まず、その組織に別の管理者を追加するか、その組織を削除してください。移行先の組織は問題ありません。`my-org:owner` も管理者であるためです。

### オプション2: 個人アカウントを維持する

1. [アカウント設定](https://huggingface.co/settings/account)で、個人用メールアドレスを追加して認証してください。
2. 個人用メールアドレスをメインのメールアドレスに設定してください。
3. **業務用のメールアドレスを完全に削除してください。** 副次的なメールアドレスに設定するだけでは不十分です。

管理アカウントのプロビジョニングが完了するまで、個人アカウントを組織内に保持してください。その後、管理者が削除します。

> [!NOTE]
> 組織で Managed SSO が有効化されており、[検証済みのメールドメイン](./organizations-managing#organization-domain-name)がある場合、そのドメインのメールアドレスでログインすると、組織の SSO ページにリダイレクトされます。個人アカウントにログインするには、ユーザー名を使用してください。

業務用メールアドレスが空いている状態になると、管理者は IdP でそのユーザーのプロビジョニングを再試行するか、次の同期で処理されるのを待つことができます。

## 移行後

ユーザーのライフサイクルは、IdPから管理されます:

- IdPでユーザーを**無効化**すると、そのユーザーは組織から削除されます。後で同じユーザーが再有効化された場合、既存の管理アカウントが再利用されます。
- SCIM経由でユーザーを**削除**すると、管理アカウントが完全に削除されます。[Deprovisioning](./enterprise-scim#deprovisioning)を参照してください。

