> ## Documentation Index
> Fetch the complete documentation index at: https://docs-dev-chore-myaccount-api-autoupdate.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Activez et configurez les Customer Managed Keys (BYOK) pour votre tenant Auth0 à l’aide du Auth0 Dashboard.

# Configurer les Customer Managed Keys avec le Dashboard

Auth0 protège les secrets et les données de votre tenant à l’aide d’une Auth0 Environment Root Key, au sommet de la hiérarchie de clés du chiffrement par enveloppe. L’Auth0 Environment Root Key et la Customer Provided Root Key sont stockées dans le module matériel de sécurité (HSM) du fournisseur de services infonuagiques Auth0 correspondant, AWS ou Azure.

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

Avec Bring Your Own Key, les utilisateurs ayant le [Key Management Editor role](/docs/fr-ca/get-started/manage-dashboard-access/add-dashboard-users) peuvent utiliser le <Tooltip tip="Auth0 Dashboard : principal produit d’Auth0 pour configurer vos services." cta="Voir le glossaire" href="/docs/fr-ca/glossary?term=Auth0+Dashboard">Auth0 Dashboard</Tooltip> pour remplacer l’Auth0 Environment Root Key par défaut par leur propre Customer Provided Root Key.

Les clients peuvent téléverser de façon sécuritaire leur propre Root Key, qui contient leur propre matériel cryptographique, afin de :

* Répondre à des exigences personnalisées de génération et de provenance de clé pour l’Environment Root Key.
* Répondre à des exigences précises d’installation ou de durée de vie de clé pour l’Environment Root Key.

<Warning>
  En important votre propre Customer Provided Root Key avec Bring Your Own Key, vous retirez implicitement à Auth0 la gestion du cycle de vie de la Customer Provided Root Key, sauf en ce qui concerne sa suppression.
</Warning>

Pour commencer, accédez à Dashboard > Settings > Encryption Keys

<Frame>
  <img src="https://mintcdn.com/docs-dev-chore-myaccount-api-autoupdate/8QDqDsYoCi_WTBFO/docs/images/cdy7uua7fh8z/1qmfCSl7cOugrHIAdxSyAt/6c7d7185920e61809d9423c8e3d4c4f2/Encryption_Keys_-_EN.png?fit=max&auto=format&n=8QDqDsYoCi_WTBFO&q=85&s=1a25a33b5838cb9af0a60a0858eb0864" alt="Dashboard > Settings > Clés de chiffrement" 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-dev-chore-myaccount-api-autoupdate/8QDqDsYoCi_WTBFO/docs/images/cdy7uua7fh8z/1qmfCSl7cOugrHIAdxSyAt/6c7d7185920e61809d9423c8e3d4c4f2/Encryption_Keys_-_EN.png?w=280&fit=max&auto=format&n=8QDqDsYoCi_WTBFO&q=85&s=b029018ea5b85f7f93c9853b1e3d3a40 280w, https://mintcdn.com/docs-dev-chore-myaccount-api-autoupdate/8QDqDsYoCi_WTBFO/docs/images/cdy7uua7fh8z/1qmfCSl7cOugrHIAdxSyAt/6c7d7185920e61809d9423c8e3d4c4f2/Encryption_Keys_-_EN.png?w=560&fit=max&auto=format&n=8QDqDsYoCi_WTBFO&q=85&s=660aad6468be4b9cb953c231cd21641c 560w, https://mintcdn.com/docs-dev-chore-myaccount-api-autoupdate/8QDqDsYoCi_WTBFO/docs/images/cdy7uua7fh8z/1qmfCSl7cOugrHIAdxSyAt/6c7d7185920e61809d9423c8e3d4c4f2/Encryption_Keys_-_EN.png?w=840&fit=max&auto=format&n=8QDqDsYoCi_WTBFO&q=85&s=7e7e7b2d436c93e84debc9d6f815842f 840w, https://mintcdn.com/docs-dev-chore-myaccount-api-autoupdate/8QDqDsYoCi_WTBFO/docs/images/cdy7uua7fh8z/1qmfCSl7cOugrHIAdxSyAt/6c7d7185920e61809d9423c8e3d4c4f2/Encryption_Keys_-_EN.png?w=1100&fit=max&auto=format&n=8QDqDsYoCi_WTBFO&q=85&s=8e8829f9988695676a13454cc8a6a52e 1100w, https://mintcdn.com/docs-dev-chore-myaccount-api-autoupdate/8QDqDsYoCi_WTBFO/docs/images/cdy7uua7fh8z/1qmfCSl7cOugrHIAdxSyAt/6c7d7185920e61809d9423c8e3d4c4f2/Encryption_Keys_-_EN.png?w=1650&fit=max&auto=format&n=8QDqDsYoCi_WTBFO&q=85&s=ef01f0c28e75d9374c29a10a09522f68 1650w, https://mintcdn.com/docs-dev-chore-myaccount-api-autoupdate/8QDqDsYoCi_WTBFO/docs/images/cdy7uua7fh8z/1qmfCSl7cOugrHIAdxSyAt/6c7d7185920e61809d9423c8e3d4c4f2/Encryption_Keys_-_EN.png?w=2500&fit=max&auto=format&n=8QDqDsYoCi_WTBFO&q=85&s=4de4957ef9ee6c2bcb4fdc7efb514325 2500w" />
</Frame>

Sélectionnez **Upload Key** pour lancer le processus d’importation de votre Customer Provided Root Key. Cela ouvrira la boîte de dialogue d’importation :

