Está en la página 1de 46

SISTEMA DE DECLARACIÓN PATRIMONIAL

Y DE INTERESES DE LA PLATAFORMA
DIGITAL NACIONAL

SECRETARÍA EJECUTIVA DEL SISTEMA ESTATAL


ANTICORRUPCIÓN

UNIDAD DE SERVICIOS TECNOLÓGICOS Y PLATAFORMA


DIGITAL

Manual de instalación y configuración del Sistema de


Declaración Patrimonial y de Intereses de la Plataforma
Digital Nacional en Windows 10

Versión 1.0

Versión 1.0 puebladeclara@seseap.puebla.gob.mx Pág. 1 de 46


Tabla de contenido

Introducción **............................................................................................................................ 3
Quien deberá realizar la instalación y configuración..................................................... 4
Links de referencia..................................................................................................................... 4
Requerimientos mínimos de hardware para la instalación y configuración del
sistema .......................................................................................................................................... 5
Requisitos para virtualización con Docker Desktop......................................................... 5
Ejemplo de arquitectura para el despliegue .................................................................... 6
Cambiar la configuración de TCP/IP ................................................................................... 7
Componentes para la instalación del sistema ................................................................. 7
Instalación de GitHub Desktop .............................................................................................. 8
Instalación de Docker Desktop ........................................................................................... 10
Instalación de MongoDB ....................................................................................................... 14
Instalación de MongoDB Compass .................................................................................... 16
Instalación de Notepad++ .................................................................................................... 17
Modificar el archivo de configuración de MongodDB ................................................ 18
Crear un usuario de MongoDB para acceder a la base de datos de
Declaraciones........................................................................................................................... 20
Obtener Api Key de Sengrid para el envío de Acuse de declaración e
instrucciones de reseteo de contraseña por email ** .................................................. 23
Instalación del código de los componentes del sistema ............................................ 24
Asignación de variables de entorno para el reporteador .......................................... 27
Asignación de variables de entorno para el backend ................................................ 28
Ajustes al archivo docker-compose.yml del backend ................................................. 30
Personalización del Acuse de declaración **................................................................. 31
Despliegue del backend y reporteador con docker compose ................................ 33
Asignación de variables de entorno para el frontend ................................................. 35
Actualizar lista de instituciones/entes para el registro de usuarios ........................... 37
Despliegue del fronted con docker compose ............................................................... 38
Configuración del proxy Nginx **........................................................................................ 39
Creación de cuentas de administrador ........................................................................... 42
Actualizaciones y correcciones de errores ** ................................................................. 46

Versión 1.0 puebladeclara@seseap.puebla.gob.mx Pág. 2 de 46


Introducción **

Sistema de Información diseñado por el Equipo de la Plataforma Digital Nacional


de la Secretaría Ejecutiva del Sistema Nacional Anticorrupción para la presentación
de Declaraciones Patrimoniales y de Intereses de los Servidores Públicos.
Desarrollado usando tecnologías y estándares abiertos que facilitan la
interoperabilidad con la Plataforma Digital Nacional.

Es una herramienta que permite a los órganos públicos competentes recibir las
declaraciones patrimoniales y de intereses de los servidores públicos, cumpliendo
con el Formato aprobado por el Comité Coordinador del Sistema Nacional
Anticorrupción, resguardando la información en modelos de datos compatibles
con los estándares de datos de la Plataforma Digital Nacional.

No obstante, los entes públicos que hagan uso del Sistema de Declaraciones
deberán contar con la infraestructura necesaria para albergar al sistema, así como
encargarse de la incorporación de las declaraciones a la Plataforma Digital
Nacional, conforme a normatividad aplicable y de acuerdo con los protocolos
para el Sistema 1 de la PDN, disponibles en la siguiente dirección web:

• https://plataformadigitalnacional.org/declaraciones/especificaciones

Versión 1.0 puebladeclara@seseap.puebla.gob.mx Pág. 3 de 46


Quien deberá realizar la instalación y configuración

Se requiere que el personal técnico cuente al menos con:

• Conocimientos sobre la administración, instalación de software, activación


y desactivación de características en ambiente Windows.
• Conocimientos básicos en administración de bases de datos no relacionales
como MongoDB.

Links de referencia

Plataforma Digital Nacional

https://plataformadigitalnacional.org/

GitHub para descarga de repositorios y manuales del Sistema de Declaración


