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

Cliente Linux administrado por Intune

Aplicable a SCEPman versión 2.9 y posteriores

Este método puede utilizarse para inscribir certificados para usuarios y dispositivos administrados por Intune.

En este caso, Intune enviará un script para aprovechar la API REST de SCEPman, que a su vez inscribirá un nuevo certificado o renovará uno ya existente.

Nuestro desarrollador Christoph presentó esta característica y algunos detalles de contexto en el Workplace Ninja Usergroup Germany:

Requisitos previos

1. Inscripción de autoservicio

Para inscribir certificados, los usuarios deben estar autenticados para verificar su elegibilidad. Siga esta guía para obtener instrucciones paso a paso sobre cómo configurarlo

Inscripción de autoservicio

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

Este escenario inscribirá certificados del tipo IntuneUser y IntuneDevice según su elección.

3. Requisitos del cliente

Se deben cumplir los siguientes requisitos previos en el cliente/anfitrión de ejecución para poder usar la API REST de inscripción.

Azure CLI (versión 2.61 y superior)

La CLI de Azure se usa para autenticar al usuario que se inscribe, comprobar su elegibilidad y recuperar el token de acceso.

cURL

Se usa para enviar el CSR creado al punto de conexión de la API de inscripción de SCEPman y recibir el certificado.

OpenSSL

OpenSSL se usa para generar una clave privada y crear un CSR para inscribir o renovar un certificado.

Inscripción en Intune

Siga la documentación enlazada para inscribir su cliente Linux en Intune.

Script de inscripción y renovación

El enrollrenewcertificate.sh El script se utilizará para obtener inicialmente un certificado, así como para comprobarlo periódicamente e intentar su renovación en caso de que se alcance el umbral.

Aunque normalmente el script se ejecuta pasando los parámetros en la terminal, necesitaremos modificar algunas partes para desplegarlo mediante Intune.

Localice la parte del script que asigna los argumentos de terminal pasados a la variable y ajústela a sus necesidades:

Configuración de ejemplo:

APPSERVICE_URL

La URL del servicio de la aplicación SCEPman.

Ejemplo: "https://scepman.contoso.net/"

API_SCOPE

Este es el ámbito de API que puede crear en el SCEPman-api registro de aplicación en su entorno.

Al usuario se le mostrará el diálogo de consentimiento deseado y después podrá usar la funcionalidad de autoservicio.

Ejemplo: "api://b7d17d51-8b6d-45eb-b42b-3dae638cd5bc/Cert.Enroll"

CERT_DIR

El directorio en el que se creará el certificado o se intentará renovarlo. La clave privada y el certificado raíz también se colocarán aquí.

Ejemplo: ~/certs/

CERT_NAME

El nombre de archivo (sin extensión) del certificado que se creará o se leerá para su renovación.

Ejemplo: "myCertificate"

KEY_NAME

El nombre de archivo de la clave privada que se creará o se leerá para su renovación.

Ejemplo: "myKey"

RENEWAL_THRESHOLD_DAYS

La cantidad de días que faltan para que el certificado expire para que el script inicie el proceso de renovación.

Ejemplo: 30

CERT_TYPE

El tipo de certificado que se inscribirá.

Puede ser "user" o "device"

CERT_COMMAND

Esto define el comportamiento del script con respecto a la inscripción y la renovación:

"auto" creará un certificado inicialmente o renovará un certificado si ya existe y está a punto de expirar.

"renewal" renovará un certificado si está a punto de expirar, pero no creará un certificado inicialmente.

"initial" solo inscribirá un certificado, pero no renovará uno existente.

Consideraciones

  • Este script no cifra las claves generadas (esto requiere introducir una frase de contraseña, por lo que se ha omitido el cifrado para permitir la renovación automática).

  • Si está renovando certificados protegidos con frase de contraseña de Certificate Master, deberá introducir esta frase de contraseña para poder renovarlos.

Desplegar script

Usando Intune, podemos desplegar el script modificado según una programación para inscribir inicialmente un certificado con los parámetros dados y comprobar regularmente si necesita renovarse.

Agregue una nueva implementación de script de Linux y asegúrese de establecer el contexto de ejecución a Usuario y cargue o pegue el contenido del script bash modificado que creó en la sección anterior.

Ajuste la frecuencia de ejecución de acuerdo con su umbral de renovación.

Se pedirá al usuario que inicie sesión en la aplicación Azure CLI en la primera ejecución, ya que debe autenticarse.

Última actualización

¿Te fue útil?