> For the complete documentation index, see [llms.txt](https://docs.scepman.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.scepman.com/es/administracion-de-certificados/api-certificates/self-service-enrollment/unmanaged-linux-client.md).
# Cliente Linux no administrado
{% hint style="info" %}
Aplicable a SCEPman versión 2.9 y posteriores
{% endhint %}
{% hint style="warning" %}
Solo en SCEPman Enterprise Edition
{% endhint %}
Este método puede utilizarse para inscribir certificados para usuarios y dispositivos que no están administrados o que están administrados por un MDM distinto de Intune.
## 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
{% content-ref url="/pages/31649805582853e94d36fcdf740fb0511d66a7d8" %}
[Inscripción de autoservicio](/es/administracion-de-certificados/api-certificates/self-service-enrollment.md)
{% endcontent-ref %}
### 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](https://docs.scepman.com/advanced-configuration/application-settings/dbcsr-validation#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](https://docs.scepman.com/advanced-configuration/application-settings/dbcsr-validation#appconfig-dbcsrvalidation-allowrenewals)
*Requerido para la renovación del certificado*
Establezca esta variable en ***true*** para habilitar las renovaciones de certificados.
#### [AppConfig:DbCSRValidation:ReenrollmentAllowedCertificateTypes](https://docs.scepman.com/advanced-configuration/application-settings/dbcsr-validation#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.***
## Módulo de PowerShell SCEPmanClient
### Solicitudes iniciales
Puede usar el módulo de PowerShell SCEPmanClient para solicitar certificados en su dispositivo Linux:
```powershell
New-SCEPmanCertificate -Url 'scepman.contoso.com' -SubjectFromUserContext -SaveToFolder '~/certs/'
```
El usuario deberá entonces iniciar sesión de forma interactiva en una sesión del navegador y se creará un certificado para su cuenta con la sesión iniciada.
### Renovación de certificados
También puede usar el módulo de PowerShell para renovar certificados ya existentes. Esto también evitará la necesidad de usar un Service Principal para la autenticación:
```powershell
$Parameters = @{
'CertificateFromFile' = '~/certs/john.doe@contoso.com.pem'
'KeyFromFile' = '~/certs/john.doe@contoso.com.key'
'SaveToFolder' = '~/certs/'
}
New-SCEPmanCertificate @Parameters
```
## Script de inscripción y renovación
Si el módulo de PowerShell no es una opción para usted, el [enrollrenewcertificate.sh](https://github.com/scepman/csr-request/blob/main/enroll-certificate/enrollrenewcertificate.sh) script puede utilizarse para obtener inicialmente un certificado, así como para verificarlo e intentar una renovación en caso de que esté a punto de caducar.
### **Requisitos previos 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**](https://learn.microsoft.com/en-us/cli/azure/install-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.
Ejemplo:
{% code overflow="wrap" %}
```bash
./enrollrenewcertificate.sh -u https://scepman.contoso.net/ api://b7d17d51-8b6d-45eb-b42b-3dae638cd5bc/Cert.Enroll ~/certs/ "myCertificate" "myKey" 30
```
{% endcode %}
#### 1. Comando
Define el comportamiento del script
Puede ser cualquiera de los siguientes:
**-u** para el certificado de usuario con detección automática de si es una inscripción inicial o una renovación
**-d** para el certificado del dispositivo con detección automática de si es una inscripción inicial o una renovación
**-r** para renovación
**-w** para la inscripción inicial de un usuario
**-x** para la inscripción inicial de un dispositivo
{% hint style="warning" %}
Si está inscribiendo o renovando un certificado de dispositivo, se intentará leer el DeviceId desde *\~/.config/intune/registration.toml* de forma predeterminada y el usuario autenticado deberá coincidir con el propietario del objeto en el [DeviceDirectory configurado](https://docs.scepman.com/advanced-configuration/application-settings/intune-validation#appconfig-intunevalidation-devicedirectory)
{% endhint %}
#### 2. URL del servicio de la aplicación
La URL del servicio de la aplicación SCEPman.
*Ejemplo: ""*
#### 3. 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*"*
#### 4. Directorio del certificado
El directorio en el que se creará el certificado o en el que se intentará renovarlo.
*Ejemplo: \~/certs/*
#### 5. Nombre de archivo del certificado
El nombre de archivo (sin extensión) del certificado que se creará o se leerá para su renovación.
*Ejemplo: "myCertificate"*
#### 6. Nombre de archivo de la clave privada
El nombre de archivo de la clave privada que se creará o se leerá para su renovación.
*Ejemplo: "myKey"*
#### 7. Umbral de renovación
La cantidad de días que faltan para que el certificado expire para que el script inicie el proceso de renovación.
*Ejemplo: 30*
### 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.
## Configurar renovación automática
Cuando se ejecuta el script bash anterior y detecta que ya se ha inscrito un certificado, renovará el certificado (si está cerca de caducar) usando mTLS. Si el script se ejecuta regularmente, esto garantizará que el certificado se renueve cuando esté cerca de caducar. Puede configurar un cronjob para lograr esto. El siguiente comando es un ejemplo de cómo podría hacerse. Configurará un cronjob para ejecutar el comando a diario (si el sistema está encendido) y un cronjob para ejecutar el comando al reiniciar.
Dado que los comandos ejecutados por Cron no necesariamente se ejecutarán desde el directorio en el que se encuentra el script/los certificados, es importante proporcionar las rutas absolutas al script/a los certificados.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.scepman.com/es/administracion-de-certificados/api-certificates/self-service-enrollment/unmanaged-linux-client.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
