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

はじめに

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

メディア

メディアは SFTP サーバーで見つかります。

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

バックアップ

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

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

前提条件

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

• Docker Engine
• 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 コアバージョンとアクセシビリティ標準の更新

• 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