コンテンツにスキップ

Zeta Test Management Webをインストールおよび設定してください。

Zeta Test Management Web はブラウザから中央管理されたテストプロジェクトへのアクセスを提供します。現在のアプリケーションは ASP.NET Core と .NET 10 をベースにしています。WebインターフェースとWindowsアプリケーションは同じプロジェクトを使用し、テスト管理のドメインタスクをカバーします。ローカルのOS機能はブラウザ対応のワークフローまたは承認済みのローカルブリッジを使用します。

中央の本番展開にはIISパッケージzetatest-web.zipを使用してください。 別のウェブEXEセットアップはローカルデモまたは単一ユーザーインスタンスをKestrelで起動します。これはセキュアなIISインストールの代替ではありません。

このガイドでは、展開の選択、IISとHTTPS、最小権限の権限設定、構成、更新、検証およびロールバックについて説明します。

展開モデルを選択し、準備してください

展開オプション

  • ローカルデモまたは単一ユーザーインスタンス:のWeb EXEセットアップはバンドルされたアプリケーションをKestrel経由でローカルに起動します。評価や個別のWindowsユーザー向けであり、中央の本番サーバーとしては使用しません。
  • 中央IIS展開:はWindows Server上でzetatest-web.zipを抽出し、そのWebsiteフォルダーをIISアプリケーションとして実行します。これは文書化された本番運用パスです。
  • リバースプロキシ: 管理されたプロキシはTLSを終了し、アプリケーションを公開できます。転送、信頼されたヘッダー、リダイレクトおよび完全なHTTPS経路を検証してください。

前提条件

  • 対象のZeta Test Managementリリースに承認されたWindows ServerとIISの組み合わせ;
  • IISサイト、アプリケーションプール、バインディングおよび証明書の管理者アクセス;
  • ASP.NET Core Module V2を含む対応する.NET 10ホスティングバンドル;
  • 安定したDNS名と信頼されたTLS証明書;
  • 置換可能なウェブサイトリリースフォルダー外のバックアップされたプロジェクトおよびデータベースストレージ;
  • 必要なファイルおよびデータベース権限のみを持つ専用の技術的識別子。

最初の展開前にバックアップ、復元、更新ウィンドウ、ロールバック所有者および代表的な受け入れプロジェクトを定義してください。

IISアプリケーションをインストールおよび設定してください。

  1. IISおよびリリースに対応した.NET 10 Hosting Bundleをインストールしてください。インストーラーが要求する場合は、IISまたはサーバーを再起動してください。
  2. zetatest-web.zipをステージングフォルダーに抽出します。IISの物理パスは含まれるWebsiteフォルダーを指します。
  3. 「No Managed Code」の専用IISアプリケーションプールを作成し、32ビットアプリケーションを無効にし、承認された技術的IDを割り当ててください。
  4. IISサイトまたはアプリケーションを作成してください。提供されたweb.configおよびそのAspNetCoreModuleV2構成を保持してください。
  5. プログラムフォルダーには読み取りおよび実行アクセスを付与し、承認されたプロジェクト、ユーザー保存、添付ファイルおよびログフォルダーには必要最小限の変更アクセスのみを付与してください。データベース権限は最小限にしてください。
  6. 本番DNS名と証明書のHTTPSバインディングを作成してください。HTTPは意図的なリダイレクトエンドポイントが必要な場合のみ残してください。
  7. Config.json、appsettings.json、およびクライアントとサーバーパスが異なる場合のみfoldermappings.jsonを設定します。
  8. アプリケーションプールとサイトを起動します。HTTPSでサインインし、プロジェクトリスト、権限、および代表的なテストワークフローを確認します。

重要な構成の境界

Config.jsonには、セミコロン区切りのprojectSearchFolderPathsなどのクラシックなZeta Test Management設定が含まれています。appsettings.jsonはHTTPS、クッキー、ログ記録、言語およびウェブ領域の制御を含むASP.NET Coreの動作を制御します。

{
  "AppSettings": {
    "UseHttpsRedirection": true,
    "AllowInsecureCookies": false,
    "ExperimentalWebAreas": {
      "Enabled": true,
      "DisabledAreas": []
    }
  }
}

