Créer un modèle de certificat
Cette page décrit les attributs d'un modèle de certificat et explique comment en créer un. Pour en savoir plus sur les modèles de certificat, consultez la section À propos des modèles de certificat.
Rôles requis
Pour obtenir les autorisations nécessaires pour créer un modèle de certificat, demandez à votre administrateur de vous attribuer le rôle IAM Gestionnaire des opérations de service de l'autorité de certification (roles/privateca.caManager
) sur le projet, le dossier ou l'organisation.
Pour en savoir plus sur l'attribution de rôles, consultez la page Gérer l'accès aux projets, aux dossiers et aux organisations.
Vous pouvez également obtenir les autorisations requises via des rôles personnalisés ou d'autres rôles prédéfinis.
Créer un modèle de certificat
Pour créer un modèle de certificat, utilisez l'une des méthodes suivantes:
Console
Accédez à la page Certificate Authority Service (Service d'autorité de certification) dans la console Google Cloud.
Cliquez sur l'onglet Gestionnaire de modèles, puis sur Créer un modèle.
Sélectionnez un emplacement pour le modèle de certificat à l'aide de la liste Région. Il doit s'agir du même emplacement que le pool d'autorités de certification que vous prévoyez d'utiliser avec le modèle de certificat.
Saisissez un identifiant unique pour le modèle de certificat dans le champ ID du modèle de certificat. Si vous le souhaitez, fournissez une description du modèle de certificat.
Cliquez sur Suivant.
Si vous souhaitez configurer des valeurs X.509 par défaut pour les certificats qui utilisent ce modèle, cliquez sur l'option Inclure les valeurs prédéfinies dans les certificats émis à l'aide de ce modèle de certificat. Cliquez ensuite sur Configurer des valeurs prédéfinies.
Configurez les valeurs prédéfinies à l'aide des informations suivantes:
Définir l'utilisation de base de la clé
Ce paramètre fait référence au champ
Key Usage
d'un certificat numérique. Il spécifie comment la clé privée du certificat peut être utilisée, par exemple pour le chiffrement de clé, le chiffrement de données, la signature de certificats et la signature de listes de révocation de certificats. Pour en savoir plus, consultez la section Utilisation des clés.- Pour sélectionner les utilisations de base des clés, cliquez sur le bouton bascule Spécifier l'utilisation de base des clés pour les certificats émis à partir de ce pool d'autorités de certification, puis sélectionnez l'une des options affichées.
- Cliquez sur Suivant.
Définir l'utilisation étendue de la clé
Ce paramètre fait référence au champ
Extended Key Usage (EKU)
d'un certificat numérique. Il fournit des restrictions plus spécifiques et plus précises sur l'utilisation de la clé, par exemple pour l'authentification du serveur, l'authentification du client, la signature de code, la protection des e-mails, etc. Pour en savoir plus, consultez la section Extended key usage.Les utilisations étendues des clés sont définies à l'aide d'identifiants d'objet (OID). Si vous ne configurez pas les utilisations étendues des clés, tous les scénarios d'utilisation des clés sont autorisés.
- Pour sélectionner les utilisations étendues des clés, cliquez sur le bouton bascule Écrire les utilisations étendues des clés pour les certificats émis à partir de ce pool d'autorités de certification, puis sélectionnez l'une des options affichées.
- Cliquez sur Suivant.
Définir des identifiants de règles
L'extension des règles de certificat du certificat indique les règles suivies par le pool d'autorités de certification émettrices. Cette extension peut inclure des informations sur la façon dont les identités sont validées avant l'émission de certificats, la révocation des certificats et l'intégrité du pool d'autorités de certification. Cette extension vous aide à vérifier les certificats émis par le pool d'autorités de certification et à voir comment ils sont utilisés.
Pour en savoir plus, consultez la section Règles concernant les certificats.
Pour spécifier la règle qui définit l'utilisation du certificat, procédez comme suit:
- Facultatif: ajoutez l'identifiant de la règle dans le champ Identifiants de règle.
- Cliquez sur Suivant.
Ajouter des serveurs OCSP AIA (Authority Information Access)
L'extension AIA d'un certificat fournit les informations suivantes:
- Adresse des serveurs OCSP à partir desquels vous pouvez vérifier l'état de révocation du certificat.
- Méthode d'accès de l'émetteur du certificat.
Pour en savoir plus, consultez la section Accès aux informations sur les autorités.
L'ajout de serveurs OCSP est facultatif. Pour ajouter les serveurs OCSP qui apparaissent dans le champ d'extension AIA des certificats, procédez comme suit:
- Cliquez sur Ajouter un élément.
- Dans le champ Server URL (URL du serveur), ajoutez l'URL du serveur OCSP.
- Cliquez sur OK.
- Cliquez sur Suivant.
Options de l'autorité de certification
Le champ Options d'autorité de certification d'un modèle de certificat définit comment le certificat obtenu peut être utilisé dans une hiérarchie d'autorité de certification (AC). Il détermine essentiellement si un certificat peut être utilisé pour signer d'autres certificats et, le cas échéant, les restrictions applicables aux certificats qu'il émet.
parmi les options suivantes :
Incluez les configurations pour décrire les extensions X.509 de l'autorité de certification: spécifiez les paramètres d'un modèle de certificat qui contrôlent les extensions X.509.
Limiter l'utilisation des certificats émis aux autorités de certification: cette option ne s'affiche que si vous cochez la case mentionnée à l'étape précédente. Cette valeur booléenne indique si le certificat est un certificat d'autorité de certification. Si la valeur est
true
, le certificat peut être utilisé pour signer d'autres certificats. Si la valeur estfalse
, il s'agit d'un certificat d'entité de fin et il ne peut pas signer d'autres certificats. Si vous cliquez sur ce bouton, vous êtes invité à définir des contraintes de nom pour l'extension dans les certificats CA.Incluez les configurations pour décrire les extensions X.509 de restriction de longueur de chemin : spécifiez les paramètres qui contrôlent la longueur d'une chaîne de certificats, provenant d'un certificat particulier.Il spécifie le nombre maximal d'autorités de certification pouvant être associées à ce certificat d'autorité de certification. Si la longueur maximale du chemin d'accès de l'émetteur est définie sur
0
, l'autorité de certification ne peut émettre que des certificats d'entité de fin. Si la valeur est1
, la chaîne sous ce certificat CA ne peut inclure qu'une seule autorité de certification subordonnée. Si aucune valeur n'est déclarée, le nombre d'autorités de certification subordonnées dans la chaîne sous cette autorité de certification est illimité.- Cliquez sur Suivant.
Configurer des extensions supplémentaires
Facultatif: vous pouvez configurer des extensions personnalisées supplémentaires à inclure dans les certificats émis par le pool d'autorités de certification. Procédez comme suit :
- Cliquez sur Ajouter un élément.
- Dans le champ Identifiant de l'objet, ajoutez un identifiant d'objet valide au format numérique séparé par des points.
- Dans le champ Valeur, ajoutez la valeur de l'identifiant encodée en base64.
- Si l'extension est essentielle, sélectionnez Extension is critical (L'extension est essentielle).
Pour enregistrer toutes les valeurs prédéfinies, cliquez sur OK.
Accédez ensuite à la section Configurer les contraintes d'extension. Sélectionnez l'une des options suivantes:
- Copier toutes les extensions des demandes de certificat dans le certificat
- Supprimer toutes les extensions des demandes de certificat
- Copier des extensions spécifiques des demandes de certificat dans le certificat
- Si vous choisissez de copier des extensions spécifiques, vous pouvez procéder comme suit:
- Cliquez sur le champ Extensions de certificat connues, puis supprimez les extensions non requises de la liste.
- Dans le champ Extensions personnalisées, ajoutez les identifiants d'objet des extensions que vous souhaitez inclure dans les certificats émis par le pool d'autorités de certification.
Cliquez sur Suivant, puis accédez à la section Configurer les contraintes d'identité. Pour configurer des contraintes sur l'objet et les SAN dans les certificats émis par le pool d'autorités de certification, sélectionnez l'une ou les deux options suivantes:
- Copier l'objet des demandes de certificat dans le certificat
- Copier les autres noms d'objet (SAN) des demandes de certificat dans le certificat
Cliquez sur Suivant, puis sur OK.
gcloud
gcloud privateca templates create TEMPLATE_ID \
--copy-subject \
--copy-sans \
--identity-cel-expression <expr> \
--predefined-values-file FILE_PATH \
--copy-all-requested-extensions \
--copy-extensions-by-oid <1.2.3.4,5.6.7.8> \
--copy-known-extensions <ext1,ext2>
Remplacez les éléments suivants :
- TEMPLATE_ID: identifiant unique du modèle de certificat.
- FILE_PATH: fichier YAML qui décrit les valeurs X.509 définies par le modèle de certificat.
L'indicateur --copy-sans
permet de copier l'extension de nom d'objet de remplacement (SAN) de la demande de certificat dans le certificat signé. Vous pouvez également spécifier --no-copy-sans
pour supprimer de la demande de certificat tous les SAN spécifiés par l'appelant.
L'indicateur --copy-subject
permet de copier l'objet de la demande de certificat dans le certificat signé. Vous pouvez également spécifier --no-copy-subject
pour supprimer les sujets spécifiés par l'appelant de la demande de certificat.
L'indicateur --identity-cel-expression
utilise une expression CEL qui est évaluée par rapport à l'objet et à l'autre nom de l'objet du certificat avant son émission, et renvoie une valeur booléenne indiquant si la requête doit être autorisée. Pour savoir comment utiliser une expression en langage CEL (Common Expression Language) pour un modèle de certificat, consultez Utiliser le langage CEL pour les modèles de certificats.
L'indicateur --predefined-values-file
spécifie le chemin d'accès à un fichier YAML décrivant les valeurs X.509 prédéfinies définies par ce modèle. Les extensions fournies sont copiées dans toutes les demandes de certificat qui utilisent ce modèle et ont la priorité sur les extensions autorisées dans la demande de certificat. Si vous modifiez une partie des valeurs X.509 prédéfinies, la mise à jour remplace l'ensemble des valeurs X.509 prédéfinies.
Si l'indicateur --copy-all-requested-extensions
est défini, toutes les extensions spécifiées dans la demande de certificat sont copiées dans le certificat signé.
Si l'indicateur --copy-extensions-by-oid
est défini, des OID spécifiques sont copiés à partir de la demande de certificat dans le certificat signé.
Si l'indicateur --copy-known-extensions
est défini, des extensions spécifiques sont copiées de la demande de certificat dans le certificat signé. Ces extensions connues peuvent être les suivantes: base-key-usage
, extended-key-usage
, ca-options
, policy-ids
ou aia-ocsp-servers
.
Supprimez l'indicateur --copy-all-requested-extensions
pour ignorer toutes les extensions X.509 dans la demande de certificat, tout en conservant les valeurs prédéfinies définies dans ce modèle.
Voici un exemple de configuration de modèle de certificat:
keyUsage:
baseKeyUsage:
digitalSignature: true
keyEncipherment: true
contentCommitment: false
dataEncipherment: false
keyAgreement: false
certSign: false
crlSign: false
encipherOnly: false
decipherOnly: false
extendedKeyUsage:
serverAuth: true
clientAuth: false
codeSigning: false
emailProtection: false
timeStamping: false
ocspSigning: false
caOptions:
isCa: true
maxIssuerPathLength: 1
policyIds:
- objectIdPath:
- 1
- 2
- 3
additionalExtensions:
- objectId:
objectIdPath:
- 1
- 2
- 3
critical: false
value: "base64 encoded extension value"
Les valeurs qui ne sont pas spécifiées dans le fichier YAML sont omises ou remplacées par la valeur par défaut false
.
Les extensions suivantes sont omises si aucune valeur n'est spécifiée:
keyUsage
policyIds
additionalExtensions
- Champ
maxIssuerPathLength
de l'extensioncaOptions
Les extensions suivantes sont définies par défaut sur false
si aucune valeur n'est spécifiée:
- Champ
isCa
dans l'extensioncaOptions
Créer un modèle de certificat pour des scénarios courants
Cette section fournit des commandes gcloud
pour créer un modèle de certificat pour des cas d'utilisation courants.
Certificats TLS du serveur DNS pour n'importe quel domaine
Pour créer un modèle de certificat permettant d'émettre des certificats TLS de serveur autorisant n'importe quel domaine, suivez les instructions ci-dessous:
Créez un fichier nommé
leaf_server_tls_values.yaml
et ajoutez-y la configuration TLS du serveur d'entité finale suivante:leaf_server_tls_values.yaml
keyUsage: baseKeyUsage: digitalSignature: true keyEncipherment: true extendedKeyUsage: serverAuth: true caOptions: isCa: false
Pour n'autoriser que les certificats avec des SAN de type
DNS
, exécutez la commandegcloud
suivante:gcloud
gcloud privateca templates create server-tls \ --predefined-values-file leaf_server_tls_values.yaml \ --copy-sans --no-copy-subject \ --identity-cel-expression "subject_alt_names.all(san, san.type == DNS)"
Pour en savoir plus sur la commande
gcloud privateca templates create
, consultez gcloud privateca templates create.
Certificats TLS du serveur DNS avec des domaines de test uniquement
Pour créer un modèle de certificat permettant d'émettre des certificats TLS de serveur avec des SAN DNS limités aux domaines de test, exécutez la commande gcloud
suivante:
gcloud
gcloud privateca templates create server-tls \
--predefined-values-file leaf_server_tls_values.yaml \
--copy-sans --no-copy-subject \
--identity-cel-expression "subject_alt_names.all(san, san.type == DNS && san.value.endsWith('.test.example.com'))"
Le contenu du fichier leaf_server_tls_values.yaml
doit être identique à celui de l'exemple précédent.
Pour en savoir plus sur l'utilisation d'expressions CEL pour vous assurer que les noms DNS commencent ou se terminent par une chaîne spécifique, consultez Exemples d'expressions CEL.
Certificats d'identité de charge de travail
Pour créer un modèle de certificat permettant d'émettre des certificats TLS mutuels (mTLS), procédez comme suit:
Créez un fichier nommé
leaf_mtls_values.yaml
et ajoutez-y la configuration TLS mutuelle d'entité finale suivante.leaf_mtls_values.yaml
keyUsage: baseKeyUsage: digitalSignature: true keyEncipherment: true extendedKeyUsage: serverAuth: true clientAuth: true caOptions: isCa: false
Pour n'autoriser que les certificats avec des SAN URI SPIFFE, exécutez la commande
gcloud
suivante:gcloud
gcloud privateca templates create workload-spiffe \ --predefined-values-file leaf_mtls_values.yaml \ --copy-sans --no-copy-subject \ --identity-cel-expression "subject_alt_names.all(san, san.type == URI && san.value.startsWith('spiffe://'))"
Pour en savoir plus sur la commande
gcloud privateca templates create
, consultez gcloud privateca templates create.
Pour en savoir plus sur l'utilisation d'expressions CEL pour vous assurer que les noms DNS commencent ou se terminent par une chaîne spécifique, consultez Exemples d'expressions CEL.
Accorder l'accès au modèle de certificat
Vous pouvez utiliser un modèle de certificat si vous disposez du rôle Utilisateur du modèle de certificat du service CA (roles/privateca.templateUser
). Nous recommandons aux auteurs d'un modèle de certificat d'accorder le rôle "Utilisateur du modèle de certificat de service CA" aux membres de l'organisation susceptibles d'utiliser ce modèle de certificat.
Pour attribuer le rôle "Utilisateur du modèle de certificat du service CA" (roles/privateca.templateUser
) à tous les membres du domaine example.com
, utilisez la commande gcloud
suivante:
gcloud
gcloud privateca templates add-iam-policy-binding TEMPLATE_ID \
--member "domain:example.com" \
--role "roles/privateca.templateUser"
Remplacez les éléments suivants :
- TEMPLATE_ID: identifiant unique du modèle de certificat.
Pour en savoir plus sur la commande gcloud privateca templates add-iam-policy-binding
, consultez gcloud privateca templates add-iam-policy-binding.
Pour en savoir plus sur les rôles IAM pour le service CA et les autorisations associées, consultez la page Contrôle des accès avec IAM.
Étape suivante
- En savoir plus sur le Common Expression Language
- Découvrez comment utiliser Common Expression Language.
- En savoir plus sur les profils de certificats