Configuración
Configura PDF Redaction Studio autoalojado con .env: licencia, secretos, base de datos, URL públicas de tu dominio, métodos de acceso y endpoint de detección.
Todos los ajustes están en el archivo .env, junto a docker-compose.yaml. Todos los contenedores lo leen. Después de un cambio, aplícalo con:
docker compose up -dVariables
| Variable | Usada por | Valor en .env.example | Qué hace |
|---|---|---|---|
PDF_REDACTION_LICENSE | backend | vacío | Tu clave de licencia. Obligatoria, consulta Licencia |
DATABASE_HOST | backend | db | Host de la base de datos. Deja db para usar el contenedor de Postgres incluido |
DATABASE_PASSWORD | db, backend | valor de ejemplo | Contraseña de Postgres. Cámbiala antes del primer arranque |
SIGNING_KEY | backend | valor de ejemplo | Firma los tokens de inicio de sesión. Cámbiala por un valor aleatorio largo |
ALLOWED_HOSTS | backend | localhost,backend,0.0.0.0,127.0.0.1 | Nombres de host a los que responde el backend. Añade el dominio de tu backend |
CORS_ALLOWED_ORIGINS | backend | http://localhost:3000 | Dirección de la app web de Studio. Pon la URL de tu Studio |
API_URL | studio | http://backend:8000 | Cómo llega el servidor de Studio al backend dentro de Docker. Normalmente no se cambia |
NEXT_PUBLIC_API_URL | studio | http://127.0.0.1:8000 | Cómo llegan los navegadores de los usuarios al backend |
NEXT_PUBLIC_PII_API_URL | studio | http://127.0.0.1:8002/api/deidentify/ner/text | Cómo llegan los navegadores de los usuarios a la API de detección |
NEXTAUTH_URL | studio | http://localhost:3000/api/auth | URL pública de Studio seguida de /api/auth |
NEXTAUTH_SECRET | studio | valor de ejemplo | Cifra las sesiones de inicio de sesión. Cámbialo por un valor aleatorio largo |
NEXT_PUBLIC_AUTH_METHODS | studio | userpass | Métodos de inicio de sesión de la página de acceso, ver más abajo |
PDF_REDACTION_API_LICENSE, PDF_REDACTION_API_OPENMETER_SOURCE | api | incluido | Ajustes de la API de detección. Conserva los valores de .env.example salvo que el soporte te indique otra cosa |
Genera secretos aleatorios con:
openssl rand -base64 32Ejecutar Studio en tu propio dominio
Los valores predeterminados solo funcionan en la máquina donde se ejecuta Docker. La página de Studio en el navegador se comunica directamente con el backend y con la API de detección, así que ambos deben ser accesibles desde los equipos de tus usuarios.
Una configuración típica coloca un proxy inverso con HTTPS (nginx, Caddy o Traefik) delante de los tres puertos públicos:
| Dirección pública | Reenvía a |
|---|---|
https://studio.example.com | studio:3000 |
https://studio-api.example.com | backend:8000 |
https://studio-pii.example.com | api:8002 |
Después configura:
NEXTAUTH_URL=https://studio.example.com/api/auth
CORS_ALLOWED_ORIGINS=https://studio.example.com
NEXT_PUBLIC_API_URL=https://studio-api.example.com
NEXT_PUBLIC_PII_API_URL=https://studio-pii.example.com/api/deidentify/ner/text
ALLOWED_HOSTS=studio-api.example.com,backend,localhostNo expongas la base de datos
docker-compose.yaml publica Postgres en el puerto 5432 por comodidad. En un servidor, elimina esa entrada ports o bloquea el puerto en tu cortafuegos, para que la base de datos solo sea accesible desde los demás contenedores.
Métodos de inicio de sesión
NEXT_PUBLIC_AUTH_METHODS es una lista separada por comas:
| Valor | Método de inicio de sesión |
|---|---|
userpass | Usuario y contraseña, guardados en tu servidor (predeterminado) |
google | Cuenta de Google. Necesita tu propio cliente OAuth de Google |
microsoft | Cuenta de Microsoft. Necesita tu propia app de Microsoft Entra ID |
Para iniciar sesión con Google o Microsoft, crea la app OAuth con la URL de redirección https://studio.example.com/api/auth/callback/google (o /microsoft) y contacta con soporte para saber qué variables añadir.
Dónde se ejecuta la detección
En Studio autoalojado, PII en la nube en los ajustes de detección del editor envía el texto de las páginas al contenedor api de tu servidor, la dirección de NEXT_PUBLIC_PII_API_URL. NER local, la detección basada en reglas, el OCR y la detección de caras se ejecutan en el navegador de cada usuario, como en todos los productos.
Siguientes pasos
Instalar con Docker
Instala PDF Redaction Studio autoalojado con Docker Compose: instalador de una línea o instalación manual, clave de licencia, primer acceso y contenedores.
Licencia
Cómo funciona la licencia de PDF Redaction Studio autoalojado: consigue una clave de prueba o comercial, añádela a .env, qué pasa al caducar y cómo sustituirla.