Patrimonial y de Intereses

https://github.com/PDNMX/SistemaDeclaraciones

Taller de instalación y despliegue del Sistema de Declaraciones

https://github.com/PDNMX/SistemaDeclaraciones/tree/master/taller_instalacion

SendGrid para el envío de notificaciones e instrucciones de reseteo de contraseña


por email

https://sendgrid.com/

Versión 1.0 puebladeclara@seseap.puebla.gob.mx Pág. 4 de 46


Requerimientos mínimos de hardware para la instalación y
configuración del sistema

Computadora de escritorio:

• Procesador: Core I5-10500 hasta 4.5GHZ o similar con al menos 4 vCPU


• Memoria RAM: 16 Gb expandible a 32 Gb
• Disco Duro: 500 Gb o superior
• Tarjeta de red con 1 puerto RJ45 Ethernet
• Sistema Operativo: Windows 10 Professional versión 20H1 de 64 bits
• Teclado y mouse USB
• Monitor 18.5 pulgadas

• Energía (Opcional): no-break con batería sellada recargable libre de


mantenimiento, carga aun estando apagado. Protección de la batería,
sincronía, sistema inteligente, operación totalmente automática, regulador
electrónico integrado, especificaciones eléctricas: tensión nominal: 127 v
60hz, intervalo de tensión de entrada sin descargar batería: 92 a 140v, carga
típica computadora y monitor LCD, número de receptáculos nema 5-15r: 8
todos ellos con supresor de picos y respaldo de energía.

** NOTA: El equipo deberá contar con servicio de internet para la regeneración de


componentes y algunos servicios del sistema.

Requisitos para virtualización con Docker Desktop

• Windows 10 Home or Pro 2004 (build 19041) o superior, o Enterprise o


Education 1909 (build 18363) o superior.
• Procesador de 64 bits con traducción de direcciones de segundo nivel
(SLAT).
• Soporte de CPU para la extensión del modo de monitor de VM (VT-c en CPU
Intel).
• El soporte de virtualización de hardware a nivel de BIOS debe estar
habilitado en la configuración del BIOS.
• Mínimo de 4 GB de memoria.

Versión 1.0 puebladeclara@seseap.puebla.gob.mx Pág. 5 de 46


Ejemplo de arquitectura para el despliegue

La arquitectura para el despliegue del Sistema de Declaraciones es a través de una


red local (intranet) donde el equipo de cómputo deberá tener acceso a la intranet
y al servicio de internet como se indica en el esquema.

Versión 1.0 puebladeclara@seseap.puebla.gob.mx Pág. 6 de 46


Cambiar la configuración de TCP/IP

Para el correcto funcionamiento del sistema, se requiere establecer una IP fija en


la configuración de TCP/IP de la computadora. La configuración de red deberá
modificarse de acuerdo a las especificaciones de configuración de la intranet de
la dependencia.

NOTA: La IP fija que establezca en su configuración TCP/IP será utilizada para


configurar diversos componentes del sistema.

Para el desarrollo de este manual se usará en la configuración TCP/IP la IP


192.168.0.200.

Componentes para la instalación del sistema

Versión 1.0 puebladeclara@seseap.puebla.gob.mx Pág. 7 de 46


Instalación de GitHub Desktop

1. En la carpeta de Software de instalación, da doble clic en el archivo de


instalación de GitHub Desktop (GitHubDesktopSetup-x64.exe).
2. GitHub Desktop se lanzará después de que se complete la instalación.
3. En la ventana de Bienvenida, da clic en Skip this step.

Versión 1.0 puebladeclara@seseap.puebla.gob.mx Pág. 8 de 46


4. En la ventana de Configura Git, completa la información solicitada y da clic
en Finish.

Versión 1.0 puebladeclara@seseap.puebla.gob.mx Pág. 9 de 46


Instalación de Docker Desktop

1. En la carpeta de Software de instalación, da doble clic en el archivo de


instalación de Docker Desktop (Docker Desktop Installer.exe).
2. En la ventana de Configuración, asegúrese de que la opción Habilitar
características de Windows de Hyper-V o Instalar los componentes de
Windows necesarios para WSL 2 esté seleccionada en la página
Configuración.

3. Siga las instrucciones del asistente de instalación para autorizar al instalador


y continuar con la instalación.
4. Cuando la instalación sea exitosa, haga clic en Close and restart para
completar el proceso de instalación.

