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: Debe 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úe después de completar una copia de seguridad completa 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 haber sido ejecutado
Los 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 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 un 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 archivo .env:

vi axeauditor-docker/.env

Migración de Base de Datos

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

Visite la URL de autenticación: por ejemplo, https://auth.deque.com
Navegue a Clientes → busque y seleccione su cliente
Vaya a la pestaña Instalación
Seleccione Keycloak OIDC JSON
Copia y guarda el valor para uso posterior

Configuración de un Nuevo Cliente Auditor

Visite 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

Vaya a la página Configuración de Administrador
Asegúrese 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

Actualice el versión de axe-core al última recomendada
Configure 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 ser marcado o según la preferencia del cliente

Actualizar Configuración de Informes de axe

Si Informes de axe fue habilitado durante la instalación:

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

Verificación por QA y SME

Navegar a la URL del servidor de 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 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