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

導入

このガイドでは、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