Versión 1.0 puebladeclara@seseap.puebla.gob.mx Pág. 10 de 46


5. Espere a que reinicie la computadora y se inicie por si solo el servicio de
Docker.
6. En la ventana de Nuestro acuerdo de servicio ha cambiado, da clic en I
accept the terms y después da clic en Accept.

Versión 1.0 puebladeclara@seseap.puebla.gob.mx Pág. 11 de 46


7. Aparecerá la ventana de Instalación de WSL 2 está incompleta.

8. Ve a la carpeta de Software de instalación y da doble clic en el archivo de


instalación de Windows Subsystem for Linux (WSL) 2 (wsl_update_x64.msi).

9. Una vez que termine la instalación de Windows Subsystem for Linux (WSL) 2,
en la ventana de Instalación de WSL 2 está incompleta, da clic en Restart.

Versión 1.0 puebladeclara@seseap.puebla.gob.mx Pág. 12 de 46


10. Docker Desktop reiniciará su servicio y aparecerá la ventana de Inicio con
Docker. Da clic en Skip tutorial y la instalación de Docker Desktop habrá
finalizado.

Versión 1.0 puebladeclara@seseap.puebla.gob.mx Pág. 13 de 46


Instalación de MongoDB

1. En la carpeta de Software de instalación, da doble clic en el archivo de


instalación de MongoDB Community (mongodb-windows-x86_64-5.0.5-
signed.msi).
2. En la ventana de Elige el tipo de configuración, da clic en Complete.

3. En la ventana Configuración del servicio, mantenga la configuración por


default.

4. En la ventana de Install MongoDB Compass, deshabilita la opción Install


MongoDB Compass.

Versión 1.0 puebladeclara@seseap.puebla.gob.mx Pág. 14 de 46


5. Una vez que termine la instalación, en la ventana de Configuración
completada, da clic en Finish.

6. Los archivos binarios de la instalación se almacenarán en el directorio


predeterminado C:\Program Files\MongoDB\Server\5.0\bin.

Versión 1.0 puebladeclara@seseap.puebla.gob.mx Pág. 15 de 46


Instalación de MongoDB Compass

1. En la carpeta de Software de instalación, da doble clic en el archivo de


instalación de MongoDB Compass (mongodb-compass-1.29.6-win32-
x64.msi).
2. En la ventana de Configuración completada, da clic en Finish.

3. Una vez instalado, inicia MongoDB Compass y configura los ajustes de


privacidad y especifiqua las preferencias de actualización.
4. Da clic en Start Using Compass.

5. Da clic en Accept.
Versión 1.0 puebladeclara@seseap.puebla.gob.mx Pág. 16 de 46
Instalación de Notepad++

1. En la carpeta de Software de instalación, da doble clic en el archivo de


instalación de Notepad++ (npp.8.2.Installer.x64.exe).
2. Una vez instalado, en la ventana de Completando el asistente da clic en
Terminar.

3. Notepad++ se inicia.
4. Ve al menú Configuración – Preferencias.
5. Elige Backup en la lista de preferencias y en la sección de Copia de
seguridad da clic en No hacer.

6. Da clic en Cerrar.

Versión 1.0 puebladeclara@seseap.puebla.gob.mx Pág. 17 de 46


Modificar el archivo de configuración de MongodDB

1. En la ventana Ejecutar (Win + R), escribe services.msc en el recuadro Abrir y


da clic en Aceptar.

2. En la ventana de Servicios, selecciona MongoDB Server (MongoDB), da clic


derecho y a continuación, selecciona Detener.

3. En el Explorador de archivos ve a la ubicación C:\Program


Files\MongoDB\Server\5.0\bin.

Versión 1.0 puebladeclara@seseap.puebla.gob.mx Pág. 18 de 46


4. Da clic derecho sobre el archivo mongod.cfg y selecciona Editar with
Notepad++.
5. En la sección # network interfaces, agrega la IP fija para el sistema en bindIP
separándola por una coma, la modificación deberá quedar de la siguiente
manera:

NOTA: Recuerda cambiar la IP de ejemplo por la IP establecida en la


configuración TCP/IP de la computadora.
# network interfaces
net:
port: 27017
bindIp: 127.0.0.1,192.168.0.200

6. Guarda los cambios. Si Notepad++ te indica que debes reiniciarlo con


