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édias

Vous pouvez trouver les médias sur le serveur SFTP.

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

Sauvegarde

Avant de continuer, prenez un instantané complet 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 recommandons fortement de ne procéder 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
  • Client psql
  • Le script CreateSSOCustomers.py devrait avoir été exécuté
  • Les utilisateurs de la base de données assure et assure_owner devraient exister
  • La base de données cible doit être créée

Mise en place des médias

  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 certificat comme suit :
  • nginx.crt
  • nginx.key

Instance Keycloak

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

  • URL : par ex., https://auth.deque.com
  • Domaine : par ex., axe
  • ID Client
  • ID Groupe
  • Secret Client

Installation

Configuration du rapport Axe

Modifiez le fichier .env :

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

Cherchez la ligne :

Starting axe Auditor…

Une fois visible, vous pouvez procéder avec les étapes restantes.

Jeton OIDC

  1. Visitez l'URL d'authentification : par exemple, https://auth.deque.com
  2. Accédez à Clients → recherchez et sélectionnez votre client
  3. Allez à l'onglet Installation
  4. Sélectionnez Keycloak OIDC JSON
  5. Copiez et sauvegardez 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 Keycloak OIDC JSON de l'étape précédente
  3. Entrez les identifiants d'administrateur 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 non coché par défaut
    (sauf spécification du client)

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

  • Mettez à jour le version axe-core vers le dernière recommandée
  • Réglez Norme d'accessibilité par défaut sur WCAG 2.1 Niveau AA
  • Sélectionnez toutes les normes d'accessibilité

Afficher la carte de score d'accessibilité

  • Devrait être coché ou selon les préférences du client

Mettre à jour les paramètres des rapports axe

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

  • Réglez l'option Mettre à jour les rapports axe sur :
    System Administrator only

Vérification par à QA et PME

  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 l'interface utilisateur de base
  4. Demandez à l'équipe QA de réaliser une vérification sanitaire

Supprimer le dossier d'installation (Recommandation)

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

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