これらの値は例示であり、展開トポロジーに一致する必要があります。serviceApiKeyおよびその他すべてのキーは秘密として扱ってください。プロジェクトファイル、設定、バックアップおよびログは静的ウェブサイトファイルとして決して公開してはいけません。IIS URL Rewriteは、独自のリダイレクトまたはプロキシ設定が必要な場合を除き、Zeta Test Managementの前提条件ではありません。

繰り返しのサインイン試行に対する保護

この保護には、それを含む更新されたWebサーバービルドが必要です。構成だけでは古いインストールに追加できません。

サーバー管理およびプロジェクトのパスワードサインインは、アカウントごとおよびIPアドレスごとに繰り返し失敗を制限します。5回の失敗までは遅延なしで許可されます。6回目の失敗で2秒の待機が始まり、その後の失敗で4秒、8秒と増加し、最大5分まで延長されます。成功したサインインはアカウントのカウンターのみをクリアします。IP制限は有効なアカウントでもリセットされません。

待機中、フォームはメッセージを表示し、Retry-After付きのHTTP 429を返します。正しいパスワードでも待機が終了するまで再確認できません。アカウントは永久に無効になりません。カウンターは許可された試行がない場合30分で期限切れになります。拒否されたリクエストは待機時間を延長しません。各IPは60秒あたり最大30回の許可された試行を許可し、20回目の失敗以降はIP遅延が増加します。多くのユーザーが1つの公開アドレスを共有する場合はこれらの共有制限を考慮してください。

appsettings.jsonでAppSettings.LoginProtectionを設定する:

{
  "AppSettings": {
    "LoginProtection": {
      "Enabled": true,
      "FreeAttempts": 5,
      "IpFreeAttempts": 20,
      "BaseDelaySeconds": 2,
      "MaxDelaySeconds": 300,
      "EntryExpirationMinutes": 30,
      "IpPermitLimit": 30,
      "IpWindowSeconds": 60,
      "MaxEntries": 10000,
      "InFlightSeconds": 120
    }
  }
}

InFlightSecondsは未完了のパスワードチェックの予約を制限します。同一アカウントの同時チェックは拒否されます。クラッシュしたプロセスによる予約は期限切れ後に失敗試行としてカウントされます。MaxEntriesは保存されたアカウントとIPエントリーを合わせて制限します。保持期間は最大遅延、IPウィンドウおよび予約寿命をカバーしなければなりません。不正な設定は拒否されます。設定変更後はウェブアプリケーションを再起動してください。

カウンターはプライベート管理データディレクトリのLoginProtectionサブフォルダーに永続化されます。AppSettings.LoginProtectionStateDirectoryはWebルート外の絶対パスでこれを上書きできます。1つのインストールの全ワーカーは同じ永続ディレクトリを共有し、変更権限を持つ必要があります。保存された識別子は派生値であり、平文のユーザー名やIPアドレスではありません。更新時にこの状態を削除しないでください。管理データディレクトリがアプリケーションディレクトリ内にある場合は、そのディレクトリを置き換える前に別の永続状態パスを設定してください。利用不可、容量不足、破損したストアはHTTP 503を返し、保護されていないパスワードチェックを許可しません。ディスク容量、権限、サーバーログを確認してください。

ファイル永続化は同一サーバー上のワーカー向けに設計されています。複数のウェブサーバーでは、信頼できる上流サービスでの追加の共有制限が必要です。リバースプロキシの背後では、ホスティング構成が信頼できる経路を通じて実際のクライアントIPを提供しなければなりません。任意のX-Forwarded-Forヘッダーは身元証明として受け入れられません。

この保護はアプリケーションのブラウザパスワードフォームを対象としています。WindowsからWebへのワンタイムトークンの引き渡し、明示的に設定されたパスワード不要のデモ、およびユーザー管理のないプロジェクトでは追加のパスワード入力は発生しません。APIキーおよび外部IDプロバイダーは別のセキュリティ境界を持ちます。スロットリングはHTTPS、強力なパスワード、保護されたサーバーアクセスの代替にはなりません。

