Istruzioni per l'installazione in sede

Introduzione

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

Media

Puoi trovare i media sul server SFTP.

• File dell'installer: 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: Raccomandiamo fortemente di procedere solo dopo aver completato un backup completo del server.

Requisiti

Assicurati che i seguenti elementi siano disponibili e configurati:

• Docker Engine
• Docker Compose / Podman Compose
• psql client
• CreateSSOCustomers.py dovrebbe essere stato eseguito
• 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. 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 certificati in:

• nginx.crt
• nginx.key

Istanza Keycloak

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

• URL: ad esempio, https://auth.deque.com
• Reame: ad esempio, axe
• ID cliente
• ID gruppo
• Segreto del cliente

Installazione

Configurazione del rapporto 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 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 esempio, https://auth.deque.com
2. Naviga fino a 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 futuro

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 dal passaggio precedente
3. Inserisci le credenziali di amministrazione del realm

Abilita Impostazione Condivisione Esecuzione Test

• Vai alla pagina Impostazioni Amministratore
• Assicurati che Abilita Condivisione Esecuzione Test sia disattivata per impostazione predefinita
  (a meno che non sia specificato dal cliente)

Aggiornamento Versione axe Core e Standard di Accessibilità

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

Mostra Scheda Punteggio di Accessibilità

• Dovrebbe essere selezionato o come preferenza del cliente

Aggiorna Impostazioni dei Report di axe

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

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

Controllo di base da parte di QA e SME

1. Naviga all'URL del server di Axe Auditor
2. Controlla il piè di pagina dell'applicazione per la versione: 2.25.0
3. Esegui una verifica UI di base
4. Richiedi al team QA di effettuare un controllo di base

Elimina la cartella Installer (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