Compartir a través de

Inicio rápido: Configuración de la firma de artefactos

"La Firma de Artefactos de Microsoft es un servicio de firma de certificados de extremo a extremo, totalmente gestionado." En este inicio rápido, creará los tres recursos de firma de artefactos siguientes para empezar a usar la firma de artefactos:

  • Una cuenta de firma digital de artefactos
  • Validación de identidades
  • El perfil de un certificado

Puede usar Azure Portal o una extensión de la CLI de Azure para crear y administrar la mayoría de los recursos de firma de artefactos. ( Puede completar la validación de identidades solo en Azure portal. No se puede completar la validación de identidad mediante la CLI de Azure). En este inicio rápido se muestra cómo hacerlo.

Prerrequisitos

Nota:

En el caso de los certificados de confianza pública, la firma de artefactos está disponible actualmente para las organizaciones de Estados Unidos, Canadá, la Unión Europea y el Reino Unido, así como para desarrolladores individuales de Estados Unidos y Canadá. Esta limitación no es aplicable a los certificados de confianza privada.

Para completar este inicio rápido necesita instalar:

Registro del proveedor de recursos de firma de artefactos

Antes de usar Firma de artefactos, debe registrar el proveedor de recursos de firma de artefactos.

Un proveedor de recursos es un servicio que proporciona recursos de Azure. Utilice el portal de Azure o la CLI de Azure para registrar el proveedor de recursos de firma de artefactos Microsoft.CodeSigning.

Para registrar un proveedor de recursos de firma de artefactos mediante Azure Portal:

  1. Inicie sesión en Azure Portal.

  2. En el cuadro de búsqueda o en Todos los servicios, seleccione Suscripciones.

  3. Seleccione la suscripción en la que desea crear recursos de firma de artefactos.

  4. En el menú de recursos de Configuración, seleccione Proveedores de recursos.

  5. En la lista de proveedores de recursos, seleccione Microsoft.CodeSigning.

    De forma predeterminada, el estado del proveedor de recursos es NotRegistered.

Captura de pantalla que muestra la creación de una cuenta para firma de artefacto.

  1. Seleccione los puntos suspensivos y, a continuación, seleccione Registrar.

    Captura de pantalla que muestra el proveedor de recursos Microsoft.CodeSigning como registrado.

    El estado del proveedor de recursos cambia a Registrado.

Creación de una cuenta de firma de artefactos

Una cuenta de firma de artefactos es un contenedor lógico que contiene recursos de validación de identidades y perfiles de certificado.

Regiones de Azure que admiten la firma de artefactos

Solo puede crear recursos de firma de artefactos en regiones de Azure en las que el servicio está actualmente disponible. En la tabla siguiente se enumeran las regiones de Azure que admiten actualmente recursos de firma de artefactos:

Región Campos de clase de región Valor del URI del punto de conexión
East US EastUS https://eus.codesigning.azure.net
West US WestUS https://wus.codesigning.azure.net
Centro-oeste de EE. UU. WestCentralUS https://wcus.codesigning.azure.net
Oeste de EE. UU. 2 Región Oeste de EE.UU 2 (WestUS2) https://wus2.codesigning.azure.net
Norte de Europa Norte de Europa https://neu.codesigning.azure.net
West Europe Oeste de Europa https://weu.codesigning.azure.net

Restricciones de nomenclatura para las cuentas de firma de artefactos

Los nombres de las cuentas para la firma de artefactos tienen algunas restricciones.

Un nombre de cuenta para la firma de artefactos debe:

  • Contienen de 3 a 24 caracteres alfanuméricos.
  • Ser único globalmente.
  • Comience con una letra.
  • Termine con una letra o un número.
  • No contienen guiones consecutivos.

El nombre de una cuenta de firma de artefactos es:

  • No distingue mayúsculas de minúsculas (ABC es igual que abc).
  • Rechazado por Azure Resource Manager si comienza por "uno".

