# OktaでSAML SSOを設定する方法

このガイドでは、SSOプロバイダーとしてOktaを使用し、アイデンティティプロトコルとしてSecurity Assertion Markup Language (SAML)プロトコルを優先的に使用します。

現在、SP開始型認証とIdP開始型認証に対応しています。ユーザープロビジョニングについては、[SCIM](./enterprise-scim)を参照してください。

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

## ステップ 1: Identity Provider に新しいアプリケーションを作成する

ブラウザで新しいタブ/ウィンドウを開き、Oktaアカウントにサインインしてください。

Admin/Applications に移動し、Create App Integration ボタンをクリックします。

次に、"SAML 2.0" アプリケーションを選択し、"Create" をクリックします。

## ステップ2: Oktaでアプリケーションを設定する

ブラウザで新しいタブ/ウィンドウを開き、組織の設定のSSOセクションに移動します。SAMLプロトコルを選択します。

Hugging Face の組織設定から「Assertion Consumer Service URL」をコピーし、Okta の「Single sign-on URL」フィールドに貼り付けてください。URL は次のような形式です: `https://huggingface.co/organizations/[organizationIdentifier]/saml/consume`。

Oktaでは、以下の設定を行います:

- Audience URI (SP Entity Id)を、Hugging Face上の「SP Entity ID」の値と一致するように設定してください。
- Set Name ID の形式を`Unspecified`に設定します。
- Application の username を `Custom` に設定し、式を `user.getInternalProperty("id")` とします。
- Under "Attribute Statements", add `http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress` with the value `user.email`.
- 「Show Advanced Settings」の下で、ResponseとAssertion SignatureがSignedに設定されていることを確認してください。

新しいアプリケーションを保存してください。

## ステップ3: Hugging Faceで設定を確定する

Oktaアプリケーションの「Sign On/Settings/More details」の下で、以下のフィールドを確認してください。

- サインオンURL
- 公開証明書
- SP Entity ID Hugging FaceでのSSO設定を完了させるためにこれらが必要です。

組織の設定のSSOセクションで、Oktaからこれらの値をコピー＆ペーストしてください:

- サインオンURL
- SPエンティティID
- 公開証明書

公開鍵証明書は、次の形式である必要があります:

```
-----BEGIN CERTIFICATE-----
{certificate}
-----END CERTIFICATE-----
```

Update and Test SAML configuration をクリックして、設定を保存できます。

SSOプロバイダー（IdP）のログイン画面にリダイレクトされるはずです。ログインが完了すると、組織の設定ページにリダイレクトされます。

SAMLセレクタの近くに緑色のチェックマークが表示されれば、テストが正常に完了したことを示します。

	
	

## ステップ4: 組織でSSOを有効にする

Single Sign-On の設定とテストが完了したので、「Enable」ボタンをクリックして、組織のメンバーに対してこれを有効にできます。

有効化後、組織のメンバーは[仕組み](./security-sso-basic#how-it-works)セクションに記載されているSSO認証フローを完了する必要があります。