クライアントを作成
新しいクライアント(アプリケーションまたは SSO 連携)を作成します。詳細は、Create Applications API Endpoints for Single Sign-On を参照してください。
注:
- 安全なシークレットを生成できるよう、
client_secretパラメーターは指定しないことを推奨します。 client_authentication_methodsプロパティとtoken_endpoint_auth_methodプロパティは相互排他的です。クライアントを Private Key JWT 認証方法で設定するには、client_authentication_methodsを使用してください。それ以外の場合は、token_endpoint_auth_methodを使用して、クライアントを client secret(basic または post)、または認証方法なし(none)で設定してください。client_authentication_methodsを使用してクライアントを Private Key JWT 認証方法で設定する場合は、完全に定義された資格情報を指定してください。 これらの資格情報は、クライアントの Private Key JWT 認証で自動的に有効になります。client_authentication_methodsを設定するには、create:client_credentialsスコープが必要です。client_authentication_methodsを設定するには、jwt_configuration.algプロパティを RS256 に設定する必要があります。
このエンドポイント経由で作成された SSO 連携は、login リクエストを受け付け、ユーザープロファイル情報を共有します。
承認
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
ボディ
このクライアントの名前(最小長: 1 文字、< または > は使用できません)。
^[^<>]+$このクライアントの説明を自由記述で入力します(最大 140 文字)。
140このクライアントに表示するロゴの URL です。推奨サイズは 150 x 150 ピクセルです。
authentication 後に Auth0 がクライアントへのコールバックとして使用できる、許可リスト登録済み URL のカンマ区切りリストです。
OIDCバックチャネルログアウトの設定
OIDC バックチャネル logout の設定(非推奨。代わりに oidc_logout を使用)
ネイティブからWebへのSSO の設定
JavaScript から Auth0 API へのリクエストを許可する URL のカンマ区切りリストです(通常は CORS で使用)。デフォルトでは、すべてのコールバック URL が許可されます。このフィールドでは、必要に応じて他のオリジンも指定できます。サブドメインレベルではワイルドカードも使用できます(例: https://*.contoso.com)。これらの URL の検証時には、クエリ文字列とハッシュ情報は考慮されません。
Cross-Origin Authentication、Device Flow、および web message response mode で使用する許可済みオリジンのカンマ区切りリストです。
SAML プロトコル用の audience/レルム のリストです。wsfed アドオンで使用されます。
1委譲リクエストを実行できる許可済みクライアントおよび API ID のリストです。空の場合は、すべてのクライアントが許可されます。
1Auth0 から logout した後のリダイレクト先として有効な URL のカンマ区切りリストです。サブドメインにはワイルドカードを使用できます。
このアプリケーションでサポートされるグラントタイプのリストです。authorization_code、implicit、refresh_token、client_credentials、password、http://auth0.com/oauth/grant-type/password-realm、http://auth0.com/oauth/grant-type/mfa-oob、http://auth0.com/oauth/grant-type/mfa-otp、http://auth0.com/oauth/grant-type/mfa-recovery-code、urn:openid:params:grant-type:ciba、urn:ietf:params:oauth:grant-type:device_code、urn:auth0:params:oauth:grant-type:token-exchange:federated-connection-access-token を含めることができます。
1トークンエンドポイントに対して要求される認証方法を定義します。none(client secret を持たないパブリッククライアント)、client_secret_post(クライアントは HTTP POST パラメーターを使用)、または client_secret_basic(クライアントは HTTP Basic を使用)を指定できます。
none, client_secret_post, client_secret_basic true の場合、Token endpoint のブルートフォース保護において、auth0-forwarded-for ヘッダーで指定された IP をエンドユーザーの IP として信頼します。
このクライアントが表すアプリケーションの種類
native, spa, regular_web, non_interactive, resource_server, express_configuration, rms, box, cloudbees, concur, dropbox, mscrm, echosign, egnyte, newrelic, office365, salesforce, sentry, sharepoint, slack, springcm, zendesk, zoom, sso_integration, oag このクライアントがファーストパーティクライアントかどうか
このクライアントが厳格な OIDC 仕様に準拠しているか(true)、またはレガシー機能を使用するか(false)を示します。
クライアントのJWTに関する設定。
このクライアントの WS-Fed レスポンスで使用される暗号化。
SSO クライアントにのみ適用され、シングルサインオンを Auth0 が処理するか(true)、アイデンティティプロバイダーが処理するか(false)を決定します。
このクライアントが cross-origin authentication リクエストの実行に使用できるか(true)、またはそのようなリクエストが許可されていないか(false)を示します。
Auth0 のホスト型 login page ではなく独自ドメインで認証を行う場合に、cross-origin auth フローでクロスオリジン検証を実施するサイト上の場所の URL です。
シングルサインオンを無効にする場合は true、それ以外は false(デフォルト: false)
カスタム login page を使用する場合は true、それ以外は false。デフォルトは true です
カスタム login page の内容(HTML、CSS、JS)です。
1カスタム login page の内容(HTML、CSS、JS)です(プレビューで使用)。
1WS-Federation で使用する HTML フォームテンプレートです。
1このクライアントで有効になっているアドオンと、その関連設定。
クライアントに関連付けられたメタデータ。文字列値を持つオブジェクト形式です(最大255文字)。メタデータプロパティは最大10個まで使用できます。フィールド名(最大255文字)は英数字で、使用できる特殊文字は次のとおりです: :,-+=_*?"/()<>@ [Tab] [Space]
ネイティブモバイルアプリ向けの追加設定。
login URI を開始するための URI です。https である必要があります
ネイティブソーシャルの設定
新しい Universal Login の FedCM ログイン設定を構成
リフレッシュトークンの設定
デフォルトの組織IDとフローを定義します。
organization に関して認証トランザクションをどのように進めるかを定義します。deny(デフォルト)、allow、または require を指定できます。
deny, allow, require client.organization_usage: 'require' の場合に、認証トランザクションをどのように進めるかを定義します。no_prompt(デフォルト)、pre_login_prompt、または post_login_prompt を指定できます。post_login_prompt には oidc_conformant: true が必要です。
no_prompt, pre_login_prompt, post_login_prompt pre_login_prompt 中の organization 検出で使用できる方法を定義します。ユーザーは email、organization_name、またはその両方で organization を検出できます。
1pre_login_prompt 中に組織を検出する方法。email では、ユーザーはメールアドレスを入力してドメイン照合を行うことで自分の組織を見つけられます。一方、organization_name では、ユーザーが organization名 を直接入力する必要があります。これらの方法は組み合わせて使用できます。
email, organization_name クライアント認証方法を定義します。
このクライアントでプッシュ型認可リクエストの使用を必須にします
このクライアントで Proof-of-Possession の使用を必須にします
JWT で保護された認可リクエスト(JAR)の設定。
Token Vault の特権アクセスに関する設定。
このクライアントの準拠レベルを定義します。これにより、機能が制限される場合があります。
none, fapi1_adv_pkj_par, fapi1_adv_mtls_par, fapi2_sp_pkj_mtls, fapi2_sp_mtls_mtls, null リダイレクト URI が検証不能なコールバック URI(たとえば myapp:// のようなカスタム URI スキーマや localhost)を使用している場合に、ログインフロー中に確認プロンプトを表示するかどうかを制御します。
true に設定すると、確認プロンプトは表示されません。悪意のあるアプリからの保護を強化するため、false に設定することを推奨します。
詳細については https://auth0.com/docs/secure/security-guidance/measures-against-app-impersonation を参照してください。
トークン交換の設定。
プッシュ型認可リクエスト URI の有効期間を秒単位で指定します
10 <= x <= 600このクライアントにリンクされているリソースサーバーの identifier です。
1 - 600Cross App Access での ID-JAG の使用に関する設定。
このクライアントの匿名セッション設定。
匿名セッション転送トークンの使用時にネットワークへの紐付けを強制するかどうかを示します。'ip' に設定すると、発行者と同じ IP アドレスから使用する必要があります。'asn' に設定すると、発行者と同じ ASN から使用する必要があります。'none' に設定すると、紐付けは強制されません。既定値は ip です。
ip, asn, none サードパーティ クライアントのセキュリティモード。strict は、強化されたセキュリティ制御を適用します。これには、OAuth 2.1 への準拠、明示的な API 認可、サポート対象機能を厳選したセットが含まれます。permissive は既存の動作を維持し、以前からサードパーティ クライアントを使用している tenant でのみ利用できます。作成時に設定され、後から変更することはできません。
strict, permissive 認証エラー時またはメール認証フローにおいて、Auth0 がユーザーをアプリケーションのコールバックURLにリダイレクトするかどうかを制御します。open_redirect_protection はリダイレクトの代わりにエラーページを表示し、メールテンプレートでコールバックドメインを非表示にします。allow_always は標準のリダイレクト動作を有効にします。サードパーティのクライアントでは、デフォルトで open_redirect_protection が使用されます。これは is_first_party が false で、third_party_security_mode が strict の場合にのみ適用されます。詳しくは、Redirect protection を参照してください。
allow_always, open_redirect_protection OIN Express Configuration機能で使用するアプリケーション固有の設定。
B2B 連携クライアントの設定。
クライアントのMy Organization Configurationに関する設定。
承認が必要な場合にユーザーへ通知するための通知チャネルの配列。有効な値は guardian-push、email、my-account です。
1guardian-push, email, my-account クライアントのOIDC対応を設定します。OIDCフローを許可するかどうかと、クライアントがリクエストできるスコープを指定します。
レスポンス
クライアントが正常に作成されました。
このクライアントの ID です。
このクライアントが作成された日時の ISO 8601 タイムスタンプ。
このクライアントが最後に更新された日時の ISO 8601 タイムスタンプ。
このクライアントが属する tenant の名前です。
このクライアントの名前です(最小 1 文字、< と > は使用不可)。
このクライアントの説明を自由記述で入力します(最大 140 文字)。
これが、レガシーなテナント設定を表すグローバルな「All Applications」クライアントであるか(true)、通常のクライアントであるか(false)を示します。
Client secret(公開してはいけません)。
このクライアントが表すアプリケーションの種類
native, spa, regular_web, non_interactive, resource_server, express_configuration, rms, box, cloudbees, concur, dropbox, mscrm, echosign, egnyte, newrelic, office365, salesforce, sentry, sharepoint, slack, springcm, zendesk, zoom, sso_integration, oag このクライアントに表示するロゴの URL。推奨サイズは 150 x 150 ピクセルです。
このクライアントがファーストパーティクライアントであるか(true)、そうでないか(false)を示します。
このクライアントが厳格な OIDC 仕様に準拠しているか(true)、またはレガシー機能を使用するか(false)を示します。
認証後に Auth0 がクライアントへのコールバックとして使用できるよう許可された URL のカンマ区切りリスト。
JavaScript から Auth0 API へのリクエスト送信を許可する URL のカンマ区切りリスト(通常は CORS で使用)。デフォルトでは、すべてのコールバック URL が許可されます。必要に応じて、このフィールドで他のオリジンを指定できます。サブドメインレベルではワイルドカードも使用できます(例: https://*.contoso.com)。これらの URL を検証する際、クエリ文字列とハッシュ情報は考慮されません。
Cross-Origin Authentication、Device Flow、およびweb message response modeでの使用を許可するオリジンのカンマ区切りリスト。
SAML プロトコル用の audience/レルムのリスト。wsfed アドオンで使用されます。
委譲リクエストの実行を許可するクライアントおよび API ID のリスト。空の場合は、すべてのクライアントが許可されます。
Auth0 からログアウトした後のリダイレクト先として有効な URL のカンマ区切りリスト。サブドメインにはワイルドカードを使用できます。
ネイティブからWebへのSSO の設定
OIDCバックチャネルログアウトの設定
このアプリケーションでサポートされるグラントタイプのリスト。authorization_code、implicit、refresh_token、client_credentials、password、http://auth0.com/oauth/grant-type/password-realm、http://auth0.com/oauth/grant-type/mfa-oob、http://auth0.com/oauth/grant-type/mfa-otp、http://auth0.com/oauth/grant-type/mfa-recovery-code、urn:openid:params:grant-type:ciba、urn:ietf:params:oauth:grant-type:device_code、urn:auth0:params:oauth:grant-type:token-exchange:federated-connection-access-token を含めることができます。
クライアントのJWTに関する設定。
このクライアントに関連付けられた署名証明書。
このクライアントの WS-Fed レスポンスで使用される暗号化。
SSO クライアントにのみ適用され、シングルサインオンを Auth0 が処理するか(true)、IDプロバイダーが処理するか(false)を決定します。
シングルサインオンを無効にするか(true)、有効にするか(true)を示します。デフォルトは true です。
このクライアントがクロスオリジン認証リクエストに使用できるか(true)、そのようなリクエストが許可されていないか(false)を示します。
Auth0 のホストする login page ではなく独自ドメインで認証を実行する場合に、クロスオリジン認証フローのクロスオリジン検証を行うサイト上の URL。
カスタム login page を使用するか(true)、デフォルトで提供される login page を使用するか(false)を示します。
カスタム login page の内容(HTML、CSS、JS)。
カスタム login page の内容(HTML、CSS、JS)。(プレビューで使用)
WS-Federation で使用する HTML フォームテンプレート。
このクライアントで有効になっているアドオンと、その関連設定。
トークンエンドポイントに対して要求される認証方法を定義します。none(client secret を持たないパブリッククライアント)、client_secret_post(クライアントは HTTP POST パラメーターを使用)、または client_secret_basic(クライアントは HTTP Basic を使用)を指定できます。
none, client_secret_post, client_secret_basic true の場合、token endpoint での総当たり攻撃対策のため、auth0-forwarded-for ヘッダーで指定された IP をエンドユーザーの IP として信頼します。
クライアントに関連付けられたメタデータ。文字列値を持つオブジェクト形式です(最大255文字)。メタデータプロパティは最大10個まで使用できます。フィールド名(最大255文字)は英数字で、使用できる特殊文字は次のとおりです: :,-+=_*?"/()<>@ [Tab] [Space]
ネイティブモバイルアプリ向けの追加設定。
ログイン開始 URI。https である必要があります
ネイティブソーシャルの設定
新しい Universal Login の FedCM ログイン設定を構成
リフレッシュトークンの設定
デフォルトの組織IDとフローを定義します。
organization に関して認証トランザクションをどのように進めるかを定義します。deny(デフォルト)、allow、または require を指定できます。
deny, allow, require client.organization_usage: 'require' の場合に、認証トランザクションをどのように進めるかを定義します。no_prompt(デフォルト)、pre_login_prompt、または post_login_prompt を指定できます。post_login_prompt には oidc_conformant: true が必要です。
no_prompt, pre_login_prompt, post_login_prompt pre_login_prompt での organization 検出に使用できる方法を定義します。ユーザーは email、organization_name、またはその両方で organization を検出できます。
1pre_login_prompt 中に組織を検出する方法。email では、ユーザーはメールアドレスを入力してドメイン照合を行うことで自分の組織を見つけられます。一方、organization_name では、ユーザーが organization名 を直接入力する必要があります。これらの方法は組み合わせて使用できます。
email, organization_name クライアント認証方法を定義します。
このクライアントでプッシュ型認可リクエストの使用を必須にします
このクライアントで Proof-of-Possession の使用を必須にします
JWT で保護された認可リクエスト(JAR)の設定。
Token Vault の特権アクセスに関する設定。
このクライアントの準拠レベルを定義します。これにより、機能が制限される場合があります。
none, fapi1_adv_pkj_par, fapi1_adv_mtls_par, fapi2_sp_pkj_mtls, fapi2_sp_mtls_mtls, null リダイレクト URI が検証不能なコールバック URI(たとえば、myapp:// のようなカスタム URI スキーマや localhost)を使用している場合に、ログインフロー中に確認プロンプトを表示するかどうかを制御します。
true に設定すると、確認プロンプトは表示されません。悪意のあるアプリからの保護を強化するため、false に設定することを推奨します。
詳細は https://auth0.com/docs/secure/security-guidance/measures-against-app-impersonation を参照してください。
トークン交換の設定。
プッシュ型認可リクエスト URI の有効期間を秒単位で指定します
10 <= x <= 600OIN Express Configuration機能で使用するアプリケーション固有の設定。
B2B 連携クライアントの設定。
クライアントの My Organization Configuration に関連する設定。
クロスアプリアクセスにおける ID-JAG の使用に関する設定。
このクライアントの匿名セッション設定。
匿名セッション転送トークンの使用時にネットワークへの紐付けを強制するかどうかを示します。'ip' に設定すると、発行者と同じ IP アドレスから使用する必要があります。'asn' に設定すると、発行者と同じ ASN から使用する必要があります。'none' に設定すると、紐付けは強制されません。既定値は ip です。
ip, asn, none サードパーティ クライアントのセキュリティモード。strict は、強化されたセキュリティ制御を適用します。これには、OAuth 2.1 への準拠、明示的な API 認可、サポート対象機能を厳選したセットが含まれます。permissive は既存の動作を維持し、以前からサードパーティ クライアントを使用している tenant でのみ利用できます。作成時に設定され、後から変更することはできません。
strict, permissive 認証エラー時またはメール認証フローにおいて、Auth0 がユーザーをアプリケーションのコールバックURLにリダイレクトするかどうかを制御します。open_redirect_protection はリダイレクトの代わりにエラーページを表示し、メールテンプレートでコールバックドメインを非表示にします。allow_always は標準のリダイレクト動作を有効にします。サードパーティのクライアントでは、デフォルトで open_redirect_protection が使用されます。これは is_first_party が false で、third_party_security_mode が strict の場合にのみ適用されます。詳しくは、Redirect protection を参照してください。
allow_always, open_redirect_protection このクライアントが関連付けられているリソースサーバーの identifier。
承認が必要な場合にユーザーへ通知するための通知チャネルの配列。有効な値は guardian-push、email、my-account です。
1guardian-push, email, my-account クライアントの登録に使用された外部メタデータの種類を示します。このフィールドは通常のクライアントでは省略されます。値 cimd は、Client ID Metadata Document 経由で登録されたクライアントを示します。値 dcr は、Dynamic Client Registration 経由で登録されたクライアントを示します。
cimd, dcr 外部メタデータ クライアントを作成した主体を示します。値 admin は、クライアントが Management API 経由で登録されたことを示します。値 client は、クライアントが動的に登録されたことを示します。このフィールドは、external_metadata_type が設定されている場合にのみ存在します。
admin, client 認可フロー中に使用する代替のクライアント識別子。CIMD ベースのクライアント識別子のみをサポートします。
private_key_jwt 認証で使用する公開鍵を含む JSON Web Key Set(JWKS)の URL。private_key_jwt 認証を使用する CIMD クライアントにのみ存在します。