Para crear una cuenta para la firma de artefactos mediante el portal de Azure:

  1. Inicie sesión en Azure Portal.

  2. Busque y seleccione Cuentas de firma de artefactos.

    Captura de pantalla que muestra cómo buscar cuentas de firma de artefactos en el portal de Azure.

  3. En el panel Cuentas de firma de artefactos, seleccione Crear.

  4. En Suscripción, seleccione su suscripción de Azure.

  5. Para Grupo de recursos, seleccione Crear nuevo, y a continuación, escriba un nombre de grupo de recursos.

  6. En Nombre de cuenta, escriba un nombre de cuenta único.

    Para obtener más información, consulte Restricciones de nomenclatura para las cuentas de firma de artefactos.

  7. En Región, seleccione una región de Azure que admita la firma de artefactos.

  8. Para Precios, seleccione un plan de tarifa.

  9. Seleccione el botón Revisar y Crear.

    Captura de pantalla que muestra la creación de una cuenta de firma de artefactos.

  10. Después de crear correctamente la cuenta de firma de artefactos, seleccione Ir al recurso.

Creación de una solicitud de validación de identidad

Puede completar su propia validación de identidad rellenando el formulario de solicitud con la información que debe incluirse en el certificado. La validación de identidad solo se puede completar en Azure Portal. No se puede completar la validación de identidad mediante la CLI de Azure.

Nota:

No se puede crear una solicitud de validación de identidad si no se le asigna el rol adecuado. Si el botón Nueva identidad de la barra de menús aparece atenuado en Azure Portal, asegúrese de que tiene asignado el rol Comprobador de identidad de firma de artefactos para continuar con la validación de identidad.

Para crear una solicitud de validación de identidad para una organización o un DBA:

  1. En el portal de Azure, vaya a su nueva cuenta de firma de artefactos.

  2. Confirme que tiene asignado el rol Verificador de identidad de firma de artefactos.

    Para obtener información sobre cómo administrar el acceso mediante el control de acceso basado en rol (RBAC), consulte Tutorial: Asignación de roles en la firma de artefactos.

  3. En el panel Información general de la cuenta de firma de artefactos o en el menú de recursos de Objetos, seleccione Validaciones de identidad.

  4. Seleccione Nueva identidad y, después, seleccione Público o Privado.

    • La validación de identidad pública solo se aplica a estos tipos de perfil de certificado: Confianza pública, prueba de confianza pública, enclave de VBS.
    • La validación de identidad privada solo se aplica a estos tipos de perfiles de certificados: Confianza Privada, Política de CI de Confianza Privada.

  5. En Nueva validación de identidad, proporcione la siguiente información:

    Fields Detalles
    Nombre de la organización Para la validación de identidad pública, proporcione la entidad empresarial legal a la que se emite el certificado. Para la validación de identidad privada, el valor predeterminado es el nombre del inquilino de Microsoft Entra.
    (Solo para el tipo de identidad privada) Unidad organizativa Escriba la información pertinente.
    url del sitio web Ingrese al sitio web que pertenece a la entidad comercial legal.
    Correo electrónico principal Escriba la dirección de correo electrónico de una persona (no se aceptan listas de distribución) asociadas a la entidad empresarial legal que está realizando la validación. Como parte del proceso de validación de identidad, se envía un vínculo de verificación a esta dirección de correo electrónico y el vínculo expira en siete días. Asegúrese de que la dirección de correo electrónico puede recibir correos electrónicos (con vínculos) desde direcciones de correo electrónico externas.
    Correo electrónico secundario Esta dirección de correo electrónico debe ser diferente de la dirección de correo electrónico principal (se aceptan listas de distribución). En el caso de las organizaciones, el dominio debe coincidir con la dirección de correo electrónico proporcionada en la dirección de correo electrónico principal. Asegúrese de que la dirección de correo electrónico puede recibir correos electrónicos de direcciones de correo electrónico externas que tienen vínculos.
    Identificador de negocio Escriba un identificador de negocio para la entidad empresarial legal.
    Identificador de vendedor Solo se aplica a los clientes de Microsoft Store. Busque su ID de vendedor en el portal del Centro de Partners.
    Calle, Ciudad, País/Región, Estado/Provincia, Código Postal Escriba la dirección comercial de la entidad empresarial legal.
    Nombre Escriba el nombre de la persona que representa a la organización que realizará la validación de identidad individual. Use el nombre exacto tal como aparece en el documento de identificación emitido por el gobierno para el proceso de validación de identidades.
    Apellido Escriba el apellido de la persona que representa la organización. Este individuo realiza la validación de identidad individual. Use el nombre exacto tal como aparece en el documento de identificación emitido por el gobierno para el proceso de validación de identidades.

  6. Seleccione Vista previa del firmante del certificado para ver la vista previa de la información que aparece en el certificado.

  7. Seleccione el botón Crear.

  8. Cuando la solicitud se crea correctamente, el estado de la solicitud de validación de identidad cambia a En curso.

  9. Cuando el estado cambie a Acción requerida, siga las instrucciones del paso 9 en adelante en la pestaña Validación de identidad: desarrollador individual anterior.

  10. El vínculo para la validación de identidad individual también se envía por correo electrónico a la dirección de correo electrónico principal.

  11. Una vez completada correctamente la validación de identidad individual, el estado cambia de nuevo a En curso y el proceso de validación continúa.

  12. Si se requieren más documentos, se envía un correo electrónico y el estado de la solicitud cambia a Acción requerida.

  13. Cuando finalice el proceso de validación de identidad, el estado de la solicitud cambia y se envía un correo electrónico con el estado actualizado de la solicitud:

    • Completado si el proceso se ha completado correctamente.
    • Error si el proceso no se ha completado correctamente.

    Captura de pantalla que muestra la opción Público en el panel Nueva validación de identidad.

    Captura de pantalla que muestra la opción Privado en el panel Nueva validación de identidad.

