Instructions d'installation sur site

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

Introduction

Ce guide couvre l'installation sur site basée sur Docker de la version 2.25.0 d'Axe Auditor.

Média

Vous pouvez trouver le média sur le serveur SFTP.

  • Fichier d'installation : axeauditor-docker-on-prem-installer-2.25.0.tar.gz
  • Certificats SSL : Doivent être au format PEM.

Sauvegarde

Avant de continuer, effectuez une capture complète du serveur. Cette sauvegarde peut être utilisée pour restaurer le système en cas de problème pendant ou après l'installation.

Remarque : Nous vous recommandons fortement de ne continuer qu'après avoir effectué une sauvegarde complète du serveur.

Prérequis

Assurez-vous que les éléments suivants sont disponibles et configurés :

  • Moteur Docker
  • Docker Compose / Podman Compose
  • psql client
  • CreateSSOCustomers.py le script doit avoir été exécuté
  • Utilisateurs de la base de données assure et assure_owner doivent exister
  • La base de données cible doit être créée

Configurer le média

  1. Téléchargez axeauditor-docker-on-prem-installer-2.25.0.tar.gz
  2. Accédez au répertoire de téléchargement
  3. Extrayez l'archive :
tar -xzf axeauditor-docker-on-prem-installer-2.25.0.tar.gz

Certificats SSL

  1. Assurez-vous que le répertoire SSL existe :
ls axeauditor-docker/volumes/nginx/
  1. S'il n'existe pas, créez-le :
mkdir -p axeauditor-docker/volumes/nginx/ssl
  1. Copiez vos certificats vers :
axeauditor-docker/volumes/nginx/ssl
  1. Renommez vos fichiers de certificats en :
  • nginx.crt
  • nginx.key

Instance Keycloak

Cet installateur nécessite un paramétrage Keycloak externe. Assurez-vous d'avoir les informations suivantes :

  • URL : par ex., https://auth.deque.com
  • Royaume : par ex., axe
  • ID client
  • ID de groupe
  • Secret client

Installation

Configuration du rapport Axe

Modifiez le .env fichier :

vi axeauditor-docker/.env

Migration de la base de données

  1. Accédez au dossier DB
  2. Modifiez auditor_db_deploy.sh pour définir les variables correctes
    (Remarque : l'utilisateur DB doit être un superutilisateur)
  3. Exécutez le script :
./auditor_db_deploy.sh

Charger les images Docker

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

Démarrer les conteneurs Docker

cd axeauditor-docker/
docker compose up -d

Vérifier les journaux

docker logs -ft axeauditor-docker-axeauditor-1

Recherchez la ligne :

Starting axe Auditor…

Une fois visible, vous pouvez passer aux étapes suivantes.

Jeton OIDC

  1. Visitez l'URL d'authentification : par exemple, https://auth.deque.com
  2. Naviguez vers **Clients** → recherchez et sélectionnez votre client
  3. Accédez à l'onglet **Installation**
  4. Sélectionnez **Keycloak OIDC JSON**
  5. Copiez et enregistrez la valeur pour une utilisation ultérieure

Configurer un nouveau client auditeur

  1. Visitez l'URL de configuration du client système :
    par exemple, docker-fi-215.dequeindiadev.com/system/client
  2. Collez le JSON Keycloak OIDC de l'étape précédente
  3. Entrez les identifiants administratifs du royaume

Activer le paramètre de partage de test

  • Allez à la page **Paramètres d'administration**
  • Assurez-vous que **Activer le partage de test** est **décoché par défaut**
    (sauf indication contraire du client)

Mise à jour de la version axe Core et de la norme d'accessibilité

  • Mettez à jour la **version axe-core** vers la **dernière recommandée**
  • Définissez la **norme d'accessibilité par défaut** sur **WCAG 2.1 Niveau AA**
  • Sélectionnez **toutes les normes d'accessibilité**

Afficher le tableau de score d'accessibilité

  • Devrait être **coché** ou **selon la préférence du client**

Mettre à jour les paramètres des rapports axe

Si rapports axe a été activé lors de l'installation :

  • Définir Mettre à jour les rapports axe option sur :
    System Administrator only

Vérification de base par l'équipe QA et les experts en la matière

  1. Accédez à l'URL du serveur Axe Auditor
  2. Vérifiez le pied de page de l'application pour la version : 2.25.0
  3. Effectuez une vérification de base de l'interface utilisateur
  4. Demandez à l'équipe QA d'effectuer une vérification de base

Supprimer le dossier d'installation (Recommandation)

Après l'installation, il est recommandé de supprimer l'archive de l'installateur et les fichiers extraits :

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