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 una instantánea completa 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 continúes después de completar un respaldo completo del servidor.

Requisitos Previos

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

Docker Engine
Docker Compose / Podman Compose
psql cliente
CreateSSOCustomers.py el script debería haberse ejecutado
Usuarios de la 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 hasta el directorio de descarga
Extraer el archivo:

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

Certificados SSL

Asegúrate de que el directorio de 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 certificados 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 del Cliente

Instalación

Configuración del Informe de Axe

Edita el .env archivo:

vi axeauditor-docker/.env

Migración de Base de Datos

Navega hasta la carpeta de la base de datos
Edita auditor_db_deploy.sh para establecer las variables correctas
(Nota: el usuario de la BD debe ser superusuario)
Ejecuta 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

Busca la línea:

Starting axe Auditor…

Una vez visible, puedes proceder con los pasos restantes.

Token OIDC

Visita la URL de autenticación: por ejemplo, https://auth.deque.com
Navega a Clientes → busca y selecciona tu cliente
Ve a la Instalación pestaña
Selecciona Keycloak OIDC JSON
Copia y guarda el valor para uso posterior

Configuración de un Nuevo Cliente Auditor

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

Habilitar Configuración de Compartir Ejecución de Pruebas

Ve a la Configuración de Administrador página
Asegúrate de que Habilitar Compartir Ejecución de Pruebas está desmarcado por defecto
(a menos que el cliente lo especifique)

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

Actualiza la versión de axe-core a la última recomendada
Establece El Estándar de Accesibilidad Predeterminado a WCAG 2.1 Nivel AA
Selecciona todos los Estándares de Accesibilidad

Mostrar Tarjeta de Puntuación de Accesibilidad

Debería 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:

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

Verificación por QA y SME

Navegar a la URL del servidor de Axe Auditor
Verificar el pie de página de la aplicación para la versión: 2.25.0
Realizar una verificación básica de UI
Solicitar al equipo de QA que realice una verificación básica

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