Información importante para la validación de identidades públicas

Requisitos Detalles
Incorporación La firma de artefactos en este momento solo puede incorporar entidades empresariales legales que tengan un historial fiscal verificable de tres o más años. Para un proceso de incorporación más rápido, asegúrese de que los registros públicos de la entidad empresarial legal que está validado están actualizados.
Precisión Asegúrese de proporcionar la información correcta para la validación de identidad pública. Si necesita realizar cambios después de crearlo, debe completar una nueva solicitud de validación de identidad. Este cambio afecta a los certificados asociados que se usan para firmar.
Verificación de correo electrónico fallida Si se produce un error en la comprobación del correo electrónico, debe iniciar una nueva solicitud de validación de identidad.
Estado de validación de identidad Recibirá una notificación por correo electrónico cuando haya una actualización del estado de validación de identidad. También puede comprobar el estado en Azure Portal en cualquier momento.
Tiempo de procesamiento El procesamiento de la solicitud de validación de identidad tarda de 1 a 7 días laborables (posiblemente más largo si necesitamos solicitar más documentación de usted).
Más documentación Si necesitamos más documentación para procesar la solicitud de validación de identidad, se le notificará por correo electrónico. Puede cargar los documentos en Azure Portal. Para la carga de documentación, hay tres intentos. El correo electrónico de solicitud de documentación contiene información sobre los requisitos de tamaño de archivo. Asegúrese de que los documentos que proporcione sean los más actuales.
- Todos los documentos enviados deben emitirse dentro de los 12 meses anteriores y donde la fecha de expiración es una fecha futura que es al menos dos meses de distancia.
- Si no es posible proporcionar documentación adicional, actualice la información de su cuenta para que coincida con los documentos legales ya proporcionados o sus detalles oficiales de registro de la Empresa.
- Al proporcionar un documento comercial oficial, como el formulario de registro comercial, la carta comercial o los artículos de incorporación que enumeran el nombre y la dirección de la empresa tal como se proporciona en el momento de la creación de la solicitud de validación de identidad.
- Asegúrese de que el registro del dominio o la factura de dominio del registro o de la renovación muestre la entidad, el nombre de contacto y todos los dominios que se incluyen o mencionan en la solicitud.