permisos de administrador da clic en Aceptar.
7. Después de reiniciar Notepad++, guarda los cambios.
8. En la ventana de Servicios, selecciona MongoDB Server (MongoDB)
nuevamente, da clic derecho y a continuación, selecciona Iniciar.

Versión 1.0 puebladeclara@seseap.puebla.gob.mx Pág. 19 de 46


9. Reinicia la computadora preferentemente.

Crear un usuario de MongoDB para acceder a la base de datos de


Declaraciones

1. Ejecuta MongoDB Compass, y en la ventana de New Connection, da clic en


Connect.

2. En la ventana que aparece de Alerta de Seguridad de Windows, habilita el


Firewall de Windows para MongoDBCompass dando clic en Permitir acceso.
Versión 1.0 puebladeclara@seseap.puebla.gob.mx Pág. 20 de 46
3. La ventana de Base de datos deberá aparecer.
4. En la parte inferior de la ventana de Base de datos, da clic en MONGOSH
para mostrar la ventana de comandos de MongoDB.

5. En la ventana de comandos ejecuta las siguientes sentencias:


use admin;
db.createUser({user: "declarausr", pwd: "declarapsw", roles: [{ role: "dbOwner",
db: "declaraciones" } ] });

Versión 1.0 puebladeclara@seseap.puebla.gob.mx Pág. 21 de 46


6. Una vez creado el usuario, aparecerá el mensaje { ok: 1 }.

Versión 1.0 puebladeclara@seseap.puebla.gob.mx Pág. 22 de 46


Obtener Api Key de Sengrid para el envío de Acuse de declaración e
instrucciones de reseteo de contraseña por email **

El Sistema de Declaraciones utiliza el servicio SendGrid para el envío de Acuse de


declaración e instrucciones de reseteo de contraseña por email. Una cuenta
básica (sin costo con hasta 100 correos enviados al día) del servicio SendGrid es
suficiente para la puesta en marcha del Sistema de Declaraciones. **

Para más información sobre como generar la API Key, visite la siguiente dirección
web:

• https://sendgrid.com/

Los pasos para obtener la API KEY son los siguientes:

• Registrar una cuenta.


• Registrar y verificarse como Single Sender (Remitente único) llenando el
formulario con la información requerida.
• Generar la API en Email API del menú lateral izquierdo seleccionado las
siguientes opciones:
o Email API –> Integration Guide –> Web API –> cURL

NOTA: Una vez generada la API KEY, deberá resguardar el texto en un archivo, ya
que es la única ocasión que se mostrará en dicha página.

De la misma forma que se modifica la IP, deberá modificar el valor de las variables
SENGRID_API_KEY y SENDGRID_MAIL_SENDER.

Una vez que ha registrado una cuenta gratuita y obtenido su API KEY, podrá ser
utilizada para la configuración en el backend.

Versión 1.0 puebladeclara@seseap.puebla.gob.mx Pág. 23 de 46


Instalación del código de los componentes del sistema

El código fuente de los módulos del Sistema de Declaraciones está alojado en los
siguientes repositorios de GitHub:

1. https://github.com/PDNMX/SistemaDeclaraciones_frontend
2. https://github.com/PDNMX/SistemaDeclaraciones_backend
3. https://github.com/PDNMX/SistemaDeclaraciones_reportes

La descarga del software se puede realizar a través de git.

1. En el Explorador de archivos, crea una carpeta en la raíz de C:\ llamada


DeclaracionesPDN, que servirá como repositorio de los componentes.

2. Inicia GitHub Desktop.


3. En el menú File selecciona la opción Clone Repository.

Versión 1.0 puebladeclara@seseap.puebla.gob.mx Pág. 24 de 46


4. En la ventana Clone a Repository, da clic en la pestaña URL.

5. En el recuadro Repository URL or GitHub username and repository copia la url


del repositorio del frontend:
https://github.com/PDNMX/SistemaDeclaraciones_frontend

6. En el cuadro LocalPath da clic en Choose y selecciona la carpeta


DeclaracionesPDN previamente creada.

Versión 1.0 puebladeclara@seseap.puebla.gob.mx Pág. 25 de 46


7. Da clic en Clone para descargar el código del componente del frontend.
8. Repite los pasos del 3 al 7 para descargar el código de los componentes del
backend y reportes.
9. Al concluir la descarga del código de los 3 componentes, el repositorio del
sistema deberá contener 3 carpetas como se muestran en la siguiente
imagen:

