Istruzioni per l'installazione on-premises
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 uno snapshot completo del server. Questo backup può essere utilizzato per ripristinare il sistema in caso di problemi durante o dopo l'installazione.
Nota: Raccomandiamo vivamente di proseguire 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
psqlclientCreateSSOCustomers.pylo script dovrebbe essere stato eseguito- Utenti del database
assureeassure_ownerdevono esistere - Il database di destinazione deve essere creato
Configurazione dei media
- Scarica
axeauditor-docker-on-prem-installer-2.25.0.tar.gz - Vai alla directory di download
- Estrai l'archivio:
tar -xzf axeauditor-docker-on-prem-installer-2.25.0.tar.gzCertificati SSL
- Assicurati che la directory SSL esista:
ls axeauditor-docker/volumes/nginx/- Se non esiste, creala:
mkdir -p axeauditor-docker/volumes/nginx/ssl- Copia i tuoi certificati in:
axeauditor-docker/volumes/nginx/ssl- Rinomina i file dei tuoi certificati in:
nginx.crtnginx.key
Istanza di Keycloak
Questo programma di installazione richiede un setup Keycloak esterno. Assicurati di avere le seguenti informazioni:
- URL: ad es.,
https://auth.deque.com - Realm: ad es.,
axe - ID Cliente
- ID Gruppo
- Segreto Cliente
Installazione
Configurazione report di Axe
Modifica il .env file:
vi axeauditor-docker/.envMigrazione del database
- Naviga nella cartella DB
- Modifica
auditor_db_deploy.shper impostare le variabili corrette
(Nota: l'utente del database deve essere un superuser) - Esegui lo script:
./auditor_db_deploy.shCarica le immagini Docker
docker load -i resources/axeauditor-2.25.0-ironbank-images.tarAvvia i container Docker
cd axeauditor-docker/
docker compose up -dControlla i log
docker logs -ft axeauditor-docker-axeauditor-1Cerca la linea:
Starting axe Auditor…Una volta visibile, puoi procedere con i passaggi rimanenti.
OIDC Token
- Visita l'URL di autenticazione: ad es.,
https://auth.deque.com - Vai a **Clienti** → cerca e seleziona il tuo cliente
- Vai alla scheda **Installazione**
- Seleziona **Keycloak OIDC JSON**
- Copia e salva il valore per un uso futuro
Impostazione di un Nuovo Cliente Auditor
- Visita l'URL di configurazione del cliente di sistema:
ad es.,docker-fi-215.dequeindiadev.com/system/client - Incolla il JSON Keycloak OIDC dal passaggio precedente
- Inserisci le credenziali dell'amministratore del realm
Abilita Condivisione Impostazione Esecuzione Test
- Vai a **Impostazioni Amministrative** pagina
- Assicurati che **Abilita Condivisione Esecuzione Test** sia **deselezionato di default**
(a meno che non sia specificato dal cliente)
Aggiornamento della Versione di axe Core & Standard di Accessibilità
- Aggiorna la **versione di axe-core** alla **ultima raccomandata**
- Imposta lo **Standard di Accessibilità Predefinito** a **WCAG 2.1 Livello AA**
- Seleziona **tutti gli Standard di Accessibilità**
Mostra Scheda Punteggio di Accessibilità
- Dovrebbe essere **selezionato** o **come preferito dal cliente**
Aggiorna Impostazioni dei Report di axe
Se **Rapporti di axe** è stato abilitato durante l'installazione:
- Imposta **Aggiorna i rapporti di axe** opzione su:
System Administrator only
Controllo di Sanità da QA e SME
- Vai all'URL del server di Axe Auditor
- Controlla il piè di pagina dell'applicazione per la versione:
2.25.0 - Esegui una verifica UI di base
- Richiedi al team QA di eseguire un controllo di sanità
Elimina la Cartella dell'Installer (Raccomandazione)
Dopo l'installazione, si consiglia di eliminare l'archivio dell'installer e i file estratti:
rm -f axeauditor-docker-on-prem-installer-2.25.0.tar.gz