Instrucciones de instalación local

Introducción

Esta guía cubre la instalación local 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 continuar, haga una instantánea completa del servidor. Este respaldo puede usarse 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:

• Motor Docker
• Docker Compose / Podman Compose
• psql cliente
• CreateSSOCustomers.py el script debe haber sido ejecutado
• Usuarios de la base de datos assure y assure_owner deben existir
• La base de datos de destino debe ser creada

Configuración de los Medios

1. Descargar axeauditor-docker-on-prem-installer-2.25.0.tar.gz
2. Navegue 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. Renombre sus archivos de 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
• Reino: por ejemplo, axe
• ID de Cliente
• ID de Grupo
• Secreto del Cliente

Instalación

Configuración del Informe de Axe

Edite 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 la base de datos 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

Verificar Registros

docker logs -ft axeauditor-docker-axeauditor-1

Busque la línea:

Starting axe Auditor…

Una vez visible, puede continuar 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 usarlo más tarde

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 JSON OIDC de Keycloak del paso anterior
3. Ingrese las credenciales de administrador del reino

Habilitar Configuración de Compartir Ejecución de Prueba

• Vaya a la **Configuración de Admin** página
• Asegúrese de que **Habilitar Compartir Ejecución de Prueba** esté **desmarcado por defecto**
  (a menos que lo especifique el cliente)

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

• Actualice la **versión de axe-core** a la **recomendada más reciente**
• Establezca el **Estándar de Accesibilidad Predeterminado** a **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 de axe** se habilitó durante la instalación:

• Configure **Actualizar Informes de axe** opción a:
  System Administrator only

Verificación por el equipo de QA y expertos

1. Navegue a la URL del servidor de Axe Auditor
2. Verifique el pie de página de la aplicación en busca de la versión: 2.25.0
3. Realice una verificación básica de la interfaz de usuario
4. Solicite al equipo de QA realizar una verificación de saneamiento

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