<Frame>
  <img src="https://mintcdn.com/docs-dev-chore-myaccount-api-autoupdate/G9kmP20ll8AiX0Om/docs/images/cdy7uua7fh8z/1GJPgT1Be7Wm6G6ldCVW4q/96e5a326aa643f29bb50aea76fce27aa/image__2_.png?fit=max&auto=format&n=G9kmP20ll8AiX0Om&q=85&s=ca0c3ff1ce3fe231f201125be04119ca" alt="Dashboard > Settings > Clés de chiffrement > Téléverser" 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-dev-chore-myaccount-api-autoupdate/G9kmP20ll8AiX0Om/docs/images/cdy7uua7fh8z/1GJPgT1Be7Wm6G6ldCVW4q/96e5a326aa643f29bb50aea76fce27aa/image__2_.png?w=280&fit=max&auto=format&n=G9kmP20ll8AiX0Om&q=85&s=2653805e65ec31f8527e4c5ab1ac095f 280w, https://mintcdn.com/docs-dev-chore-myaccount-api-autoupdate/G9kmP20ll8AiX0Om/docs/images/cdy7uua7fh8z/1GJPgT1Be7Wm6G6ldCVW4q/96e5a326aa643f29bb50aea76fce27aa/image__2_.png?w=560&fit=max&auto=format&n=G9kmP20ll8AiX0Om&q=85&s=b992668e6a9da5caade3a4e63bfbd770 560w, https://mintcdn.com/docs-dev-chore-myaccount-api-autoupdate/G9kmP20ll8AiX0Om/docs/images/cdy7uua7fh8z/1GJPgT1Be7Wm6G6ldCVW4q/96e5a326aa643f29bb50aea76fce27aa/image__2_.png?w=840&fit=max&auto=format&n=G9kmP20ll8AiX0Om&q=85&s=3a22ef9c75e70616534554ce75ea7837 840w, https://mintcdn.com/docs-dev-chore-myaccount-api-autoupdate/G9kmP20ll8AiX0Om/docs/images/cdy7uua7fh8z/1GJPgT1Be7Wm6G6ldCVW4q/96e5a326aa643f29bb50aea76fce27aa/image__2_.png?w=1100&fit=max&auto=format&n=G9kmP20ll8AiX0Om&q=85&s=5437674225e5ce911fa0aa3ad379fcc0 1100w, https://mintcdn.com/docs-dev-chore-myaccount-api-autoupdate/G9kmP20ll8AiX0Om/docs/images/cdy7uua7fh8z/1GJPgT1Be7Wm6G6ldCVW4q/96e5a326aa643f29bb50aea76fce27aa/image__2_.png?w=1650&fit=max&auto=format&n=G9kmP20ll8AiX0Om&q=85&s=70949b540155c19b91feed5bfcdf1f71 1650w, https://mintcdn.com/docs-dev-chore-myaccount-api-autoupdate/G9kmP20ll8AiX0Om/docs/images/cdy7uua7fh8z/1GJPgT1Be7Wm6G6ldCVW4q/96e5a326aa643f29bb50aea76fce27aa/image__2_.png?w=2500&fit=max&auto=format&n=G9kmP20ll8AiX0Om&q=85&s=d6c48612323e6277555edd9f3c7ececc 2500w" />
</Frame>

Lorsque vous sélectionnez **Upload Key**, puis **Download**, le processus Bring Your Own Key est lancé :

1. Une clé d’enveloppement publique est créée et téléchargée sur votre système.
2. Prenez la clé d’enveloppement publique et utilisez-la pour envelopper votre propre matériel cryptographique à l’aide de votre propre système de gestion des clés afin de créer une clé de chiffrement enveloppée (la Customer Provided Root Key).
3. Téléversez votre clé de chiffrement enveloppée et sélectionnez **Save**.

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  Une fois téléversée, la clé de chiffrement enveloppée remplace l’Auth0 Environment Root Key dans le module matériel de sécurité (AWS ou Azure) en tant que Customer Provided Root Key.
</Callout>

<h2 id="cryptographic-material-requirements">
  Exigences relatives au matériel cryptographique
</h2>

Utilisez votre système de gestion de clés pour envelopper votre propre matériel cryptographique à l’aide de la clé d’enveloppement publique et créer la clé de chiffrement enveloppée. Utilisez les paramètres suivants pour l’algorithme [CKM\_RSA\_AES\_KEY\_WRAP](https://docs.oasis-open.org/pkcs11/pkcs11-curr/v2.40/cos01/pkcs11-curr-v2.40-cos01.html#_Toc408226894), selon votre fournisseur de services infonuagiques Auth0 (AWS ou Azure) :

<h3 id="auth0-on-aws-cloud">
  Auth0 on AWS cloud
</h3>

* Longueur de la clé d’enveloppement publique : 3072 bits
* Algorithme : CKG\_MGF1\_SHA256
* Longueur de la clé AES temporaire pour CKM\_AES\_KEY\_WRAP\_PAD : 256 bits
* Type de la clé racine fournie par le client : clé symétrique AES de 256 bits

<h3 id="auth0-on-azure-cloud">
  Auth0 on Azure
</h3>

* Longueur de la clé d’enveloppement publique : 2048 bits
* Algorithme : CKG\_MGF1\_SHA-1
* Longueur de la clé AES temporaire pour CKM\_AES\_KEY\_WRAP\_PAD : 256 bits
* Type de Customer Provided Root Key : clé privée RSA de 2048 bits
* Encodage de la clé privée : PKCS #8 - ASN.1 DER