Versión 1.0 puebladeclara@seseap.puebla.gob.mx Pág. 26 de 46


Asignación de variables de entorno para el reporteador

1. En el Explorador de archivos, ve a la carpeta


C:\DeclaracionesPDN\SistemaDeclaraciones_reportes

2. Renombra el archivo .env.example a .env

3. Da clic derecho sobre el archivo .env y selecciona Editar with Notepad++.


4. Modifica el archivo .env el cual deberá quedar de la siguiente manera:
PORT=3001
API_KEY=reports_api_key_pdepuebla

5. El cambio que se efectuó en el archivo .env es el valor de la Api Key para la


conexión al módulo dl backend.
6. Guarda los cambios del archivo.

Versión 1.0 puebladeclara@seseap.puebla.gob.mx Pág. 27 de 46


Asignación de variables de entorno para el backend

1. En el Explorador de archivos, ve a la carpeta


C:\DeclaracionesPDN\SistemaDeclaraciones_backend

2. Renombra el archivo .env.example a .env

3. Da clic derecho sobre el archivo .env y selecciona Editar with Notepad++.


4. Modifica el archivo .env el cual deberá quedar de la siguiente manera:

NOTA: Recuerda cambiar la IP de ejemplo por la IP establecida en la


configuración TCP/IP de la computadora, así como la APIKEY y CORREO para
SendGrid.
NODE_ENV=development
PORT=3000

FE_RESET_PASSWORD_URL=http://192.168.0.200

ELASTIC_SEARCH_URL=http://192.168.0.200:9200

JWT_NO_VERIFY=false
JWT_SECRET=jwt_secret
JWT_EXPIRATION=8h

REFRESH_JWT_SECRET=jwt_secret_refresh
REFRESH_JWT_EXPIRATION=2d

Versión 1.0 puebladeclara@seseap.puebla.gob.mx Pág. 28 de 46


SENDGRID_API_KEY=SG.kv1dNiPqSSSZisGqzsbL4w.1qKvvlpXoK-MUjleCQmdiMqKQx-
Ia5Zo32E_a_cPI0c
SENDGRID_MAIL_SENDER=pde@seapuebla.org.mx

REPORTS_URL=http://192.168.0.200:3001
REPORTS_API_KEY=reports_api_key_pdepuebla

MONGO_USERNAME=declarausr
MONGO_PASSWORD=declarapsw
MONGO_HOSTNAME=192.168.0.200
MONGO_PORT=27017
MONGO_DB=declaraciones

5. Los cambios que se efectuaron en el archivo .env son principalmente la IP


fija del equipo, las credenciales para establecer la conexión a la base de
datos, las credenciales de Sendgrid y el valor de la Api Key para la conexión
al módulo de reportes.
6. Guarda los cambios del archivo.

Versión 1.0 puebladeclara@seseap.puebla.gob.mx Pág. 29 de 46


Ajustes al archivo docker-compose.yml del backend

1. En el Explorador de archivos, ve a la carpeta


C:\DeclaracionesPDN\SistemaDeclaraciones_backend

2. Da clic derecho sobre el archivo docker-compose.yml y selecciona Editar


with Notepad++.
3. Edita el archivo y ajusta tres líneas, las cuales se encuentran marcadas para
mayor claridad con comentarios de la siguiente manera:
...
app:
build:
context: ./
dockerfile: Dockerfile
args:
- NODE_ENV=${NODE_ENV}
restart: unless-stopped
#network_mode: host # Comentar o remover línea para desplegar en Windows/MacOS
depends_on:
- elasticsearch
- reports
volumes:
- .:/usr/app
ports: # Descomentar para desplegar en Windows/MacOS
- 3000:3000 # Descomentar para desplegar en Windows/MacOS
...

4. Guarda los cambios del archivo.

Versión 1.0 puebladeclara@seseap.puebla.gob.mx Pág. 30 de 46


Personalización del Acuse de declaración **

Antes de que los servidores públicos puedan comenzar a presentar sus


declaraciones a través del sistema es importante ajustar las plantillas de Acuses en
el módulo de reportes con los datos de la institución y de acuerdo con la
normatividad aplicable.

