Despliegue y configuración del Auth Connector para SCEP y NDES con Docker

Antes de desplegar el Auth Connector, deberás configurar un nuevo proveedor de certificados.

Una vez en el panel de Applivery, navega a la sección Recursos 1. Desde el menú lateral izquierdo, selecciona Proveedores de certificados 2 y haz clic en el botón + Crear Proveedor de certificado 3.

El formulario de configuración incluye las siguientes secciones:

Configuración del servidor

• URL del servidor: https://<tu-servidor-ndes>/certsrv/mscep/mscep.dll.
• Huella digital de la CA: Este valor debe extraerse del certificado de la CA utilizado por el servidor NDES. Para obtenerlo, abre el certificado de la CA, navega a la sección Extensiones y localiza la entrada Huella digital de la CA. Copia este valor y pégalo en el campo.
• Nombre de la autoridad: Introduce el nombre de la CA intermedia/emisora exactamente como aparece en el certificado de la CA.

Configuración de la clave

• Tamaño de la clave: Normalmente 2048 o 4096, dependiendo de la política de seguridad.
• Tipo de clave: RSA.

Configuración del sujeto

Configura los campos del sujeto según lo requiera el servicio consumidor. Applivery admite etiquetas de interpolación para rellenar automáticamente los valores a partir de los atributos de dispositivo o usuario.

Configuración del desafío

• Modo: NDES.
• URL: https://<tu-servidor-ndes>/certsrv/mscep_admin.
• Nombre de usuario: Usuario de dominio con permisos para la plantilla de certificado configurada en el servidor NDES.
• Contraseña: Contraseña del usuario anterior.

Haz clic en Guardar, luego vuelve a abrir la configuración para copiar el Token del Auth Connector 4 que se muestra en la parte superior.

Despliega el Auth Connector como un contenedor Docker.

El servicio se empaqueta como una imagen Docker, que puedes descargar del registro Docker de Applivery:

europe-southwest1-docker.pkg.dev/applivery/public/auth-connector

Versiones disponibles

Cómo configurar el contenedor

Necesitas proporcionar algunos datos importantes para que el contenedor se ejecute:

• CONNECTOR_TOKEN: El token obtenido del proveedor de certificados en el paso anterior.
• LOG_LEVEL: El nivel de detalle del registro. Las opciones son debug, info, error o silent. El valor predeterminado es info.
• LOG_JSON: Establece en true para generar registros en formato JSON, o false para registros de texto plano. El valor predeterminado es false.

Puedes proporcionar estas configuraciones de dos maneras:

1. Usando un archivo .env: Un archivo que contiene todas las variables de entorno.
2. Directamente como variables de entorno en tu comando Docker run o en tu archivo Docker Compose.

Ejemplo de archivo de configuración

# Token del Auth Connector del proveedor de certificados. (obligatorio)
CONNECTOR_TOKEN=

# Requerido para despliegues de instancias privadas.
# TENANT=

# El nivel de registro puede ser debug, info, error o silent. (predeterminado: info)
LOG_LEVEL=info

# Registrar como json. (predeterminado: false)
LOG_JSON=false

# Puerto de escucha para el servidor de informes. (predeterminado: 3000)
PORT=3000

Ejemplos con Docker run

# Variables de entorno
docker run \
 -e CONNECTOR_TOKEN=YOUR_AUTH_TOKEN \
 -p 3000:3000 \
 europe-southwest1-docker.pkg.dev/applivery/public/auth-connector:latest

# Archivo de configuración
docker run \
 -v .env:/app/.env \
 -p 3000:3000 \
 europe-southwest1-docker.pkg.dev/applivery/public/auth-connector:latest

Ejemplos con Docker Compose

services:
  # Archivo de configuración
  applivery-auth-connector:
    image: europe-southwest1-docker.pkg.dev/applivery/public/auth-connector:latest
    volumes:
      - .env:/app/.env
    ports:
      - 3000:3000

services:
  applivery-auth-connector:
    image: europe-southwest1-docker.pkg.dev/applivery/public/auth-connector:latest-arm
    environment:
      CONNECTOR_TOKEN: YOUR_AUTH_TOKEN
      #TENANT:
      LOG_LEVEL: info
    ports:
      - 3000:3000