> 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/api-enrollment/linux-server.md).

# Servidor Linux

{% hint style="info" %}
Esta característica requiere la versión **2.3.689** o una posterior.
{% endhint %}

{% hint style="warning" %}
Solo SCEPman Enterprise Edition
{% endhint %}

Mientras que los demás casos de uso de SCEPman permiten autenticar a un usuario de forma interactiva para que solo pueda inscribir certificados de usuario para su cuenta o sus dispositivos, es posible que quieras inscribir certificados para sujetos arbitrarios sin interacción.

Para ello, podemos autenticar un Service Principal y permitirle usar la API REST de inscripción de SCEPman.

## Requisitos previos

Consulta el artículo sobre la inscripción mediante API para saber cómo crear un Service Principal que se pueda usar para la autenticación:

{% content-ref url="/pages/b31d8f3786b22311eafcf73ce7738f65815607e8" %}
[Inscripción por API](https://docs.scepman.com/es/administracion-de-certificados/api-certificates/api-enrollment.md)
{% endcontent-ref %}

## Módulo de PowerShell SCEPmanClient

### Solicitudes iniciales

Puedes usar el módulo de PowerShell SCEPmanClient para solicitar certificados en tu servidor Linux:

```powershell
$Parameters = @{
    'Url'              = 'scepman.contoso.com'
    'ClientId'         = '569fbf51-aa63-4b5c-8b26-ebbcfcde2715'
    'TenantId'         = '8aa3123d-e76c-42e2-ba3c-190cabbec531'
    'ClientSecret'     = 'csa8Q~aVaWCLZTzswIBGvhxUiEvhptuqEyJugb70'
    'Subject'          = 'CN=LinuxServer'
    'IP'               = '10.22.11.8'
    'ExtendedKeyUsage' = 'ServerAuth'
    'SaveToFolder'     = '/etc/ssl/scepman'
    'IncludeRootCA'    = $true
}

New-SCEPmanCertificate @Parameters
```

### Renovación de certificados

También puedes usar el módulo de PowerShell para renovar certificados existentes. Esto también evita la necesidad de usar un Service Principal para la autenticación:

```powershell
$Parameters = @{
    'CertificateFromFile' = '/home/user/.certs/server.pem'
    'KeyFromFile'         = '/home/user/.certs/server.key'
    'SaveToFolder'        = '/home/user/.certs'
}

New-SCEPmanCertificate @Parameters
```

## Script de inscripción y renovación

Si el módulo de PowerShell no es una opción para ti, puedes usar el script [enrollrenewcertificate.sh](https://github.com/scepman/csr-request/blob/main/enroll-certificate/enrollrenewcertificate.sh) para obtener un certificado inicialmente, así como para verificarlo e intentar renovarlo si está a punto de caducar.

### Requisitos previos del cliente

Los siguientes requisitos previos deben estar disponibles en el cliente/host que ejecuta el proceso 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 o posterior)**

Azure CLI se usa para autenticar al usuario que realiza la inscripción, comprobar si cumple los requisitos y recuperar el token de acceso.

#### cURL

Se usa para enviar la CSR creada 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 una CSR para inscribir o renovar un certificado.

Ejemplo:

{% code overflow="wrap" %}

```bash
./enrollrenewcertificate.sh -s https://scepman.contoso.net/ api://a7a1d6c8-51b9-48ec-9ca0-a363dc2c8436 ~/certs/ "myCertificate" "myKeyName" 30 edbc406b-7384-414e-af8b-1a3b187b3f7e [Client_Secret] 736e80bb-3102-479b-83ba-e45c80ef723b "/CN=SubjectName,O=Organization" "DNS:webserver.contoso.com"
```

{% endcode %}

#### 1. Comando

Define el comportamiento del script

Para este caso de uso, podemos utilizar las siguientes opciones:

**-s** para certificados de servidor, con detección automática de si se trata de una inscripción inicial o una renovación

**-y** para la inscripción inicial de un certificado de servidor

**-c** para enviar una solicitud de firma de certificado existente

Para casos de uso de autenticación de cliente, consulta:

{% content-ref url="/pages/830f7becb7c4c535929b3e8bdb7e9558a616abf4" %}
[Cliente Linux no administrado](https://docs.scepman.com/es/administracion-de-certificados/api-certificates/self-service-enrollment/unmanaged-linux-client.md)
{% endcontent-ref %}

#### 2. URL del servicio de aplicaciones

La URL del servicio de aplicaciones de SCEPman.

*Ejemplo: "<https://scepman.contoso.net/>"*

#### 3. Ámbito de la API

Este es el ***URI del identificador de aplicación*** del registro de aplicaciones ***SCEPman-api*** de tu entorno.

*Ejemplo: "api://a7a1d6c8-51b9-48ec-9ca0-a363dc2c8436"*

<figure><img src="https://4115997120-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LoGejQeUQcw7lqnQ3WX%2Fuploads%2FtjlK9CzLeLcLmbu0nK3b%2Fimage.png?alt=media&amp;token=a7af923f-c790-416e-bb9d-9e640d391c44" alt=""><figcaption></figcaption></figure>

#### 4. Nombre de archivo del certificado

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

*Ejemplo: "myCertificate"*

#### 5. Directorio del certificado

El directorio en el que se creará el certificado o en el que se intentará renovarlo.

*Ejemplo: \~/certs/*

#### 8. Umbral de renovación

La cantidad de días que deben faltar para que venza el certificado para que el script inicie el proceso de renovación.

*Ejemplo: 30*

### *Parámetros adicionales para certificados de servidor:*

#### 9. Id. de cliente del Service Principal

El Id. de aplicación (cliente) del registro de aplicaciones con el que queremos autenticarnos.

#### 10. Secreto de cliente del Service Principal

El secreto de cliente creado para el registro de aplicaciones con el que queremos autenticarnos.

#### 11. Id. de Tenant del Service Principal

El Id. de Tenant de nuestro registro de aplicaciones.

#### 12. Sujeto del certificado

El sujeto con el que quieres inscribir el certificado.

*Formato: /CN=SubjectName,O=Organization*

#### 13. Extensión del certificado

Se agregará como nombre alternativo del sujeto

*Ejemplo: DNS:webserver.contoso.com*

### *Ejemplo de uso para firmar una CSR (comando -c)*

{% code overflow="wrap" %}

```bash
# Generar una clave privada
openssl genrsa -out myKey.rsa 4096

# Crear una CSR para un certificado de usuario para la autenticación de cliente
openssl req -new -key myKey.rsa -sha256 -out myCSR -subj "/CN=John Smith" -addext "subjectAltName=otherName:1.3.6.1.4.1.311.20.2.3;UTF8:john.smith@contoso.net" -addext "extendedKeyUsage=1.3.6.1.5.5.7.3.2"

./enrollrenewcertificate.sh -c https://scepman.contoso.net/ api://a7a1d6c8-51b9-48ec-9ca0-a363dc2c8436 ~/certs "myCertificate" myKey.rsa 30 edbc406b-7384-414e-af8b-1a3b187b3f7e [Client_Secret] 736e80bb-3102-479b-83ba-e45c80ef723b myCSR

```

{% endcode %}

#### 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 vas a renovar certificados protegidos con frase de contraseña de Certificate Master, tendrás que introducir esta frase de contraseña para renovarlos.

## Configurar la renovación automática

Cuando se ejecuta el script bash anterior y detecta que ya se ha inscrito un certificado, lo renueva mediante mTLS (si está próximo a vencer). Si el script se ejecuta periódicamente, el certificado se renovará cuando esté próximo a vencer. Puedes configurar un trabajo cron para conseguirlo. El siguiente comando es un ejemplo de cómo hacerlo. Configurará un trabajo cron para ejecutar el comando a diario (si el sistema está encendido) y otro trabajo cron para ejecutarlo al reiniciar el sistema.

{% code overflow="wrap" %}

```
(crontab -l ; echo @daily /path/to/enrollrenewcertificate.sh -s https://scepman.contoso.net/ api://a7a1d6c8-51b9-48ec-9ca0-a363dc2c8436 /path/to/certs "myCertificate" "myKeyName" 30 edbc406b-7384-414e-af8b-1a3b187b3f7e [Client_Secret] 736e80bb-3102-479b-83ba-e45c80ef723b "/CN=SubjectName,O=Organization" "DNS:webserver.contoso.com" ; echo @reboot /path/to/enrollrenewcertificate.sh -s https://scepman.contoso.net/ api://a7a1d6c8-51b9-48ec-9ca0-a363dc2c8436 /path/to/certs "myCertificate" "myKeyName" 30 edbc406b-7384-414e-af8b-1a3b187b3f7e [Client_Secret] 736e80bb-3102-479b-83ba-e45c80ef723b "/CN=SubjectName,O=Organization" "DNS:webserver.contoso.com") | crontab -
```

{% endcode %}

Como los comandos ejecutados por Cron no necesariamente se ejecutan desde el directorio donde están el script o los certificados, es importante especificar sus rutas absolutas.


---

# 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/api-enrollment/linux-server.md?ask=<question>&goal=<user_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.
