¶ 1. Sobre el Notificador (Casilla Digital Única)
La plataforma de Notificaciones (Casilla Digital Única) es la plataforma que permite a los Órganos de la Administración del Estado comunicarse con las personas de manera directa, auditable y por médicos digitales.
El Nodo de Interoperabilidad permite a los órganos de la administración del Estado utilizar los servicios de Notificador para enviar mensajes a las personas y revisar el estatus de esos mensajes, facilitando que los sistemas de cada organismo puedan hacer uso de Notificador.
A continuación se detalla cómo habilitar estos servicios.
¶ 2. Habilitar los servicios de Notificador
En el archivo config.json del Nodo se deben agregar los servicios del Notificador.
Esta sección se agrega en: consumidor
“consumidor”: [
{
"nombre": "GetAccessToken",
"rutaLocal": "/notificador/getAccessToken",
"timeout": 60
},{
"nombre": "SendMessage",
"rutaLocal": "/notificador/sendMessage",
"autenticacion": "NotificadorToken",
"timeout": 60
},{
"nombre": "MessageStatus",
"rutaLocal": "/notificador/messageStatus/{message-data-id:.*}",
"autenticacion": "NotificadorToken",
"timeout": 60
},{
"nombre": "CitizenPending",
"rutaLocal": "/notificador/citizenPending/{run:.*}",
"autenticacion": "NotificadorToken",
"timeout": 60
},{
"nombre": "GetProcedure",
"rutaLocal": "/notificador/getProcedure",
"autenticacion": "NotificadorToken",
"timeout": 60
},{
"nombre": "GetReceipt",
"rutaLocal": "/notificador/getReceipt/{message-data-id:.* }/{run:.}",
"autenticacion": "NotificadorToken",
"timeout": 60
},{
"nombre": "GetSignature",
"rutaLocal": "/notificador/getSignature",
"autenticacion": "NotificadorToken",
"timeout": 60
}
}
¶ 3. Configurar las credenciales de notificador
En el archivo config.json del Nodo se debe agregar una sección de identificación con las credenciales de su organismo para Notificador.
Esta sección se agrega en: identificacion/custom
(Si no está la sección “custom” se debe crear)
"identificacion": {
"pki": {
"privado": "./key.pem",
"publico": "./cert.pem"
},
"firma": {
.
.
.
,{"custom": [
{
"nombre": "NotificadorToken",
"script": "auth.notificador.script",
"servicio": "GetAccessToken",
"id": "client id",
"secret": "client secret"
}
]
}Se debe colocar el clientId y clientSecret que corresponden a su institución.
¶ 4. Incluir el script de autenticación
Después de configurar los servicios y credenciales el la configuración se debe incluir el archivo auth.notificador.script en la carpeta /conversiones del Nodo de interoperabilidad.
Este archivo se puede descargar desde:
http://34.222.97.205:9012/d?id=mBsmlPB8H6uudrv
Este script le permite al Nodo obtener automáticamente las credenciales de Notificador para así simplificar el desarrollo de los sistemas que usen la API de Notificador.
¶ 5. Iniciar el Nodo y llamar servicios
Una vez agregado el script y hechos los cambios de configuración se puede reiniciar el Nodo y llamar a sus servicios.
./NodoV2 start
Llamado a un servicio de Notificador:
GET
http://localhost:8084/notificador/getProcedure
Este llamado debería retornar un JSON con los procedimientos que fueron incluidos para su institución en Notificador en el proceso de enrolamiento.
¶
6.- Más información de como llamar servicios de Notificador
Existe una colección de POSTMAN que detalla cómo llamar al resto de los servicios de Notificador:
https://drive.google.com/file/d/19zl5PXvDzQVj3_RWQca3VGC1-YXHgVDD/view?usp=drive_link
Integración de Casilla Única:
https://wikiguias.digital.gob.cl/es/Manuales/integracion-casillaunica
Para más información deben contactarse directamente con el equipo de Notificador.