> ## 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.

> 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-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="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-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>

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-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="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-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>

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
