Istruzioni per l'installazione in sede

Introduzione

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

Media

Puoi trovare i media sul server SFTP.

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

Backup

Prima di procedere, esegui un'istantanea completa del server. Questo backup può essere usato 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

Assicurati che siano disponibili e configurati i seguenti elementi:

• Docker Engine
• Docker Compose / Podman Compose
• psql client
• CreateSSOCustomers.py lo script dovrebbe essere stato eseguito
• Gli 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 dei download
3. Estrai l'archivio:

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

Certificati SSL

1. Assicurati che la directory SSL esista:

ls axeauditor-docker/volumes/nginx/

2. Se non esiste, creala:

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 programma di installazione richiede un setup esterno di Keycloak. Assicurati di avere le seguenti informazioni:

• URL: ad esempio, https://auth.deque.com
• Realm: ad esempio, axe
• Client ID
• Group ID
• Client Secret

Scheda installazione

Configurazione del Report di Axe

Modifica il file .env:

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 del database 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 container Docker

cd axeauditor-docker/
docker compose up -d

Verificare i log

docker logs -ft axeauditor-docker-axeauditor-1

Cercare la linea:

Starting axe Auditor…

Una volta visibile, si può procedere con i passaggi rimanenti.

Token OIDC

1. Visita l'URL di autenticazione: ad esempio, https://auth.deque.com
2. Vai a Clienti → cerca e seleziona il tuo client
3. Vai alla scheda Scheda installazione
4. Seleziona Keycloak OIDC JSON
5. Copia e salva il valore per un uso successivo

Configurare un nuovo client Auditor

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

Abilitare l'impostazione Share Test Run

• Vai alla pagina Impostazioni amministratore
• Assicurati che Abilita Share Test Run sia deselezionato di default
  (salvo indicato dal cliente)

Aggiornare la versione di axe Core e lo standard di accessibilità

• Aggiorna il versione axe-core al ultima raccomandata
• Imposta 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. Richiedi al team QA di eseguire un controllo di base

Elimina la cartella dell'installatore (Raccomandazione)

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

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