Version: 1.2.0
Configuración
Cada módulo de SUDOCU tiene su propia configuración, de las cuales la más importante es la del api-server. Hasta el momento son en total 6 archivos:
API-Server#
{
"organismo": {
// Completar el campo código con el número de SAF asignado a la institución
"codigo": 815,
"nombre": "Universidad Nacional de General Sarmiento",
"sigla": "UNGS"
},
"servidor": {
"path": "/",
"host": "0.0.0.0",
"subdomain": "sudocu",
"domain": ".ungs.edu.ar",
"port": "8080",
"seguro": {
"habilitado": true,
"certificados": {
"ca": "/etc/ssl/crt/sudocu.ca-bundle",
"cert": "/etc/ssl/crt/sudocu.crt",
"key": "/etc/ssl/crt/sudocu.key"
},
"cookies": {
// Tiempo de cookies de sesión
// Opciones: [Número] hours | minutes | seconds
"expires": "1 hours"
}
},
"websocket": {
// Configuración librería socket.io
"path": "/socket.io",
"secure": false
},
"environment": "development" // Agrega marca de agua a documentos cerrados con leyenda "test". Opciones: development | production
},
"reverse_proxy": {
// Agrega https a las url
"seguro": true
},
"debug": {
"SQL": false, // Habilita debug para consultas postgres (solo develop)
"verbose": true // Habilita debug de mensajes para cada función
},
"auth": {
// Estrategias de login
"providers": {
"basic": {
"user": "",
"challenge": true,
"realm": ""
},
"local": {
"habilitado": false
},
"twitter": {
"habilitado": false,
"consumerKey": "consumerKey",
"consumerSecret": "consumerSecret"
},
"facebook": {
"habilitado": false,
"clientID": "clientID",
"clientSecret": "clientSecret"
},
"google": {
"habilitado": false,
"clientID": "clientID",
"clientSecret": "clientSecret"
},
"saml": {
"identifier": "uid", // Este valor depende de la versión de saml
"crearSiNoExiste": true, // Crea nuevo usuario en SUDOCU si este no existe
"habilitacionAutomatica": true,
"perfilXDefecto": 1,
"claustroXDefecto": "ND",
"habilitado": true,
"entryPoint": "https://idp.edu.ar/saml2/idp/SSOService.php",
"logoutUrl": "https://idp.edu.ar/saml2/idp/SingleLogoutService.php?ReturnTo=http://sudocu.edu.ar/",
"cert_pem": "" // Permite incorporar certificado en formato .pem para autenticación saml
}
}
},
"repositorios": {
//Repositorio
"documentos": "arai", // Opciones: arai | filesystem
"adjuntos": "filesystem",
"arai": {
"url_notificacion":"https://sudocu.edu.ar/api/integracion/notificacion",
"url": "https://sudocu.edu.ar/docs/rest/backend/documentos",
"username": "documentos",
"id_instalacion": "sudocu"
}
},
"firma": {
//Firma
"modelo_autorizacion": "siu", // Opciones: siu | sudocu
"api": "https://sudocu.edu.ar/docs/rest/backend", // Exclusivo modelo siu
"api_front": "https://sudocu.edu.ar/docs/rest/frontend", // Exclusivo modelo siu
"username": "documentos"
},
"filesystem": {
// Carpeta donde se guardan los adjuntos
"rootFolder": "/app/sudocu-files/"
},
"ungsxt": {
// Conexión con base de datos
"host": "10.0.0.1",
"port": "5435",
"database": "sudocu",
"user": "postgres",
"max": 20, // Cantidad máxima pool de conexión
"idleTimeoutMillis": 30000,
"connectionTimeoutMillis": 2000
},
"nuxeo": {
// Configuración nuxeo en caso de no usar arai
"api": "",
"admin": {
"username": ""
}
},
"carpetas": {
// Path dentro del contenedor para almacenar archivos temporales
"archivos": "/tmp"
},
"alertas": {
// Funcionalidad alertas permite recibir notificaciones con errores producidos en el api-server
"traceinconsole": false, // Oculta el trace
"rawinmessage": false, // Incorpora el error completo convertido en texto en el mensaje de la notificación
"telegram": {
// Habilita mensajes con errores por telegram
"_comment": "https://www.npmjs.com/package/messaging-api-telegram",
"enabled": false,
"token": "",
"chat_id": ""
},
"email": {
// Habilita mensajes con errores por email
"enabled": false,
"dev": {
"_comment": "https://stackoverflow.com/questions/24098461/nodemailer-gmail-what-exactly-is-a-refresh-token-and-how-do-i-get-one",
"destinatario": "",
"client_id": "",
"client_secret": "",
"refresh_token": "",
"auth": {
"user": ""
}
}
}
},
"email": {
// Configuración de funcionalidad seguimientos
"seguimientos": {
"notificaciones": {
// Variables disponibles para asunto y cuerpo: $novedad $tipo $numero $caratula $area_usuario_origen $estado $permalink
"asunto":"$novedad ($tipo)",
"cuerpo":"Tipo: $tipo<br/>Número: $numero <br/>Carátula: $caratula<br/>Area y usuario de origen: $area_usuario_uario_origen <br/>Novedad: $novedad<br/>Estado: $estado<br/>link: $permalink<br/>",
"escenarios": "compartir|enviar", // Opciones: remitir|enviar|solicitar|autorizar|rechazar|compartir
"novedades": {
// Permite especificar el texto para cada evento
"remitir": "Se remite un expediente",
"enviar": "Se envía un documento",
"solicitar": "Solicitud de autorización",
"autorizar": "Solicitud autorizada",
"rechazar": "Rechazo solicitud de autorización",
"compartir": "Se comparte un documento"
}
},
// Configuración servidor de email
"_comment": "Modo puede ser smtp o gmail",
"modo": "gmail",
// smtp
"smtp": {
"remitente": "",
"host": "",
"port": "",
"secure": "",
"auth": {
"user": "",
"pass": ""
}
},
// gmail
"gmail": {
"remitente": "SUDOCU",
"client_id": "",
"client_secret": "",
"refresh_token": "",
"auth": {
"user": ""
}
}
}
},
"redis": {
// Servidor redis
"host": "cache",
"port": 6379,
"db": "UNGSxt",
"ttl": 28800,
"options": {}
},
"pdf": {
// Host servidor pdf
"host": "http://pdf:3000"
},
// Configuración CORS
"whitelist": [
8080,
8181,
8383,
443
],
"documentos": {
"_comment": "recepcion por vista o por edicion",
"recepcion": "edicion", // Opciones: vista | edicion
"google_analytics": {
// Permite incoporar el id para tracking
"habilitado": false,
"id": ""
}
},
"archivos": {
// Herramienta merge archivos pdf
"merge_tool" : "gs", // Opciones: gs o pdftk
"merge_skip_error": false // En caso de recibir errores todo el tiempo
},
"gestion": {
"incorporar_expedientes" : true, // Permite o no incorporar expedientes
"integracion": {
"esencias": [ "contenedor" ] // Tipos de esencia habilitadas en integración
},
"ver_expedientes_enviados": false, // Habilita herramienta vista avanzada para expedientes en vista enviados
"agregar_seguimiento_docs_compartidos": false, // Muestra seguimientos en la vista preview
"vista_rapida_descargar": "ubicacion", // Habilita botón descargar para la vista previa
"mostrar_validez": true, // Habilita toggle en formulario para indicar validez digital o papel
"contar_novedades": false, // Habilita ícono con cantidad de documentos en cada solapa
"archivos_adjuntos" : {
"max_mb": 100, // Tamaño máximo por archivo
"sum_max_mb" : 100, // Tamaño máximo de todos los adjuntos por documento
"max_cant" : 100 // Cantidad máxima de adjuntos por documentos
},
"herramientas_vistas": {
// Habilita herramientas según la vista
"documentos" : {
"anular":true
},
"compartidos" : {
"vista_previa":true
},
"busqueda": {
"compartir": false,
"vista_avanzada": false,
"descargar": false,
"abrir": false
}
},
"fonts": [
//Agrega fuentes en módulo templates pdf de mpc
{
"name": "Oswald=oswald",
"style": "https://fonts.googleapis.com/css2?family=Oswald&display=swap"
}
]
},
"admin": {
// Parámetros módulo admin
"logged_users_refresh_rate": 30,
"notificaciones_delay": 100,
"jobs_timer": "0 */1 * * * *"
},
"imagemin": {
// Parámetros librería imagemin
"width_pixels": 20,
"jpeg_quality": 50 // Permite definir la calidad de los archivos .jpg subidos como adjuntos Opciones: 1 a 100
},
"http-proxy": {
// Librería http-proxy-middleware
// Permite redireccionar request hacia otro servidor
// Ejemplo: http://localhost:3000/api/foo/bar -> http://www.example.org/api/foo/bar
"service": {
"target": "",
"auth": "user:password"
}
},
"secrets": {
// Secrets para modo desarrollo
"auth_providers_basic_password": "integracion",
"auth_admin_basic_password": "admin",
"repositorios_arai_password": "password_arai",
"firma_password": "password_arai",
"db_password": "password_db",
"redis_options_password": "redis",
"nuxeo_admin_password": "Administrator"
}
}
Inicio#
{
"server": {
"host": "",
"port": 0,
"secure": true,
"clusters": false,
"apiUrl": "",
"urlHome": "",
"livereload": 35738,
"urlLogout": ""
},
"cookiesOptions": {
"path":"/",
"domain": "",
"secure": true
},
"crts": {
"ca": "/etc/ssl/crt/sudocu.ca-bundle",
"key": "/etc/ssl/crt/sudocu.key",
"cert": "/etc/ssl/crt/sudocu.crt"
},
"links": {
"gestion": "",
"mpd": "",
"config": "",
}
}
Gestión#
{
"server": {
"path":"/",
"host": "",
"modName": "gestion",
"port": 0,
"secure": true,
"clusters": false,
"apiUrl": "",
"socketUrl": "",
"socketPath": "/socket.io",
"socketSecure": false,
"urlHome": "",
"livereload": 35745,
"contexto": "fr_sudocu_gestion",
"formato_fecha": "dd-MM-yyyy HH:mm",
"modelo_autorizacion": "sudocu"
},
"cookiesOptions": {
"domain": "",
"secure": true
},
"crts": {
"ca": "/etc/ssl/crt/sudocu.ca-bundle",
"cert": "/etc/ssl/crt/sudocu.crt",
"key": "/etc/ssl/crt/sudocu.key"
}
}
MPD#
{
"server": {
"host": "",
"port": 0,
"modName": "mpd",
"secure": true,
"clusters": false,
"apiUrl": "",
"urlHome": "",
"socketUrl": "",
"socketPath": "/socket.io",
"socketSecure": false,
"livereload": 35738
},
"cookiesOptions": {
"domain": "",
"secure": true
},
"crts": {
"ca": "/etc/ssl/crt/sudocu.ca-bundle",
"cert": "/etc/ssl/crt/sudocu.crt",
"key": "/etc/ssl/crt/sudocu.key"
}
}
MPC#
{
"server": {
"host": "",
"port": 0,
"modName": "mpc",
"securePort": 0,
"secure": true,
"clusters": false,
"apiUrl": "",
"urlHome": "",
"socketUrl": "",
"socketPath": "/socket.io",
"socketSecure": false,
"livereload": 35738,
"contexto": "fr_sudocu_mpc"
},
"cookiesOptions": {
"domain": "",
"secure": true
},
"crts": {
"ca": "/etc/ssl/crt/sudocu.ca-bundle",
"cert": "/etc/ssl/crt/sudocu.crt",
"key": "/etc/ssl/crt/sudocu.key"
}
}
Configuración para agregar Fuentes Tipográficas externas.#
Pasos para agregar fuentes a los template de PDF:
En config-api-server.json agregar dentro del key gestion lo siguiente:
"gestion":{"fonts":[{"name":"Oswald=oswald","style":"https://fonts.googleapis.com/css2?family=Oswald&display=swap"}]}En el .yml de deploy agregar en el servicio de pdf el siguiente volumen:
volumes:-./fonts:/usr/share/fonts/truetype/sudocuEn la carpeta del deploy crear la carpeta fonts y por cada fuente que se agrega en el config crear una carpeta y copiar dentro de ella todos los archivos TrueType de la familia que se establezca en la configuración. Por ejemplo para fuentes de google descargar el zip y descomprimirlo dentro de la carpeta de manera que quede:
/fonts-- /Oswald---- /OFL.txt---- /Oswald-Bold.ttf---- /Oswald-ExtraLight.ttf---- /Oswald-Light.ttf---- /Oswald-Medium.ttf---- /Oswald-Regular.ttf---- /Oswald-SemiBold.ttf---- /Oswald-VariableFont_wght.ttf---- /README.txtFinalmente eliminar stack sudocu y volver a realizar el deploy.
Caso de fuentes que no son de Google
En caso de necesitar cargar fuentes que no sean de google, la url colocada en el config-api-server.json tendría que apuntar a un archivo .CSS que tenga las definciones de las fuentes. Si se ingresa a la url mencionada anteriormente https://fonts.googleapis.com/css2?family=Oswald&display=swap se puede observar que devuelve un css con una serie de estilos. En el caso de una fuente no-google se debe replicar lo mismo con una url propia. Existen generadores de font-face online, por ejemplo: https://transfonter.org.