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.
Copia de seguridad
Antes de proceder, realice una instantánea completa del servidor. Esta copia de seguridad se puede utilizar 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 una copia de seguridad completa del servidor.
Requisitos previos
Asegúrese de que se disponga de lo siguiente y esté configurado:
- Motor de Docker
- Docker Compose / Podman Compose
psqlclienteCreateSSOCustomers.pyel script debería haberse ejecutado- Los usuarios de la base de datos
assureyassure_ownerdeben existir - La base de datos de destino debe ser creada
Configuración de los medios
- Descargue
axeauditor-docker-on-prem-installer-2.25.0.tar.gz - Navegue hasta el directorio de descarga
- Extraiga el archivo comprimido:
tar -xzf axeauditor-docker-on-prem-installer-2.25.0.tar.gzCertificados SSL
- Asegúrese de que exista el directorio SSL:
ls axeauditor-docker/volumes/nginx/- Si no existe, créelo:
mkdir -p axeauditor-docker/volumes/nginx/ssl- Copie sus certificados a:
axeauditor-docker/volumes/nginx/ssl- Renombre sus archivos de certificado a:
nginx.crtnginx.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 Axe
Edite el archivo .env:
vi axeauditor-docker/.envMigración de la base de datos
- Navegue hasta la carpeta DB
- Edite
auditor_db_deploy.shpara establecer las variables correctas
(Nota: el usuario de DB debe ser un superusuario) - Ejecute el script:
./auditor_db_deploy.shCargar imágenes Docker
docker load -i resources/axeauditor-2.25.0-ironbank-images.tarIniciar contenedores Docker
cd axeauditor-docker/
docker compose up -dVerificar registros
docker logs -ft axeauditor-docker-axeauditor-1Busque la línea:
Starting axe Auditor…Una vez visible, puede continuar 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
- Copie y guarde el valor para uso futuro
Configuración de un Nuevo Cliente Auditor
- Visite la URL de configuración del sistema cliente:
por ejemplo,docker-fi-215.dequeindiadev.com/system/client - Pegue el Keycloak OIDC JSON del paso anterior
- Ingrese las credenciales de administrador del reino
Habilitar Configuración de Compartir Prueba de Ejecución
- Vaya a la página Configuraciones de Administrador
- Asegúrese de que Habilitar Compartir Prueba de Ejecución esté desmarcado por defecto
(a menos que el cliente indique lo contrario)
Actualización de la Versión de axe Core y el Estándar de Accesibilidad
- Actualice el versión de axe-core al última recomendada
- Configure Estándar de Accesibilidad Predeterminado a WCAG 2.1 Nivel AA
- Seleccione todos los Estándares de Accesibilidad
Mostrar la Tarjeta de Puntuación de Accesibilidad
- Debe ser marcado o según la preferencia del cliente
Actualizar Configuraciones de Informes de axe
Si Informes de axe se habilitó durante la instalación:
- Configure la opción Actualizar Informes de axe a:
System Administrator only
Revisión de Sanidad por QA y SMEs
- Navegue 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 - Realice una verificación básica de la interfaz de usuario
- Solicite al equipo de QA que realice una revisión de sanidad
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