Istruzioni per l'installazione on-premises

This page is not available in the language you requested. You have been redirected to the English version of the page.
Link to this page copied to clipboard
Not for use with personal data

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
  • psql client
  • CreateSSOCustomers.py lo script dovrebbe essere stato eseguito
  • Utenti del database assure e assure_owner devono esistere
  • Il database di destinazione deve essere creato

Configurazione 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/
  1. Se non esiste, creala:
mkdir -p axeauditor-docker/volumes/nginx/ssl
  1. Copia i tuoi certificati in:
axeauditor-docker/volumes/nginx/ssl
  1. Rinomina i file dei tuoi certificati in:
  • nginx.crt
  • nginx.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/.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

Carica le immagini Docker

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

Avvia i container Docker

cd axeauditor-docker/
docker compose up -d

Controlla i log

docker logs -ft axeauditor-docker-axeauditor-1

Cerca la linea:

Starting axe Auditor…

Una volta visibile, puoi procedere con i passaggi rimanenti.

OIDC Token

  1. Visita l'URL di autenticazione: ad es., https://auth.deque.com
  2. Vai 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

Impostazione di un Nuovo Cliente Auditor

  1. Visita l'URL di configurazione del cliente di sistema:
    ad es., docker-fi-215.dequeindiadev.com/system/client
  2. Incolla il JSON Keycloak OIDC dal passaggio precedente
  3. 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

  1. Vai 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 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