Instrucciones de Instalación On-premises

Introducción

Esta guía cubre la instalación on-prem basada en Docker de Axe Auditor versión 2.25.0.

Medios

Puede encontrar los medios en el servidor SFTP.

• Archivo del Instalador: axeauditor-docker-on-prem-installer-2.25.0.tar.gz
• Certificados SSL: Deben estar en formato PEM.

Respaldo

Antes de proceder, realice un snapshot completo del servidor. Este respaldo se puede usar para restaurar el sistema en caso de cualquier problema durante o después de la instalación.

Nota: Recomendamos encarecidamente que solo avance después de completar un respaldo completo del servidor.

Requisitos Previos

Asegúrese de que lo siguiente esté disponible y configurado:

• Docker Engine
• Docker Compose / Podman Compose
• psql cliente
• CreateSSOCustomers.py el script debería haberse ejecutado
• Usuarios de base de datos assure y assure_owner deberían existir
• La base de datos de destino debería estar creada

Configuración de los Medios

1. Descargar axeauditor-docker-on-prem-installer-2.25.0.tar.gz
2. Navegar al directorio de descargas
3. Extraer el archivo:

tar -xzf axeauditor-docker-on-prem-installer-2.25.0.tar.gz

Certificados SSL

1. Asegúrese de que el directorio SSL exista:

ls axeauditor-docker/volumes/nginx/

2. Si no existe, créelo:

mkdir -p axeauditor-docker/volumes/nginx/ssl

3. Copie sus certificados a:

axeauditor-docker/volumes/nginx/ssl

4. Renombrar los archivos de sus certificados a:

• nginx.crt
• nginx.key

Instancia de Keycloak

Este instalador requiere una configuración externa de Keycloak. Asegúrese de tener la siguiente información:

• URL: por ejemplo, https://auth.deque.com
• Realm: por ejemplo, axe
• ID de Cliente
• ID de Grupo
• Secreto de Cliente

Instalación

Configuración del Informe de Axe

Editar el .env archivo:

vi axeauditor-docker/.env

Migración de Base de Datos

1. Navegar a la carpeta DB
2. Editar auditor_db_deploy.sh para establecer las variables correctas
   (Nota: el usuario de BD debe ser un superusuario)
3. Ejecute el script:

./auditor_db_deploy.sh

Cargar Imágenes de Docker

docker load -i resources/axeauditor-2.25.0-ironbank-images.tar

Iniciar Contenedores de Docker

cd axeauditor-docker/
docker compose up -d

Revisar Registros

docker logs -ft axeauditor-docker-axeauditor-1

Busque la línea:

Starting axe Auditor…

Una vez visible, puede proceder con los pasos restantes.

Token OIDC

1. Visite la URL de autenticación: por ejemplo, https://auth.deque.com
2. Navegue a **Clientes** → busque y seleccione su cliente
3. Vaya a la **Instalación** pestaña
4. Seleccione **Keycloak OIDC JSON**
5. Copie y guarde el valor para uso futuro

Configuración de un Nuevo Cliente Auditor

1. Visite la URL de configuración del cliente del sistema:
   por ejemplo, docker-fi-215.dequeindiadev.com/system/client
2. Pegue el Keycloak OIDC JSON del paso anterior
3. Ingrese las credenciales del administrador del reino

Habilitar Configuración de Prueba Compartida

• Vaya a la **Configuración de Administrador** página
• Asegúrese de que **Habilitar Prueba Compartida** esté **desmarcado por defecto**
  (a menos que el cliente haya especificado lo contrario)

Actualización de la Versión de axe Core y Estándar de Accesibilidad

• Actualice la **versión de axe-core** a la **última recomendada**
• Establezca **Estándar de Accesibilidad Predeterminado** en **WCAG 2.1 Nivel AA**
• Seleccione **todos los Estándares de Accesibilidad**

Mostrar Tarjeta de Puntuación de Accesibilidad

• Debe estar **marcado** o **según la preferencia del cliente**

Actualizar Configuración de Informes de axe

Si **Informes axe** se habilitó durante la instalación:

• Establecer **Actualizar informes axe** opción a:
  System Administrator only

Verificación de cordura por el equipo de Control de Calidad y SMEs

1. Navegar a la URL del servidor de Axe Auditor
2. Verifique el pie de página de la aplicación para la versión: 2.25.0
3. Realizar una verificación básica de la interfaz de usuario
4. Solicitar al equipo de Control de Calidad que realice una verificación de cordura

Eliminar la carpeta del instalador (Recomendación)

Después de la instalación, se recomienda eliminar el archivo del instalador y los archivos extraídos:

rm -f axeauditor-docker-on-prem-installer-2.25.0.tar.gz