更新、検証およびロールバック

すべてのウェブ更新を管理されたサーバー変更として扱ってください:

  1. プロジェクト、データベース、ウェブサイト設定および必要なログをバックアップしてください。現在の製品バージョンとアクティブなウェブサイトパスを記録してください。
  2. 新しいzetatest-web.zipを並列リリースフォルダーに抽出します。
  3. 新しいデフォルト構成を現在の環境と比較します。必要な値を意図的にマージし、古いConfig.json、appsettings.json、foldermappings*.jsonまたはweb.configを盲目的にコピーしないでください。
  4. アプリケーションプールを停止し、IISの物理パスを新しいWebsiteフォルダーに切り替え、プールを再起動します。
  5. HTTPS、サインイン、プロジェクトリスト、ロール、ファイルおよびデータベースアクセス、典型的なテスト実行および意図したウェブワークスペースを検証してください。Windowsイベントログおよび有効なアプリケーションログを確認してください。

ロールバックするには、プールを停止し、前のWebサイトパスを復元し、データ移行が必要な場合は対応するプロジェクトおよびデータベースのバックアップを復元してください。合意された受け入れ期間が終了するまで前のリリースフォルダーを保持してください。

通常の Web エリアはバージョン 6 でデフォルトで有効です。歴史的に名前付けされた ExperimentalWebAreas 設定は個別のエリアを無効にできます。その名前はすべての追加ワークスペースがプレビュー機能であることを意味しません。AI は別途設定と承認が必要です。

ブラウザワークフローの場合はWebアプリケーションでZeta Test Managementを使用します。に続けてください。コネクターおよびMCP設定については統合および自動化をご覧ください。

内部管理データベースと自動変換

ウェブアプリケーションは内部管理データ(サーバー設定、ユーザーマッピング、AI/CI管理データを含む)にSQLite(ztm.sqlite)を使用しています。プロジェクトデータベースは引き続きVistaDBまたはMicrosoft SQL Serverを使用し、この操作では変換されません。

既存のztm.sdfで初めて起動すると、サービスが管理データベースを自動的に変換します。最初に同じサーバーデータディレクトリにアクセスする古いWeb/バックエンドプロセスをすべて停止してください。メンテナンスウィンドウをスケジュールし、設定およびキーを含む完全なサーバーデータディレクトリをバックアップしてください。変換にはバックアップおよび新しいデータベース用の追加の空き容量が必要です。

サービスは既存ファイルをバックアップし、データをコピーおよび検証してからSQLiteを有効化します。これが成功するまで通常のリクエストは受け付けません。SQL Compactのソースは追加書き込みから保護されており、運用中にこの保護を解除しないでください。ztm.sdf、ztm.sdf.pre-sqlite.bakおよびSQLiteデータベースのアクティベーションレコードztm.sqlite.activationを保持してください。alternativeServerCentralDataStorageFolderPathで設定されたディレクトリは存在し書き込み可能でなければなりません。失敗した場合、別のディレクトリの空のデータベースにフォールバックしません。

変換に失敗すると、起動はブロックされたままになります。サーバーログ、空き容量、書き込み権限、残っている古いプロセスを確認してください。問題を修正した後、サービスを再起動すると、制御された変換プロセスが自動的に再開されます。変換記録を削除したり空のファイルを作成したりして、欠落または破損した完了済みデータベースを回避しないでください。

ネイティブSQLiteライブラリはWebパッケージに含まれています。個別のDLLをコピーするのではなく、対象のアーキテクチャ用の完全なパッケージを使用してください。古い管理データベースのインポートにはSQL Compactライブラリが依然として必要です。別途SQLiteの手動インストールは意図されていません。Webサーバーは引き続きWindowsを必要とし、このデータベースの変更はLinuxサポートを導入しません。

管理用データベースはウェブサーバーのローカルディスクに保管してください。サービスを停止した状態で、関連ファイルやキーを含めてバックアップを行ってください。古いソフトウェアに戻す場合は、サービスを停止し、一貫性のあるバックアップを復元してください。変換後にSQLiteで保存された変更は、古いSQL Compactのバックアップには含まれていません。