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

イントロダクション

このガイドは、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 Coreバージョンとアクセシビリティ標準の更新

• 次を更新します 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