Creación de un perfil de certificado

Un recurso de perfil de certificado es el contenedor lógico de los certificados que se le emiten para firmar.

Restricciones de nomenclatura para perfiles de certificado

Los nombres de perfil de certificado tienen algunas restricciones.

Un nombre de perfil de certificado debe:

  • Contienen de 5 a 100 caracteres alfanuméricos.
  • Comience con una letra, termine con una letra o un número y no contenga guiones consecutivos.
  • Ser único dentro de la cuenta.

Un nombre de perfil de certificado es:

  • En la misma región de Azure que la cuenta, de forma predeterminada, la herencia.
  • No distingue mayúsculas de minúsculas (ABC es igual que abc).

Para crear un perfil de certificado en Azure Portal:

  1. En el portal de Azure, vaya a su nueva cuenta de firma de artefactos.

  2. En el panel Información general de la cuenta de firma de artefactos o en el menú de recursos de Objetos, seleccione Perfiles de certificado.

  3. En la barra de comandos, seleccione Crear y seleccione un tipo de perfil de certificado.

    Captura de pantalla en la que se muestran los tipos de perfil de certificado de firma de artefactos entre los que elegir.

  4. En Crear perfil de certificado, proporcione la siguiente información:

    a) En Nombre del perfil de certificado, escriba un nombre único.

    Para obtener más información, vea Restricciones de nomenclatura para perfiles de certificado.

    El valor de Tipo de certificado se rellena automáticamente en función del tipo de perfil de certificado seleccionado.

    b. Para CN y O comprobados, seleccione una validación de identidad que se debe mostrar en el certificado.

    • Si la dirección postal debe mostrarse en el certificado, active la casilla Incluir dirección postal.

    • Si el código postal debe mostrarse en el certificado, active la casilla Incluir código postal.

      Los valores de los campos restantes se rellenan automáticamente en función de la selección de CN y O comprobados.

      La Previsualización del Sujeto del Certificado generada muestra la previsualización del certificado que se emitirá.

  5. Selecciona Crear.

    Captura de pantalla que muestra el panel Crear perfil de certificado.

Limpieza de recursos

Para eliminar los recursos de firma de artefactos mediante el portal de Azure:

Eliminación de un perfil de certificado

  1. En el portal de Azure, vaya a su cuenta de Firma de Artefactos.
  2. En el panel Información general de la cuenta de firma de artefactos o en el menú de recursos de Objetos, seleccione Perfiles de certificado.
  3. En Perfiles de certificado, seleccione el perfil de certificado que desea eliminar.
  4. En la barra de comandos, seleccione Eliminar.

Nota:

Esta acción detiene cualquier firma asociada al perfil de certificado.

Eliminación de una cuenta de firma de artefactos

  1. Inicie sesión en Azure Portal.
  2. En el cuadro de búsqueda, escriba y luego seleccione Cuentas de firma de artefactos.
  3. En Cuentas de firma de artefactos, seleccione la cuenta de firma de artefactos que desea eliminar.
  4. En la barra de comandos, seleccione Eliminar.

Nota:

Esta acción quita todos los perfiles de certificado que están vinculados a esta cuenta. Los procesos de firma asociados a los perfiles de certificado se detienen.

Contenido relacionado

En esta guía de inicio rápido, creaste una cuenta de Firma de Artefactos, la solicitud de validación de identidad y un perfil de certificado. Para obtener más información sobre la firma de artefactos y para iniciar el proceso de firma, consulte estos artículos:

  • Last updated on