> ## Documentation Index
> Fetch the complete documentation index at: https://docs-staging-feat-sdk-reference-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Auth0 Dashboard を使用して、Auth0 テナントの Customer Managed Keys (BYOK) を有効化および設定します。

# Auth0 Dashboard を使用して Customer Managed Keys を設定する

Auth0 は、エンベロープ暗号化のキー階層の最上位にある Auth0 Environment Root Key を使用して、テナントのシークレットとデータを保護しています。Auth0 Environment Root Key と 顧客提供ルートキー は、対応する Auth0 Cloud Service Provider である AWS または Azure のハードウェアセキュリティモジュール (HSM) に保存されます。

<h2 id="bring-your-own-key">
  Bring Your Own Key
</h2>

Bring Your Own Key を使用すると、[Key Management Editor role](/docs/ja-jp/get-started/manage-dashboard-access/add-dashboard-users) を持つユーザーは、<Tooltip tip="Auth0 Dashboard: サービスを設定するための Auth0 の主要製品。" cta="用語集を見る" href="/docs/ja-jp/glossary?term=Auth0+Dashboard">Auth0 Dashboard</Tooltip> から、既定の Auth0 Environment Root Key を自身の 顧客提供ルートキー に置き換えることができます。

顧客は、自身の暗号化マテリアルを含む独自の Root Key を安全にアップロードすることで、次のことが可能になります。

* Environment Root Key に対する独自のキー生成要件および来歴要件を満たす。
* Environment Root Key に対する特定のキー導入要件または有効期間要件を満たす。

<Warning>
  Bring Your Own Key を使用して独自の 顧客提供ルートキー をインポートすると、その削除を除き、顧客提供ルートキー のライフサイクル管理を Auth0 に委ねないことになります。
</Warning>

開始するには、Auth0 Dashboard > 設定 > Encryption Keys に移動します

<Frame>
  <img src="https://mintcdn.com/docs-staging-feat-sdk-reference-docs/po5ocnRNTrslIk5C/docs/images/cdy7uua7fh8z/1qmfCSl7cOugrHIAdxSyAt/6c7d7185920e61809d9423c8e3d4c4f2/Encryption_Keys_-_EN.png?fit=max&auto=format&n=po5ocnRNTrslIk5C&q=85&s=3db7e0681c343dd2d29fbe1d10e37dc2" alt="Auth0 Dashboard > 設定 > Encryption Keys" data-og-width="1162" width="1162" data-og-height="577" height="577" data-path="docs/images/cdy7uua7fh8z/1qmfCSl7cOugrHIAdxSyAt/6c7d7185920e61809d9423c8e3d4c4f2/Encryption_Keys_-_EN.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/docs-staging-feat-sdk-reference-docs/po5ocnRNTrslIk5C/docs/images/cdy7uua7fh8z/1qmfCSl7cOugrHIAdxSyAt/6c7d7185920e61809d9423c8e3d4c4f2/Encryption_Keys_-_EN.png?w=280&fit=max&auto=format&n=po5ocnRNTrslIk5C&q=85&s=ae1cb9e26499b35a8bd4eaec649fb11e 280w, https://mintcdn.com/docs-staging-feat-sdk-reference-docs/po5ocnRNTrslIk5C/docs/images/cdy7uua7fh8z/1qmfCSl7cOugrHIAdxSyAt/6c7d7185920e61809d9423c8e3d4c4f2/Encryption_Keys_-_EN.png?w=560&fit=max&auto=format&n=po5ocnRNTrslIk5C&q=85&s=44b26b99227742ebfff3c61c252c44f6 560w, https://mintcdn.com/docs-staging-feat-sdk-reference-docs/po5ocnRNTrslIk5C/docs/images/cdy7uua7fh8z/1qmfCSl7cOugrHIAdxSyAt/6c7d7185920e61809d9423c8e3d4c4f2/Encryption_Keys_-_EN.png?w=840&fit=max&auto=format&n=po5ocnRNTrslIk5C&q=85&s=f6a9b572113ed1183414b3c827c131ff 840w, https://mintcdn.com/docs-staging-feat-sdk-reference-docs/po5ocnRNTrslIk5C/docs/images/cdy7uua7fh8z/1qmfCSl7cOugrHIAdxSyAt/6c7d7185920e61809d9423c8e3d4c4f2/Encryption_Keys_-_EN.png?w=1100&fit=max&auto=format&n=po5ocnRNTrslIk5C&q=85&s=fbfca1e8d0af50b4cd7d3bb6bf30d187 1100w, https://mintcdn.com/docs-staging-feat-sdk-reference-docs/po5ocnRNTrslIk5C/docs/images/cdy7uua7fh8z/1qmfCSl7cOugrHIAdxSyAt/6c7d7185920e61809d9423c8e3d4c4f2/Encryption_Keys_-_EN.png?w=1650&fit=max&auto=format&n=po5ocnRNTrslIk5C&q=85&s=8556d1cc4c5f1a2a0322405bb6216625 1650w, https://mintcdn.com/docs-staging-feat-sdk-reference-docs/po5ocnRNTrslIk5C/docs/images/cdy7uua7fh8z/1qmfCSl7cOugrHIAdxSyAt/6c7d7185920e61809d9423c8e3d4c4f2/Encryption_Keys_-_EN.png?w=2500&fit=max&auto=format&n=po5ocnRNTrslIk5C&q=85&s=8c29496926b5ea2c1ba605f7114b7c59 2500w" />
</Frame>

**Upload Key** を選択して、顧客提供ルートキー のインポートプロセスを開始します。すると、インポートダイアログが開きます。

