Istruzioni per l'installazione on-premise

Introduzione

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

Media

Puoi trovare i media sul server SFTP.

• File del programma di installazione: axeauditor-docker-on-prem-installer-2.25.0.tar.gz
• Certificati SSL: Devono 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 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
• Utenti del database assure e assure_owner dovrebbero esistere
• Il database di destinazione dovrebbe essere creato

Impostare i media

1. Scarica axeauditor-docker-on-prem-installer-2.25.0.tar.gz
2. Vai alla 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 di Keycloak

Questo programma di installazione richiede un setup esterno di Keycloak. Assicurati di avere le seguenti informazioni:

• URL: es., https://auth.deque.com
• Realm: es., axe
• ID Cliente
• ID Gruppo
• Segreto Cliente

Installazione

Configurazione dei report Axe

Modifica il .env file:

vi axeauditor-docker/.env

Migrazione del database

1. Vai alla cartella DB
2. Modifica auditor_db_deploy.sh per impostare le variabili corrette
   (Nota: l'utente DB deve essere un superutente)
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

Controlla 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 **Clienti** → 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'admin del realm

Abilita Condivisione dei Risultati del Test

• Vai alla **Impostazioni Admin** pagina
• Assicurati che **Abilita Condivisione dei Risultati del Test** sia **deselezionato di default**
  (a meno che non sia specificato dal cliente)

Aggiornamento della Versione di axe Core e degli Standard di Accessibilità

• Aggiorna la **versione di axe-core** alla **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** oppure **conforme alle preferenze del cliente**

Aggiorna le Impostazioni dei Report di axe

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

• Impostare **Aggiorna axe Reports** opzione a:
  System Administrator only

Controllo di Sanità Mentale da parte di QA e SME

1. Sfogliare all'URL del server di Axe Auditor
2. Controllare il piè di pagina dell'applicazione per la versione: 2.25.0
3. Eseguire una verifica di base dell'interfaccia utente
4. Richiedere al team QA di eseguire un controllo di sanità mentale

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