Istruzioni per l'installazione on-premise

Introduzione

Questa guida copre l'installazione on-premise di Axe Auditor versione 2.25.0 basata su Docker.

Media

Puoi trovare i media sul server SFTP.

• File dell'installatore: 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: Consigliamo vivamente di continuare solo dopo aver completato un backup completo del server.

Prerequisiti

Assicurati che i seguenti elementi siano disponibili e configurati:

• Docker Engine
• Docker Compose / Podman Compose
• psql client
• CreateSSOCustomers.py lo script dovrebbe essere stato eseguito
• Gli utenti del database assure e assure_owner devono esistere
• Il database di destinazione deve 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. 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 file dei tuoi certificati in:

• nginx.crt
• nginx.key

Istanza Keycloak

Questo installer richiede un configurazione Keycloak esterna. Assicurati di avere le seguenti informazioni:

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

Installazione

Configurazione del Report 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 DB deve essere un superuser)
3. Esegui lo script:

./auditor_db_deploy.sh

Carica le Immagini Docker

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

Avvia i Contenitori Docker

cd axeauditor-docker/
docker compose up -d

Verifica i Log

docker logs -ft axeauditor-docker-axeauditor-1

Cerca la riga:

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 Client → cerca e seleziona il tuo client
3. Vai alla scheda Installazione
4. Seleziona Keycloak OIDC JSON
5. Copia e salva il valore per un uso successivo

Configurazione di un Nuovo Client Auditor

1. Visita l'URL di configurazione del client 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 realm

Abilita l'Impostazione Condividi Esecuzione Test

• Vai alla pagina Impostazioni Amministrative
• Assicurati che Abilita Condividi Esecuzione Test sia non selezionato di default
  (a meno che non sia specificato dal cliente)

Aggiornamento Versione axe Core e Standard di Accessibilità

• Aggiorna versione axe-core a ultima consigliata
• Imposta Standard di Accessibilità Predefinito su WCAG 2.1 Livello AA
• Seleziona tutti gli Standard di Accessibilità

Mostra Scheda del Punteggio di Accessibilità

• Dovrebbe essere selezionato o secondo le preferenze del cliente

Aggiorna Impostazioni dei Rapporti axe

Se Rapporti axe era abilitato durante l'installazione:

• Imposta l'opzione Aggiorna Rapporti axe su:
  System Administrator only

Controllo di Sanità 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 sanità

Elimina la Cartella dell'Installatore (Raccomandazione)

Dopo l'installazione, si consiglia di eliminare l'archivio dell'installatore e i file estratti:

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