CI/CD — Intégrer l'audit RGAA dans votre pipeline

Ajoutez un audit RGAA automatique sur chaque Pull Request. L'action vérifie que le score d'accessibilité ne descend pas sous le seuil défini.

Créez le fichier .github/workflows/rgaa.yml :

name: RGAA Check
on: [pull_request]

jobs:
  rgaa:
    runs-on: ubuntu-latest
    steps:
      - uses: rgaaudit/action@v1
        with:
          url: ${{ env.PREVIEW_URL }}
          threshold: 70

Ajoutez ce stage dans votre fichier .gitlab-ci.yml :

rgaa-audit:
  image: node:20
  stage: test
  script:
    - |
      RESULT=$(curl -s -X POST https://rgaaudit.fr/api/ci/scan \
        -H "Content-Type: application/json" \
        -H "X-API-Key: $RGAAUDIT_API_KEY" \
        -d "{\"url\": \"$CI_ENVIRONMENT_URL\", \"threshold\": 70, \"diagnostics\": true}")
      echo "$RESULT" | jq .
      SCORE=$(echo "$RESULT" | jq -r '.score')
      BROKEN=$(echo "$RESULT" | jq -r '.diagnostics.brokenLinks | length')
      echo "Score RGAA : $SCORE/100 — Liens cassés : $BROKEN"
      if [ "$SCORE" -lt 70 ]; then
        echo "Score RGAA insuffisant : $SCORE/100"
        exit 1
      fi
      if [ "$BROKEN" -gt 0 ]; then
        echo "⚠️  $BROKEN lien(s) cassé(s) détecté(s)"
      fi
  only:
    - merge_requests

Ajoutez la variable RGAAUDIT_API_KEY dans Settings > CI/CD > Variables de votre projet GitLab.

Pour auditer les pages protégées par authentification (dashboard, admin, paramètres...), passez les cookies de session dans le body de la requête :

curl -X POST https://rgaaudit.fr/api/ci/scan \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $RGAAUDIT_API_KEY" \
  -d '{
    "url": "https://monapp.fr",
    "cookies": [
      { "name": "session", "value": "abc123", "domain": "monapp.fr" }
    ],
    "threshold": 70
  }'

Le paramètre cookies accepte un tableau d'objets avec les champs name, value, domain (optionnel) et path (optionnel, défaut : « / »).

Affichez le score RGAA de votre site directement dans votre README :

![RGAA Score](https://rgaaudit.fr/api/ci/badge/monsite.fr)

Le badge se met à jour automatiquement après chaque audit. Formats supportés :

L'action GitHub ajoute automatiquement un commentaire sur la PR avec le résultat de l'audit :

Le commentaire inclut un lien vers le rapport complet sur RGAAudit, avec les détails de chaque violation et les suggestions de correction.

Pour utiliser l'intégration CI/CD, vous devez générer une clé API dédiée depuis votre compte RGAAudit.

Les clés CI/CD sont préfixées par rga_ (par exemple rga_k7x9m2...). Stockez-la dans un secret GitHub ou une variable CI protégée :

# GitHub Actions — ajouter le secret dans Settings > Secrets
- uses: rgaaudit/action@v1
  with:
    url: ${{ env.PREVIEW_URL }}
    api-key: ${{ secrets.RGAAUDIT_API_KEY }}
    threshold: 70

L'accès à l'API CI/CD dépend de votre plan RGAAudit :

Au-delà du quota, l'API retourne une erreur 403 Forbidden. Le compteur se réinitialise le 1er de chaque mois. Vous pouvez suivre votre consommation dans Paramètres > API.

Le badge RGAA se met à jour automatiquement après chaque audit CI/CD ou audit lancé depuis l'interface web. Il affiche le dernier score connu pour votre domaine.

La couleur du badge reflète le niveau de conformité :

Aucune authentification requise pour afficher le badge : l'endpoint GET /api/ci/badge/:siteKey est public. Intégrez-le dans votre README, votre documentation ou votre site vitrine.

Si le dernier audit inclut des pages protégées par authentification, le badge affiche un suffixe ✦ après le niveau de conformité (ex : « Conforme ✦ »), indiquant une couverture étendue.