Inscripción por API
Utilice esta API REST usando identidades de Microsoft para la autenticación para inscribir certificados como alternativa a los puntos de conexión SCEP que requieren la autenticación de estilo SCEP.
SCEPman cuenta con una API REST para inscribir certificados. Esta es una alternativa a los endpoints SCEP que requieren la autenticación al estilo SCEP, mientras que la API REST usa Microsoft Identities para la autenticación. El protocolo también es mucho más sencillo que SCEP.
Requisitos previos
1. Service Principal
Permisos de API
CSR.Request.Db
Asigna los permisos requeridos ejecutando el Register-SCEPmanApiClient cmdlet del módulo PowerShell de SCEPman.
Ejemplo:
Register-SCEPmanApiClient -ServicePrincipalId xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxServicePrincipalId
El ID de objeto del Aplicación empresarial del registro de aplicación que creamos en el paso anterior. Ten en cuenta que esto no se refiere a la aplicación empresarial normalmente llamada SCEPman-api, que identifica al propio SCEPman.
Para asignar manualmente este permiso, puedes navegar a Permisos de API y agregar un permiso de los permisos que usa tu organización. Asigna el CSR.Request.Db permiso de SCEPman-api como un permiso de aplicación.
Application.Read.All (Opcional)
Service Principals también requerirá el permiso de Graph Application.Read.All para permitir la recuperación automática del ámbito de la API de SCEPman para la autenticación.
El permiso se puede agregar manualmente así:

2. Configuración de App Service
Configuración
Requerido para la renovación del certificado
Configure el servicio de aplicaciones de SCEPman para aceptar certificados de cliente mTLS. En la blade de Configuración de la sección de Ajustes, verifique que el modo de certificado de cliente en Certificados de cliente entrantes esté configurado en Usuario interactivo opcional.

No establezca el modo de certificado de cliente en Requerir o Permitir, ya que eso rompería el funcionamiento normal de SCEPman en los puntos de conexión SCEP.
Variables de entorno
Para poder usar este escenario, debe establecer las siguientes Variables de entorno en el servicio de aplicaciones de SCEPman.
AppConfig:DbCSRValidation:Enabled
Requerido para el registro y la renovación de certificados
Establezca esta variable en true para habilitar la validación de las solicitudes de firma de certificados (CSR).
AppConfig:DbCSRValidation:AllowRenewals
Requerido para la renovación del certificado
Establezca esta variable en true para habilitar las renovaciones de certificados.
AppConfig:DbCSRValidation:ReenrollmentAllowedCertificateTypes
Requerido para la renovación del certificado
Establezca esta variable en una lista separada por comas de tipos de certificado que desea permitir renovar. Consulte la documentación enlazada de la variable para obtener una lista de los tipos de certificado posibles.
Ejemplo: Static,IntuneUser,IntuneDevice
Inscripción de certificados
Después de haber preparado los prerrequisitos, puede hacer POST de un PKCS#10/CMS a su SCEPman con la ruta HTTP api/csr. La respuesta HTTP será el certificado recién emitido en codificación DER.
SCEPman almacenará automáticamente todos los certificados emitidos en su Storage Account, para que pueda enumerarlos y revocarlos cómodamente mediante el componente Certificate Master.
Una forma cómoda de enviar esas solicitudes es nuestro módulo de PowerShell SCEPmanClient:
Otros ejemplos
Consulte nuestra Biblioteca de ejemplos de código abierto en GitHub para saber cómo usar la API REST de SCEPman.
Última actualización
¿Te fue útil?