Instrucciones de Instalación Local

This page is not available in the language you requested. You have been redirected to the English version of the page.

Link to this page copied to clipboard

Not for use with personal data

Introducción

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

Medios

Puedes 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, realiza un respaldo completo del servidor. Este respaldo se puede usar para restaurar el sistema en caso de que ocurra algún problema durante o después de la instalación.

Nota: Recomendamos encarecidamente que sólo procedas después de completar un respaldo completo del servidor.

Requisitos Previos

Asegúrate de que los siguientes elementos estén disponibles y configurados:

Motor de Docker
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

Descargar axeauditor-docker-on-prem-installer-2.25.0.tar.gz
Navega al directorio de descarga
Extrae el archivo:

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

Certificados SSL

Asegúrate de que el directorio SSL exista:

ls axeauditor-docker/volumes/nginx/

Si no existe, créalo:

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

Copia tus certificados a:

axeauditor-docker/volumes/nginx/ssl

Renombra tus archivos de certificado a:

nginx.crt
nginx.key

Instancia de Keycloak

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

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

Instalación

Configuración del Informe Axe

Edita el .env archivo:

vi axeauditor-docker/.env

Migración de Base de Datos

Navega a la carpeta DB
Edita auditor_db_deploy.sh para establecer las variables correctas
(Nota: El usuario DB debe ser un superusuario)
Ejecute el script:

./auditor_db_deploy.sh

Cargar imágenes Docker

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

Iniciar contenedores 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

Visite la URL de autenticación: por ejemplo, https://auth.deque.com
Navegar a **Clientes** → buscar y seleccionar su cliente
Vaya a la **Instalación** pestaña
Seleccione **Keycloak OIDC JSON**
Copie y guarde el valor para uso posterior

Configurar un nuevo cliente auditor

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

Habilitar la configuración de compartir pruebas de ejecución

Vaya a la **Configuración del administrador** página
Asegúrese de que **Habilitar compartir prueba de ejecución** esté **desmarcada por defecto**
(a menos que lo especifique el cliente)

Actualizar la versión de axe Core y el estándar de accesibilidad

Actualice la **versión de axe-core** a la **última recomendada**
Configure **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 **marcada** o **según la preferencia del cliente**

Actualizar la configuración de informes de axe

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

Configurar **Actualizar informes de axe** opción en:
System Administrator only

Comprobación de Saneamiento por el equipo de QA y expertos

Navegue a la URL del servidor Axe Auditor
Verifique el pie de página de la aplicación para la versión: 2.25.0
Realizar una verificación básica de la interfaz de usuario
Solicitar al equipo de QA que realice una comprobació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