> ## Documentation Index
> Fetch the complete documentation index at: https://docs-dev-feat-init-gt-translations.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
> アプリケーションで JWT で保護された認可リクエスト (JAR) を設定する方法を学びます。
# JWT で保護された認可リクエスト (JAR) を設定する
export const AuthCodeBlock = ({filename, icon, language, highlight, children}) => {
const [displayText, setDisplayText] = useState(children);
const [copyText, setCopyText] = useState(children);
const wrapperRef = React.useRef(null);
useEffect(() => {
let unsubscribe = null;
function init() {
if (!window.autorun || !window.rootStore) {
return;
}
unsubscribe = window.autorun(() => {
let processedChildrenForDisplay = children;
let processedChildrenForCopy = children;
for (const [key, value] of window.rootStore.variableStore.values.entries()) {
const escapedKey = key.replaceAll(/[.*+?^${}()|[\]\\]/g, (String.raw)`\$&`);
let displayValue = value;
if (key === "{yourClientSecret}" && value !== "{yourClientSecret}") {
displayValue = value.substring(0, 3) + "*****MASKED*****";
}
processedChildrenForDisplay = processedChildrenForDisplay.replaceAll(new RegExp(escapedKey, "g"), displayValue);
processedChildrenForCopy = processedChildrenForCopy.replaceAll(new RegExp(escapedKey, "g"), value);
}
setDisplayText(processedChildrenForDisplay);
setCopyText(processedChildrenForCopy);
});
}
if (window.rootStore) {
init();
} else {
window.addEventListener("adu:storeReady", init);
}
return () => {
window.removeEventListener("adu:storeReady", init);
unsubscribe?.();
};
}, [children]);
useEffect(() => {
if (!wrapperRef.current) return;
const originalWriteText = navigator.clipboard.writeText.bind(navigator.clipboard);
let isOverriding = false;
const handleClick = e => {
const button = e.target.closest('[data-testid="copy-code-button"]');
if (!button || !wrapperRef.current.contains(button)) return;
isOverriding = true;
navigator.clipboard.writeText = text => {
if (isOverriding) {
isOverriding = false;
navigator.clipboard.writeText = originalWriteText;
return originalWriteText(copyText);
}
return originalWriteText(text);
};
setTimeout(() => {
if (isOverriding) {
isOverriding = false;
navigator.clipboard.writeText = originalWriteText;
}
}, 100);
};
const wrapper = wrapperRef.current;
wrapper.addEventListener('click', handleClick, true);
return () => {
wrapper.removeEventListener('click', handleClick, true);
if (navigator.clipboard.writeText !== originalWriteText) {
navigator.clipboard.writeText = originalWriteText;
}
};
}, [copyText]);
return
{displayText}
;
};
export const codeExample1 = `POST https://{yourTenant}.auth0.com/api/v2/clients/{yourClientId}/credentials
Authorization: Bearer
Content-Type: application/json
{
"name": "JAR向けの資格情報",
"credential_type": "public_key",
"pem": "[YOUR PEM FILE CONTENT]",
"alg": "RS256"
}`;
export const codeExample2 = `PATCH https://{yourTenant}.auth0.com/api/v2/clients/{yourClientId}
Authorization: Bearer
Content-Type: application/json
{
"signed_request_object": {
"credentials": [{"id": "[YOUR CREDENTIAL ID]"}]
}
}`;
Highly Regulated Identity 機能を使用するには、Highly Regulated Identity アドオンを含む Enterprise プランが必要です。詳しくは、[Auth0 Pricing](https://auth0.com/pricing/)を参照してください。
JWT-Secured Authorization Requests (JAR) では、OAuth 2.0 の認可リクエストパラメーターを 1 つの JWT リクエストパラメーターにまとめ、完全性を保護するために署名できます。
前提条件
JAR を使用するようにアプリケーションを設定する前に、[RSA キーペアを生成する](/docs/ja-jp/secure/application-credentials/generate-rsa-key-pair)必要があります。
資格情報の用途ごとに、別々のキーペアを生成してください。たとえば、JAR と Private Key JWT 認証の両方に同じキーペアを使い回さないでください。
アプリケーションのJARは、Auth0 Dashboard と Management API を使用して設定できます。
Auth0 Dashboard を使用して、事前に生成した RSA キーで JAR を使用するようにアプリケーションを設定します。
1. [Auth0 Dashboard > アプリケーション](https://manage.auth0.com/#/applications) に移動します。
2. JAR で使用するアプリケーションを選択します。
3. **Application Settings** タブを選択します。
4. **Authorization Requests** セクションで、**Require JWT-Secured Authorization Requests** を有効にします。
5. 資格情報が割り当てられておらず、利用可能な資格情報がある場合は、既存の資格情報を割り当てるよう求められます。
6. 新しい資格情報を割り当てることもできます。
7. 事前に生成した RSA キーペアをアップロードして、新しい資格情報を追加し、割り当てます。求められたら、次の内容を入力します。
* **Name**: 資格情報を識別するための名前
* **Public Key**: PEM 形式の X.509 証明書の公開キー
* **Algorithm**: JAR の署名アルゴリズムを選択
* **Expiration Date**: 資格情報の有効期限を設定
[Management API](https://auth0.com/docs/api/management/v2) を使用して、`signed_request_object` クライアント設定プロパティでアプリケーションの JAR を設定します。このオブジェクトプロパティには、次のフィールドが含まれます。
* `required`: `/authorize` および `/oauth/par` へのすべての認可リクエストで JAR の使用を必須にします。詳しくは、[JWT で保護された認可リクエストを使用する認可コードフロー](/docs/ja-jp/get-started/authentication-and-authorization-flow/authorization-code-flow/authorization-code-flow-with-jar) を参照してください。
* `credentials`: 署名の検証に使用する資格情報 ID の配列です。
`credentials` パラメーターは、Private Key JWT パラメーター `client_authentication_methods.private_key_jwt.credentials` と同様に動作し、新しいアプリケーションの作成時に資格情報の作成をサポートします。詳しくは、[Private Key JWT を設定する](/docs/ja-jp/get-started/applications/configure-private-key-jwt) を参照してください。
Management API を使用すると、新しいアプリケーションまたは既存のアプリケーションに対して JAR を設定できます。
新しいアプリケーションを作成するときは、`signed_request_object` を含む POST リクエストを送信して JAR を設定します。その POST リクエストでは、対応するクライアント資格情報 (つまりキー PEM) も登録できます。
```json lines theme={null}
POST https://{yourTenant}.auth0.com/api/v2/clients
Authorization: Bearer
Content-Type: application/json
{
"name": "My App using JAR",
"signed_request_object": {
"required": true,
"credentials": [{
"name": "My credential for JAR",
"credential_type": "public_key",
"pem": "[YOUR PEM FILE CONTENT]",
"alg": "RS256"
}]
},
"jwt_configuration": {
"alg": "RS256"
}
}
```
既存のアプリケーションを更新する場合は、まずクライアント資格情報を明示的に作成する必要があります。次の POST リクエストでは、PEM ファイルの内容を使用して JAR 用のクライアント資格情報を作成します。
改行が余分な書式なしで適切に JSON エンコードされていることを確認してください。
次に、クライアント資格情報を `signed_request_object` クライアント設定に割り当てます。次の PATCH リクエストは、クライアント資格情報を `signed_request_object` に関連付けます。
詳しくはこちら
* [JWT で保護された認可リクエスト (JAR) を使用する認可コードフロー](/docs/ja-jp/get-started/authentication-and-authorization-flow/authorization-code-flow/authorization-code-flow-with-jar)