Istruzioni per l'installazione locale

Introduzione

Questa guida copre l'installazione locale basata su Docker di Axe Auditor versione 2.25.0.

Media

Puoi trovare i media sul server SFTP.

• File dell'installer: axeauditor-docker-on-prem-installer-2.25.0.tar.gz
• Certificati SSL: Dovrebbero essere in formato PEM.

Backup

Prima di procedere, effettua un'istantanea completa del server. Questo backup può essere utilizzato per ripristinare il sistema in caso di problemi durante o dopo l'installazione.

Nota: Raccomandiamo vivamente di procedere solo dopo aver completato un backup completo del server.

Prerequisiti

Assicurarsi che i seguenti elementi siano disponibili e configurati:

• Docker Engine
• Docker Compose / Podman Compose
• psql client
• CreateSSOCustomers.py lo script dovrebbe essere stato eseguito
• Utenti del database assure e assure_owner dovrebbero esistere
• Il database di destinazione dovrebbe essere creato

Impostazione dei Media

1. Scarica axeauditor-docker-on-prem-installer-2.25.0.tar.gz
2. Naviga nella directory di download
3. Estrai l'archivio:

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

Certificati SSL

1. Assicurarsi che esista la directory SSL:

ls axeauditor-docker/volumes/nginx/

2. Se non esiste, crearla:

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

3. Copia i tuoi certificati in:

axeauditor-docker/volumes/nginx/ssl

4. Rinomina i tuoi file di certificato in:

• nginx.crt
• nginx.key

Istanza Keycloak

Questo installer richiede un set up di Keycloak esterno. Assicurarsi di avere le seguenti informazioni:

• URL: ad esempio, https://auth.deque.com
• Realm: ad esempio, axe
• ID Client
• ID Gruppo
• Segreto del Client

Installazione

Configurazione del Report di Axe

Modifica il .env file:

vi axeauditor-docker/.env

Migrazione del Database

1. Naviga nella cartella DB
2. Modifica auditor_db_deploy.sh per impostare le variabili corrette
   (Nota: l'utente DB deve essere un superuser)
3. Esegui lo script:

./auditor_db_deploy.sh

Caricare le Immagini Docker

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

Avviare i Contenitori Docker

cd axeauditor-docker/
docker compose up -d

Controllare i Log

docker logs -ft axeauditor-docker-axeauditor-1

Cerca la linea:

Starting axe Auditor…

Una volta visibile, puoi procedere con i passaggi rimanenti.

Token OIDC

1. Visita l'URL di autenticazione: ad es., https://auth.deque.com
2. Naviga su **Clienti** → cerca e seleziona il tuo cliente
3. Vai alla scheda **Installazione**
4. Seleziona **Keycloak OIDC JSON**
5. Copia e salva il valore per un uso successivo

Configurare un Nuovo Cliente Auditor

1. Visita l'URL di configurazione del cliente di sistema:
   ad es., docker-fi-215.dequeindiadev.com/system/client
2. Incolla il Keycloak OIDC JSON dal passaggio precedente
3. Inserisci le credenziali dell'amministratore del regno

Attivare la Condivisione delle Impostazioni del Test

• Vai alla pagina **Impostazioni Amministratore**
• Assicurati che **Attiva Condivisione Test** sia **non selezionata per impostazione predefinita**
  (salvo diversa indicazione del cliente)

Aggiornamento della Versione axe Core e degli Standard di Accessibilità

• Aggiorna la versione **axe-core** all' **ultima raccomandata**
• Imposta lo **Standard di Accessibilità Predefinito** su **WCAG 2.1 Livello AA**
• Seleziona **tutti gli Standard di Accessibilità**

Mostra il Punteggio di Accessibilità

• Dovrebbe essere **selezionato** o **secondo la preferenza del cliente**

Aggiorna le Impostazioni dei Rapporti axe

Se **Axe Reports** è stato abilitato durante l'installazione:

• Imposta l'opzione **Aggiorna Axe Reports** su:
  System Administrator only

Verifica di base da parte di QA e SME

1. Vai all'URL del server Axe Auditor
2. Controlla il piè di pagina dell'applicazione per la versione: 2.25.0
3. Esegui una verifica di base dell'interfaccia utente
4. Chiedi al team QA di effettuare una verifica di base

Elimina la cartella dell'installer (Raccomandazione)

Dopo l'installazione, è consigliato eliminare l'archivio dell'installer e i file estratti:

rm -f axeauditor-docker-on-prem-installer-2.25.0.tar.gz