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

イントロダクション

このガイドは、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
• レルム： 例： 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