<Frame>
  <img src="https://mintcdn.com/docs-staging-feat-sdk-reference-docs/po5ocnRNTrslIk5C/docs/images/cdy7uua7fh8z/1GJPgT1Be7Wm6G6ldCVW4q/96e5a326aa643f29bb50aea76fce27aa/image__2_.png?fit=max&auto=format&n=po5ocnRNTrslIk5C&q=85&s=205c5f745e198d62cf69c797c473a4ce" alt="Auth0 Dashboard > 設定 > Encryption Keys > Upload" data-og-width="629" width="629" data-og-height="462" height="462" data-path="docs/images/cdy7uua7fh8z/1GJPgT1Be7Wm6G6ldCVW4q/96e5a326aa643f29bb50aea76fce27aa/image__2_.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/docs-staging-feat-sdk-reference-docs/po5ocnRNTrslIk5C/docs/images/cdy7uua7fh8z/1GJPgT1Be7Wm6G6ldCVW4q/96e5a326aa643f29bb50aea76fce27aa/image__2_.png?w=280&fit=max&auto=format&n=po5ocnRNTrslIk5C&q=85&s=49f7587811b66c85e1670f74e5c476e7 280w, https://mintcdn.com/docs-staging-feat-sdk-reference-docs/po5ocnRNTrslIk5C/docs/images/cdy7uua7fh8z/1GJPgT1Be7Wm6G6ldCVW4q/96e5a326aa643f29bb50aea76fce27aa/image__2_.png?w=560&fit=max&auto=format&n=po5ocnRNTrslIk5C&q=85&s=4ee340005356b35522e8f9e174b0b1f2 560w, https://mintcdn.com/docs-staging-feat-sdk-reference-docs/po5ocnRNTrslIk5C/docs/images/cdy7uua7fh8z/1GJPgT1Be7Wm6G6ldCVW4q/96e5a326aa643f29bb50aea76fce27aa/image__2_.png?w=840&fit=max&auto=format&n=po5ocnRNTrslIk5C&q=85&s=4adcb071e73f96cbac2b75e77e573694 840w, https://mintcdn.com/docs-staging-feat-sdk-reference-docs/po5ocnRNTrslIk5C/docs/images/cdy7uua7fh8z/1GJPgT1Be7Wm6G6ldCVW4q/96e5a326aa643f29bb50aea76fce27aa/image__2_.png?w=1100&fit=max&auto=format&n=po5ocnRNTrslIk5C&q=85&s=c0008077aab288ae85876a86a37234e2 1100w, https://mintcdn.com/docs-staging-feat-sdk-reference-docs/po5ocnRNTrslIk5C/docs/images/cdy7uua7fh8z/1GJPgT1Be7Wm6G6ldCVW4q/96e5a326aa643f29bb50aea76fce27aa/image__2_.png?w=1650&fit=max&auto=format&n=po5ocnRNTrslIk5C&q=85&s=23518fd8e125cd699b015218146ca94f 1650w, https://mintcdn.com/docs-staging-feat-sdk-reference-docs/po5ocnRNTrslIk5C/docs/images/cdy7uua7fh8z/1GJPgT1Be7Wm6G6ldCVW4q/96e5a326aa643f29bb50aea76fce27aa/image__2_.png?w=2500&fit=max&auto=format&n=po5ocnRNTrslIk5C&q=85&s=b809ac7b6297ce6f21a4d0e3782d73f9 2500w" />
</Frame>

**Upload Key** を選択してから **Download** を選択すると、Bring Your Own Key プロセスが開始されます。

1. 公開ラッピングキーを作成し、お使いのシステムにダウンロードします。
2. 公開ラッピングキーを使用して、独自のキー管理システムで自身の暗号化マテリアルをラップし、Wrapped Encryption Key (顧客提供ルートキー) を作成します。
3. Wrapped Encryption Key をアップロードし、**Save** を選択します。

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  Wrapped Encryption Key をアップロードすると、ハードウェアセキュリティモジュール (AWS または Azure) 内で、Auth0 Environment Root Key が 顧客提供ルートキー に置き換えられます。
</Callout>

<h2 id="cryptographic-material-requirements">
  暗号マテリアルの要件
</h2>

キー管理システムを使用して、公開ラッピングキーで独自の暗号マテリアルをラップし、Wrapped Encryption Key を作成してください。Auth0 Cloud Service Provider (AWS または Azure) に応じて、[CKM\_RSA\_AES\_KEY\_WRAP](https://docs.oasis-open.org/pkcs11/pkcs11-curr/v2.40/cos01/pkcs11-curr-v2.40-cos01.html#_Toc408226894) アルゴリズムのパラメーターには以下の設定を使用してください。

<h3 id="auth0-on-aws-cloud">
  AWS クラウド上の Auth0
</h3>

* 公開ラッピングキーの長さ: 3072 ビット
* アルゴリズム: CKG\_MGF1\_SHA256
* CKM\_AES\_KEY\_WRAP\_PAD 用の一時 AES キーの長さ: 256 ビット
* 顧客提供ルートキーの種類: 256 ビット長の AES 対称キー

<h3 id="auth0-on-azure-cloud">
  Azure クラウドの Auth0
</h3>

* 公開ラッピングキーの長さ: 2048 ビット
* アルゴリズム: CKG\_MGF1\_SHA-1
* CKM\_AES\_KEY\_WRAP\_PAD 用の一時 AES キーの長さ: 256 ビット
* 顧客提供ルートキー のタイプ: 2048 ビット長の RSA 秘密キー
* 秘密キーのエンコーディング: PKCS #8 - ASN.1 DER
