オンプレミスインストール手順

はじめに

このガイドは、Axe Auditor バージョン 2.25.0 の Docker ベースのオンプレミスインストールについて説明します。

メディア

メディアは SFTP サーバーにあります。

• インストーラーファイル: axeauditor-docker-on-prem-installer-2.25.0.tar.gz
• SSL 証明書: PEM 形式である必要があります。

バックアップ

進める前に、サーバーの完全なスナップショットを作成してください。このバックアップは、インストール中またはインストール後に問題が発生した場合、システムを復元するために使用できます。

注意: サーバーの完全なバックアップを完了した後にのみ、進めることを強くお勧めします。

前提条件

以下が利用可能かつ設定されていることを確認してください:

• Docker エンジン
• Docker Compose / Podman Compose
• psql クライアント
• CreateSSOCustomers.py スクリプトを実行済みであること
• データベース・ユーザー assure と assure_owner が存在していること
• ターゲットデータベースが作成されていること

メディアの設定

1. ダウンロード axeauditor-docker-on-prem-installer-2.25.0.tar.gz
2. ダウンロードディレクトリに移動
3. アーカイブを解凍:

tar -xzf axeauditor-docker-on-prem-installer-2.25.0.tar.gz

SSL 証明書

1. SSL ディレクトリが存在することを確認:

ls axeauditor-docker/volumes/nginx/

2. 存在しない場合は、作成してください:

mkdir -p axeauditor-docker/volumes/nginx/ssl

3. 証明書を以下にコピーしてください:

axeauditor-docker/volumes/nginx/ssl

4. 証明書ファイルの名前を次のように変更してください:

• nginx.crt
• nginx.key

Keycloak インスタンス

このインストーラーには 外部 Keycloak 設定が必要です。以下の情報を持っていることを確認してください:

• URL: 例: https://auth.deque.com
• Realm: 例: axe
• クライアント ID
• グループ ID
• クライアントシークレット

インストール

Axe レポート設定

ファイルを編集 .env :

vi axeauditor-docker/.env

データベース移行

1. DB フォルダに移動
2. 編集する auditor_db_deploy.sh 正しい変数を設定するために
   （注意: DBユーザーはスーパーユーザーである必要があります）
3. スクリプトを実行してください:

./auditor_db_deploy.sh

Dockerイメージをロードする

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

Dockerコンテナを開始する

cd axeauditor-docker/
docker compose up -d

ログを確認する

docker logs -ft axeauditor-docker-axeauditor-1

次の行を探してください:

Starting axe Auditor…

表示されたら、残りのステップを進めてください。

OIDCトークン

1. 認証URLにアクセスしてください。例： https://auth.deque.com
2. 移動先は クライアント → クライアントを検索して選択
3. 次に移動 インストール タブ
4. 選択 Keycloak OIDC JSON
5. 値をコピーして後で使用するために保存する

新しい監査クライアントの設定

1. システムクライアント設定URLにアクセス:
   例： docker-fi-215.dequeindiadev.com/system/client
2. 前のステップからKeycloak OIDC JSONを貼り付けてください
3. レルム管理者の資格情報を入力してください

共有テスト実行設定を有効にする

• 移動先は 管理設定 ページ
• 確認 共有テスト実行を有効にする は デフォルトでチェックされていない
  （顧客が指定しない限り）

axeコアバージョンとアクセシビリティ基準の更新

• 更新 axe-coreバージョン を 最新の推奨
• 設定 デフォルトのアクセシビリティ基準 を WCAG 2.1レベルAA
• 選択 すべてのアクセシビリティ基準

アクセシビリティスコアカードを表示する

• 以下であるべきです チェック済み または 顧客の好みに応じて

axeレポート設定の更新

もし axeレポート はインストール中に有効化されました。

• 次のように設定します: axeレポートを更新 オプション:
  System Administrator only

QAとSMEによるサニティチェック

1. Axe AuditorサーバーのURLにアクセスします
2. アプリケーションのフッターでバージョンを確認します: 2.25.0
3. 基本的なUI検証を行います
4. QAチームにサニティチェックを依頼します

インストーラーフォルダの削除（推奨）

インストール後に、インストーラーのアーカイブと展開したファイルを削除することをお勧めします:

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