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