Existen tres plantillas en el directorio del módulo de reportes que permiten ajustar
los Acuses y declaratorias para las declaraciones de inicio, modificación y
conclusión. En la carpeta C:\DeclaracionesPDN\SistemaDeclaraciones_reportes\assets\json
se pueden encontrar tres archivos en formato JSON (JavaScript Object Notation)
con los siguientes nombres:

• inicio.json
• modificacion.json
• conclusion.json

Cada archivo JSON cuenta con atributos que permiten ajustar el texto que se
incluye en el Acuse de declaración y cuenta con una estructura como la siguiente:
{
"acuse": {
"ente_publico": "SECRETARÍA EJECUTIVA DEL SISTEMA ESTATAL ANTICORRUPCIÓN",
"tipo_declaracion": "DECLARACIÓN INICIAL",
"ejercicio": "2021",
"lugar": "Ciudad de México",
"texto1_cuerpo_acuse": "CON ESTA FECHA SE RECIBIÓ SU DECLARACIÓN DE MODIFICACION, ...",
"texto2_cuerpo_acuse": "LA DECLARACIÓN DE SITUACIÓN PATRIMONIAL Y DE INTERESES HA ...",
"servidor_publico_recibe": {
"nombre": "Juan Perez Tellez",
"cargo": "Director general de Responsabilidades y Verificación Patrimonial"
}
},
"declaracion": {
Versión 1.0 puebladeclara@seseap.puebla.gob.mx Pág. 31 de 46
"ente_publico": "SECRETARÍA EJECUTIVA DEL SISTEMA ESTATAL ANTICORRUPCIÓN",
"subtitulo": "DECLARACIÓN PATRIMONIAL Y DE INTERESES",
"tipo_declaracion": "DECLARACIÓN INICIAL",
"ejercicio": "2021",
"servidor_publico_recibe": {
"nombre": "Juan Perez Tellez",
"cargo": "Director general de Responsabilidades y Verificación Patrimonial"
},
"texto_declaratoria": "BAJO PROTESTA DE DECIR VERDAD, PRESENTO A USTED MI DECLAN PAT..."
}
}

Para realizar los ajustes a cada uno de los archivos (inicio, modificación,
conclusión), puedes usar Notepad++ que tiene soporte para archivos JSON para
respetar la sintaxis y evitar errores.

Versión 1.0 puebladeclara@seseap.puebla.gob.mx Pág. 32 de 46


Despliegue del backend y reporteador con docker compose

Para desplegar el sistema de backend, se usará docker-compose, el cual utiliza las


imágenes de elasticsearch, el código del proyecto de reportes y el código del
backend para construir los respectivos contenedores.

1. Abre una ventana de Windows PowerShell con permisos de Administrador.


2. Cambia la ubicación al directorio del backend
C:\DeclaracionesPDN\SistemaDeclaraciones_backend

3. Ejecuta el comando
docker-compose -p declaraciones-backend up -d --build --force-recreate

4. En la ventana que aparece de Alerta de Seguridad de Windows, habilita el


Firewall de Windows para Docker Desktop Backend dando clic en Permitir
acceso.

Versión 1.0 puebladeclara@seseap.puebla.gob.mx Pág. 33 de 46


5. La salida del comando anterior deberá ser similar a la siguiente figura:

6. Las instrucciones anteriores permitirán que el backend del Sistema de


declaraciones se encuentre disponible localmente en la dirección:
http://localhost:3000/graphql

Versión 1.0 puebladeclara@seseap.puebla.gob.mx Pág. 34 de 46


Asignación de variables de entorno para el frontend

Para el despliegue de este módulo es necesario establecer la URL del backend


como se mencionó anteriormente (el backend ya debe estar correctamente
desplegado). Se deberá asignar la URL correspondiente en la propiedad serverUrl"
que aparece al editar los siguientes archivos:
• SistemaDeclaraciones_frontend\src\environments\environment.prod.ts
• SistemaDeclaraciones_frontend\src\environments\environment.ts

NOTA: Recuerda cambiar la IP de ejemplo por la IP establecida en la configuración


TCP/IP de la computadora.

1. En el Explorador de archivos, ve a la carpeta


C:\DeclaracionesPDN\SistemaDeclaraciones_frontend\src\environments

2. Da clic derecho sobre el archivo environment.prod.ts y selecciona Editar with


Notepad++.

3. Edita el archivo y asigna la propiedad “serverUrl” de la siguiente manera:


serverUrl: 'http://192.168.0.200/api',

