Cómo solicitar un certificado con una plantilla de certificado
En esta página, se describe cómo solicitar un certificado mediante una plantilla de certificado.
Las plantillas de certificado te permiten implementar controles de políticas detallados en la emisión de certificados. Por ejemplo, puedes usar plantillas de certificados para estandarizar la emisión de certificados TLS del servidor en los grupos de AC de tu organización. También puedes usar plantillas de certificados para aplicar políticas a un nivel más detallado, como para usuarios específicos. Esto es útil en situaciones en las que necesitas restringir los tipos de certificados que pueden emitir diferentes personas. También puedes reutilizar las plantillas para situaciones de emisión comunes.
Antes de comenzar
Si quieres obtener los permisos que necesitas para emitir certificados mediante una plantilla de certificado, pídele a tu administrador que te otorgue la función de IAM Usuario de la plantilla de certificado del servicio de CA (
roles/privateca.templateUser
) en la plantilla del certificado.Si deseas obtener más información sobre las funciones predefinidas de IAM para el servicio de CA, consulta Control de acceso con IAM.
Para obtener información sobre cómo otorgar un rol de IAM a una principal, consulta Otorga un solo rol.
Probar la emisión de certificados
Antes de usar una plantilla de certificado para solicitar un certificado firmado, te recomendamos que verifiques la capacidad de esta plantilla para generar un certificado de forma correcta. La emisión del certificado falla cuando hay un conflicto entre las políticas de emisión del grupo de AC y las políticas de la plantilla de certificado. Mediante la prueba de la emisión, puedes identificar y resolver estos conflictos de forma proactiva. Ten en cuenta que los certificados de prueba no tienen codificación PEM, no están firmados y no generan cargos de generación.
Para probar la emisión de certificados con una plantilla de certificado, sigue estos pasos:
Console
Ve a la página Certificate Authority Service en la consola de Google Cloud.
Haz clic en la pestaña Administrador de plantillas.
Haz clic en la plantilla del certificado que quieres probar. Aparecerá la página Detalles de la plantilla.
Para crear una solicitud de prueba, haz clic en Crear certificado y, luego, en Probar emisión de certificados. Aparecerá el formulario de solicitud de certificado.
Especifica los siguientes detalles que se requieren para crear una solicitud de certificado:
- Región: Es la ubicación del certificado. Debe ser la misma que la ubicación del grupo de AC.
- Grupo de AC: El grupo de AC responsable de emitir el certificado.
- Plantilla de certificado: Es la plantilla que deseas usar para la emisión del certificado.
- Dominio: Es el nombre de dominio del sitio que deseas proteger con un certificado SSL o TLS.
Haz clic en Generar certificado.
Después de crear el certificado, haz clic en Ver. El certificado de prueba o muestra se muestra en la misma página en un panel separado.
Si la emisión del certificado falla debido a conflictos, resuelve los conflictos y vuelve a enviar la solicitud de certificado de prueba.
Emite certificados con una plantilla de certificado
Para emitir un certificado firmado con una plantilla de certificado, haz lo siguiente:
Console
Ve a la página Certificate Authority Service en la consola de Google Cloud.
Haz clic en la pestaña Administrador de plantillas.
En la página Plantillas de certificados, haz clic en la plantilla de certificado que deseas utilizar. Aparecerá la página Detalles de la plantilla.
Haga clic en Crear certificado.
Selecciona una región. Esta región debe ser la misma que la del grupo de AC que quieres usar.
Selecciona el grupo de AC.
Para generar un certificado con una solicitud de firma de certificado (CSR), consulta Cómo solicitar un certificado con CSR.
Para generar un certificado con una clave generada de forma automática, consulta Cómo solicitar un certificado con una clave generada de forma automática.
Genera el certificado
- Haz clic en Generar certificado. Si el certificado se genera correctamente, aparecerá un mensaje.
- Para ver el certificado generado, haz clic en Ver certificado y, luego, en Ver.
Opcional: Descarga el certificado firmado
- Para descargar la cadena de certificados con codificación PEM, haz clic en Descargar cadena de certificados.
- Para descargar la clave privada con codificación PEM asociada, haz clic en Descargar clave privada.
gcloud
Para emitir un certificado con una plantilla de certificado, agrega la marca --template
al comando gcloud privateca certificates create
en el siguiente formato:
--template=projects/PROJECT_ID/locations/LOCATION/certificateTemplates/CERTIFICATE_TEMPLATE
Reemplaza CERTIFICATE_TEMPLATE por el nombre de la plantilla de certificado que deseas usar para emitir este certificado. La plantilla especificada debe estar en la misma ubicación que el grupo de AC emisora. Consulta las muestras proporcionadas para generar certificados DNS de prueba y generar certificados de producción para obtener más información.
Terraform
Si deseas obtener más información para aplicar o quitar una configuración de Terraform, consulta los comandos básicos de Terraform.
Comparte el vínculo de una solicitud de certificado
Para compartir un vínculo a un formulario de solicitud de certificado con otras personas de tu organización para que puedan solicitar un certificado con los mismos parámetros, haz lo siguiente:
Console
- En la consola de Google Cloud, ve a la pestaña Administrador de grupos de CA y haz clic en Compartir vínculo del formulario de solicitud.
- En el panel Vínculo del formulario de solicitud para compartir que aparece, selecciona el grupo de AC y la plantilla de certificado que elegiste para crear tu solicitud. Se mostrará el vínculo de solicitud de certificado.
- Copia el vínculo y compártelo según sea necesario.
Cómo resolver conflictos de políticas
Las solicitudes de certificados fallan con un error de argumento no válido cuando hay un conflicto entre la política de emisión del grupo de la AC y la plantilla de certificado. Por ejemplo, si la misma extensión (como el uso de la clave base) se define en los valores de referencia del grupo de AC y los valores predefinidos de la plantilla de certificado. O bien, cuando una política tiene restricciones de extensión que excluyen una extensión específica y la otra define un valor para esa extensión en los valores de referencia.
Para ver y resolver los conflictos de políticas, sigue estos pasos:
Console
- Haz clic en el vínculo Solucionador de problemas de políticas de emisión que se muestra con el mensaje de error. Aparecerá una página de solucionador de problemas, en la que puedes comparar los valores del modelo de referencia y las restricciones de extensión en la política de emisión del grupo de AC con los valores del modelo de referencia y las restricciones de extensión en la política de la plantilla de certificado. Observa que los conflictos de políticas aparecen destacados.
- Accede al grupo de AC o a la plantilla del certificado para actualizar los valores en conflicto y resolver el conflicto.
- Una vez resuelto el conflicto, vuelve a enviar la solicitud de certificado.
Cómo ver los certificados emitidos con una plantilla
Para ver los certificados emitidos con una plantilla de certificado, haz lo siguiente:
Console
- En la consola de Google Cloud, ve a la pestaña Administrador de plantillas.
- Haz clic en la plantilla del certificado que usaste para la emisión del certificado.
- En la página Detalles de la plantilla, haz clic en Certificados. Se mostrará la lista de certificados emitidos con la plantilla de certificado seleccionada.
¿Qué sigue?
- Obtén más información para ver los certificados emitidos.