For the complete documentation index, see llms.txt. This page is also available as Markdown.

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.

Esta funcionalidad requiere la versión 2.3.689 o superior.

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

1

Registro de aplicación

Crear un nuevo Registro de aplicación que describa tu caso de uso. Tu aplicación se autenticará como esta aplicación frente a SCEPman.

2

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-xxxxxxxxxxxx

ServicePrincipalId

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í:

3

Secreto de cliente

Crea un secreto de cliente en "Certificates & Secrets." El secreto de cliente se utilizará como contraseña para autenticar la aplicación más adelante.

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:

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?