4. Guarda los cambios.


5. En el Explorador de archivos, da clic derecho sobre el archivo environment.ts
y selecciona Editar with Notepad++.

Versión 1.0 puebladeclara@seseap.puebla.gob.mx Pág. 35 de 46


6. Edita el archivo y asigna la propiedad “serverUrl” de la siguiente manera:
serverUrl: 'http://192.168.0.200/api',

7. Guarda los cambios.

Versión 1.0 puebladeclara@seseap.puebla.gob.mx Pág. 36 de 46


Actualizar lista de instituciones/entes para el registro de usuarios

En el formulario de Registro, existe el campo de información INSTITUCIÓN que hace


referencia al Ente/Institución que hará uso del sistema, para lo cual deberá
adecuarse el archivo instituciones.json.

1. En el Explorador de archivos, ve a la carpeta


C:\DeclaracionesPDN\SistemaDeclaraciones_frontend\src\static\custom

2. Da clic derecho sobre el archivo instituciones.json y selecciona Editar with


Notepad++.
3. Para municipios, edita el archivo con la clave y nombre del municipio de
acuerdo al marco geoestadístico de Inegi (ejemplo, Municipio de Puebla)
así como los datos del Contralor:
[
{
"ente_publico": "MUNICIPIO DE ACAJETE",
"clave": "001",
"servidor_publico_recibe": {
"nombre": "Juan Perez Tellez",
"cargo": "Director general de Responsabilidades y Verificación Patrimonial"
}
}
]

4. Para instituciones, edita el archivo con las siglas y el nombre de la institución


(ejemplo, Secretaría Ejecutiva del Sistema Estatal Anticorrupción) así como
los datos del titular del OIC:
[
{
"ente_publico": "SECRETARÍA EJECUTIVA DEL SISTEMA ESTATAL ANTICORRUPCIÓN",
"clave": "SESEA PUEBLA",
"servidor_publico_recibe": {
"nombre": "Juan Perez Tellez",
"cargo": "Director general de Responsabilidades y Verificación Patrimonial"
}
}
]

5. Guarda los cambios.

Versión 1.0 puebladeclara@seseap.puebla.gob.mx Pág. 37 de 46


Despliegue del fronted con docker compose

1. Abre una ventana de Windows PowerShell con permisos de Administrador.


2. Cambia la ubicación al directorio del frontend
C:\DeclaracionesPDN\SistemaDeclaraciones_frontend

3. Ejecuta el comando
docker-compose -p declaraciones-frontend up -d --build --force-recreate

4. La salida del comando anterior deberá ser similar a la siguiente figura:

5. Las instrucciones anteriores permitirán que el frontend del Sistema de


declaraciones se encuentre disponible localmente en la dirección:
http://localhost:8080

Versión 1.0 puebladeclara@seseap.puebla.gob.mx Pág. 38 de 46


Configuración del proxy Nginx **

Una vez que se han instalado los componentes del sistema, se puede utilizar el proxy
NGINX para exponer el sistema a través de la intranet, internet o nombre de
dominio.

La configuración del Nginx puede variar dependiendo de la configuración de la


infraestructura donde se realiza el despliegue. No obstante, debe ajustarse para
hacer un proxy a la dirección local donde se encuentra el frontend del Sistema de
Declaraciones.

Para obtener más información sobre la instalación de Nginx consulte la siguiente


url:
https://nginx.org/

1. En la carpeta de Software de instalación, da clic derecho en el archivo de


Nginx (nginx-1.21.5.zip) y selecciona la opción Extraer todo.
2. En la ventana Extraer carpetas comprimidas (en zip), da clic en Examinar y
selecciona la carpeta C:\Program Files (x86), da clic en Seleccionar
carpeta.

3. Da clic en Extraer.
4. En el Explorador de archivos, ir a la carpeta C:\Program Files (x86)\nginx-
1.21.5\conf
5. Da clic derecho sobre el archivo nginx.conf y selecciona Editar with
Notepad++.
6. Modifica la IP de server_name en la sección server.

Versión 1.0 puebladeclara@seseap.puebla.gob.mx Pág. 39 de 46


NOTA: Recuerda cambiar la IP de ejemplo por la IP establecida en la
configuración TCP/IP de la computadora.

server {
listen 80;
server_name 192.168.0.200;
location / {
proxy_pass http://localhost:8080;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection 'upgrade';
proxy_set_header Host $host;
proxy_cache_bypass $http_upgrade;
}

location /api {
rewrite /api(/.*)$ $1 break;
proxy_pass http://localhost:3000;
proxy_http_version 1.1;
proxy_set_header X-Forwarded-For $remote_addr;
proxy_set_header Host $http_host;
}
}

7. Guarda los cambios. Si Notepad++ te indica que debes reiniciarlo con


permisos de administrador da clic en Aceptar.
8. Después de reiniciar Notepad++, guarda los cambios.
9. En la ventana Ejecutar (Win + R), escribe shell:startup en el recuadro Abrir y
da clic en Aceptar.

10. En la ventana del Explorador de archivos que se abre, crea un acceso


directo al archivo nginx.exe que se encuentra en la carpeta C:\Program
Files (x86)\nginx-1.21.5

Versión 1.0 puebladeclara@seseap.puebla.gob.mx Pág. 40 de 46


11. Da doble clic en el acceso directo creado.
12. En la ventana que aparece de Alerta de Seguridad de Windows, habilita el
Firewall de Windows para nginx.exe dando clic en Permitir acceso.

13. Las instrucciones anteriores permitirán que el frontend del Sistema de


Declaraciones se encuentre disponible localmente y mediante intranet en
las siguientes direcciones respectivamente:
http://localhost o http://192.168.0.200

Versión 1.0 puebladeclara@seseap.puebla.gob.mx Pág. 41 de 46


Creación de cuentas de administrador

Se recomienda realizar la creación de al menos una cuenta de Administrador al


instalar el Sistema de Declaraciones, para permitir la reasignación de los roles de
otros usuarios.

1. Para la creación de usuarios con rol de “Administrador” inicia con el registro


de la información a través del formulario de registro del sistema (inicialmente
todos los usuarios que se registran cuentan con el rol de “Declarante”).
Ejemplo de captura de información del administrador.

2. Verifica que el usuario registrado pueda iniciar correctamente desde el


formulario de acceso.

Versión 1.0 puebladeclara@seseap.puebla.gob.mx Pág. 42 de 46


3. Cierra la sesión del usuario en el sistema.
4. Ejecuta MongoDB Compass, y en la ventana de New Connection, da clic en
Connect.
5. En la pestaña de Base de datos, selecciona declaraciones.

Versión 1.0 puebladeclara@seseap.puebla.gob.mx Pág. 43 de 46


6. En la vista de colecciones, da clic en users. Aparecerá la información del
usuario registrado.
7. En la vista de datos, bajo la lista de roles, cambia el rol asignado sustituyendo
USER por ROOT.

Versión 1.0 puebladeclara@seseap.puebla.gob.mx Pág. 44 de 46


8. Da clic en botón UPDATE que aparece en la parte inferior derecha de la vista
de datos.
9. Inicia sesión nuevamente en el sistema, observarás en el menú superior la
opción USUARIOS.

** Para el uso del sistema, consulte el archivo adjunto Manual de usuario – PDN.pdf,
en el cual se describen los pasos para la presentación de declaraciones y de
intereses por parte de las y los servidores públicos, así como facilitar el seguimiento
a su presentación por parte de las usuarias y usuarios administrativos.

Versión 1.0 puebladeclara@seseap.puebla.gob.mx Pág. 45 de 46


Actualizaciones y correcciones de errores **

Cada módulo del Sistema de Declaraciones cuenta con un repositorio en github


de donde se pueden obtener las últimas versiones que incluyen actualizaciones y
correcciones de errores.

Las direcciones de los repositorios de github del Frontend, Backend y Reporteador


son las siguientes:

• Backend: https://github.com/PDNMX/SistemaDeclaraciones_backend
• Reportes: https://github.com/PDNMX/SistemaDeclaraciones_reportes
• Frontend: https://github.com/PDNMX/SistemaDeclaraciones_frontend

NOTA: Es importante realizar respaldos de las bases de datos, configuraciones


(archivos .env, archivos .ts) y plantillas de acuses antes de descargar cualquier
actualización de los módulos del Sistema de Declaraciones.

** Referencia: Manual de Instalación – versión 1.0 del Sistema de Declaración Patrimonial y de


Intereses de la Plataforma Digital Nacional.

Versión 1.0 puebladeclara@seseap.puebla.gob.mx Pág. 46 de 46

También podría gustarte