必要なすべてのコンポーネントを 1 台のコンピューターにインストールする
このシナリオでは、すべてのコンポーネントを 1 台のコンピューターにインストールします。このタイプのデプロイメントは、デモンストレーションやトレーニングとしての導入に最適であり、完全な実稼働環境向けではありません。
このタスクについて
- AppScan Enterprise のライセンス情報
- MHS を介した HCL AppScan Enterprise でのライセンス構成
- HCL® AppScan® Enterprise Server のインストール
- 構成ウィザードを実行してフィンガープリント・キーを取得する
- ライセンス・ファイルの生成と適用
- 構成ウィザードの完了
- デフォルト設定ウィザードの実行
- HCL Dynamic Analysis Scanner のインストール
- 構成ウィザードの実行
- Enterprise Console のインストールの検証
- このシナリオでは、AppScan® Enterprise Server の構成中に重要な情報を使用できるように、SQL Server データベースがインストールおよび構成されていることを前提としています。
- 以前のバージョンの AppScan Enterprise からアップグレードする場合は、アップグレードを開始する前に Jazz Team Server から WebSphere Liberty への置き換え - よくある質問 をお読みください。
- Jazz Team Users ユーザーをこの新しい認証方式に移行するには、v9.0.1 へのアップグレードを開始する前に、cd <install-dir>\Appscan Enterpise\JazzTeamServer\server\ repotools-jts.bat -exportUsers toFile=C:\users.csv repositoryURL=https://<hostname>:9443/jts を使用してユーザーの .csv ファイルをエクスポートしてください。その後、トピック「Liberty プロファイルの基本ユーザー・レジストリーの構成」の手順に従って、ユーザーを Liberty にインポートします。
AppScan® Enterprise のライセンス情報
AppScan Enterprise 10.8.0 では、FlexNet ライセンス (FNO) がサポートされなくなりました。代わりに、ライセンスは My HCLSoftware (MHS) ポータルを通じて構成する必要があります。この変更により、AppScan Enterprise はアプリケーション内でライセンスを管理するようになり、ローカル・ライセンス・サーバー (LLS) およびクラウド・ライセンス・サーバー (CLS) への依存がなくなりました。AppScan Enterprise 10.6.0 以前からアップグレードする場合は、ローカル・ライセンス・サーバー (LLS) を使用停止にしてください。LLS のアンインストール手順については、KB 記事 KB0119306 を参照してください。MHS ポータルの詳細については、MHS ヘルプを参照してください。
MHS を介した HCL® AppScan® Enterprise でのライセンス構成
このタスクでは、デプロイメントの作成や機能の割り振りなど、My HCLSoftware (MHS) ポータルを介して HCL AppScan Enterprise のライセンスを構成する手順について説明します。
始める前に
手順
-
MHS でデプロイメントを作成します:
- に移動します。
- Create Deployment をクリックします。
- デプロイメント名を入力し、製品リストから AppScan Enterprise を選択します。
- Add Deployment をクリックします。
-
デプロイメントに機能を割り振ります:
HCL® AppScan® Enterprise Server のインストール
この手順を使用して、レポートおよびユーザー管理タスクのためのユーザー管理コンポーネントと Enterprise Console をインストールします。
始める前に
手順
-
圧縮ファイル (AppScanEnterpriseServerSetup_<version>.zip) をダウンロードしたディレクトリーに移動し、ファイルを解凍して、AppScanEnterpriseServerSetup_<version>.exe ファイルをダブルクリックします。
注:次の画面が表示されるまでに時間がかかる場合があります。圧縮ファイルには以下のファイルが含まれています:
- AppScanEnterpriseServerSetup_<version>.exe
- HCL AppScan Enterprise Server.msi - このファイルは実行しないでください
- Data1.cab
- セットアップ・ウィザードの「ようこそ」画面で、「次へ」をクリックします。
- 「使用許諾契約」ウィンドウで、「使用許諾契約の条項に同意します」オプションを選択し、「次へ」をクリックします。
-
「宛先フォルダー」ウィンドウで、次のいずれかの操作を行ってから「次へ」をクリックします:
- デフォルトのインストール場所を受け入れるには、「次へ」をクリックします。
- 別のインストール場所を選択するには、「変更」をクリックします。
- 「プログラムをインストールする準備ができました」ウィンドウで、「インストール」をクリックしてインストールを続行します。
- 「セットアップ ウィザードが完了しました」画面で、「完了」をクリックして構成ウィザードを起動します。
構成ウィザードを実行してフィンガープリント・キーを取得する
Server または Scanner をインストールまたはアップグレードした後、インストールされた各コンポーネントを構成し、すべてのインスタンスとすべてのサーバーで構成ウィザードを実行する必要があります。AppScan Enterprise はライセンスに MHS を使用します。ライセンス・プロセスにはフィンガープリント・キーが必要であり、これは構成ウィザードの実行時に生成されます。ウィザードを実行する前にこのキーを生成する必要がある場合は、AppScan Enterprise 用のマシン・フィンガープリントの生成で説明されているスタンドアロン・ユーティリティーを使用できます。
始める前に
- 構成中に、使用する SQL Server データベースの名前と場所、およびサービス・アカウント名とパスワードを定義します。構成ウィザードを実行するユーザーには、データベースを作成し、権限を付与する機能が必要です。
- "**WARNING** Unable to configure virtual directory "ase" for local directory "C:\Program Files (x86)\HCL\AppScan Enterprise\WebApp" というエラーが発生した場合。IIS が正しく構成されていることを確認して再試行するか、構成ウィザードの実行中にウイルス対策ソフトウェアを無効にすることを検討してください。ウイルス対策ソフトウェアを無効にしたくない場合は、ウイルス対策の構成から AppScan Enterprise フォルダーを除外して、構成ウィザードを再度実行してください。重要:AppScan Enterprise が実行されているのと同じコンピューターで実行されているパーソナル・ファイアウォールやウイルス対策プログラムは、通信をブロックし、インストールおよび構成中に構成の失敗を引き起こす可能性があります。また、スキャンの実行中に結果が不正確になったり、パフォーマンスが低下したりする原因にもなります。最良の結果を得るには、コンピューターでファイアウォールやウイルス対策を実行しないでください。
手順
- インストールが完了すると、構成ウィザードが自動的に起動します。管理者として Windows™ の「スタート」メニューから「Configuration Wizard」を選択して起動することもできます。
- 「ようこそ」画面で、「次へ」をクリックします。
-
「ライセンス・サーバー」ウィンドウで、画面に表示されているフィンガープリント・キーをコピーします。このキーはお使いのマシンに固有のものであり、有効なライセンスを生成するために必要です。

ライセンス・ファイルの生成と適用
このタスクでは、AppScan Enterprise のライセンス・ファイルの生成、構成、配置を含む、ライセンス・ファイルを生成および適用する手順について説明します。
始める前に
手順
-
ライセンス・ファイルの生成:
- に移動します。
- 既存のデプロイメントを見つけ、デプロイメントの横にある 3 点メニューをクリックします。
- Download License File をクリックします。
- 「Download License File」ウィンドウで、フィンガープリント・キー (構成ウィザードまたはスタンドアロン・ユーティリティーからコピーしたもの) を貼り付けます。
- 完了したら、Submit をクリックしてライセンス・ファイルをダウンロードします。
-
ライセンス・ファイルの適用:
- ダウンロードしたライセンス・ファイルを AppScan インストール・ディレクトリー (例: C:\Program Files (x86)\HCL\AppScan Enterprise) にコピーします。
- ファイル名は AppScanEnterprise_License.license である必要があります。
注:AppScanEnterprise_License ファイルが変更された場合 (ライセンスの有効期限切れやその他の変更など)、AppScan Enterprise は更新を自動的に認識しません。適切な機能を確保するには、ライセンス・ファイルを変更した後、AppScan Enterprise サービスを再起動してください。
構成ウィザードの完了
ライセンスを適用した後、手順に従って AppScan Enterprise の構成を完了します。インストールされた各コンポーネントを構成し、すべてのインスタンスとすべてのサーバーで構成ウィザードを実行する必要があります。
始める前に
手順
- 管理者として Windows™ の「スタート」メニューから、またはインストール・ディレクトリー (例: C:\Program Files (x86)\HCL\AppScan Enterprise\WFCfgWiz.exe) から、構成ウィザードを再度開きます。
- 「ようこそ」画面で、「次へ」をクリックします。
-
「ライセンス・サーバー」ウィンドウで、「次へ」をクリックします。

-
「サーバー・コンポーネント」ウィンドウで、構成するコンポーネントを選択します。利用可能なコンポーネントはライセンスによって異なります。サーバー・コンポーネントを参照してください。コンポーネントを 1 台のマシンにインストールする場合は、以前にコンポーネントの 1 つをインストールしていた場合でも、すべてのチェック・ボックスを選択してください。

-
「インスタンス名」ウィンドウで、構成するインスタンスの名前を指定します。インスタンス名を参照してください。

-
「サービス・アカウント」ウィンドウで、「ドメイン/ユーザー名 サービス・アカウント」とパスワードを入力し、「次へ」をクリックします。サービス・アカウントを参照してください。

-
「データベース接続」ウィンドウで、SQL Server 名、ポート番号を入力し、認証モードと接続先のデータベース名を選択します。SQL 認証を選択した場合は、ユーザー名とパスワードを入力してから、「接続のテスト」をクリックして SQL Server に接続できることを確認します。接続が成功するまで、構成ウィザードは続行されません。AppScan® Enterprise Server が SQL Server にデータベースを作成すると、照合順序が自動的に構成されます。

注:- AppScan Enterprise は、SQL Database への接続で Windows 認証と SQL 認証をサポートしています。Microsoft の記事「認証モード」を参照し、あなたの要件に合った認証モードを選択してください。認証モードを別の認証モードに変更することはできますが、必ず構成ウィザードを再実行してください。
- ユーザーはSQLサーバーでsysadminサーバーロールを割り当てられる必要があります。ユーザーはデータベースへのアクセスを持ち、最低でもdb_ddladmin、db_datawriter、およびdb_datareaderの権限、またはdb_ownerの権限を付与されなければなりません。
- Liberty サポートの導入により、SQL Server 名の構文が変更されました。 ".\SQL_SERVER_NAME" は機能しなくなりました。代わりに "HOSTNAME\SQL_SERVER_NAME" を使用してください。
- v8.6 以前から既存のデータベースをアップグレードする場合は、次の画面で「データベース・マスター・キーのパスワード」を入力してアクセスします。このパスワードは安全な場所に保管してください。
- 環境で AppScan Enterprise データベースに名前付き SQL Server インスタンスを使用している場合は、SQL Server 構成マネージャーで TCP/IP が有効になっていることを確認し、SQL Server の SQL サービスを再起動してください。デフォルトのポート番号 (1433) の代わりに、名前付き SQL Server インスタンスのポート番号を使用してください。
-
「サーバー証明書」ウィンドウで、組織に固有の証明書を選択します。この手順は、環境にセキュアな AppScan® Enterprise をデプロイするのに役立ちます。サーバー証明書を参照してください。

-
(アップグレードのみ) 「AppScan Server 設定の復元」画面では、以前の AppScan Server カスタマイズ設定を Liberty サーバー (デフォルト) に復元することを選択できます。この画面はアップグレード時に一度だけ表示されます。後で構成ウィザードを実行した場合、この画面は表示されません。AppScan Server の設定の復元を参照してください。
-
「サーバー・キーストア」画面で、Enterprise Console で使用されるサーバー・キーストアを選択します。.pfx ファイルをエクスポートした場合は、Public key cryptography standards #12 (PKCS #12) を選択します。.pfx ファイルを保存した場所を参照してインポートし、ファイルのエクスポート時に作成したパスワードを入力します。サーバー鍵ストアを参照してください。

-
「認証メカニズム」ウィンドウで、Enterprise Console へのログインに使用する「認証メカニズム」を選択します。デフォルトでは、Windows™ を介して認証します。LDAP を使用するには、認証メカニズムを参照してください。

注:共通アクセス・カード (CAC) で認証する必要がある場合は、認証メカニズムとして必ず LDAP を選択してください。AppScan Enterprise の構成が完了したら、Common Access Card (CAC) による認証の手順に従って CAC で認証します。 -
「サーバー構成」ウィンドウで、
- AppScan Server が使用する Liberty サーバーのホスト名とポートを構成します。Windows 認証を使用している場合は、ホスト名の前にドメイン名を付けてください。
- 推奨される方法ではありませんが、スキャン中に無効な証明書または信頼できない証明書を使用した SSL 接続を許可することができます。このオプションが無効になっている場合、安全でないサーバーにスキャンのために到達できないことを示すメッセージがスキャン・ログに表示されます。このオプションは、手動探査機能にも影響します。
-
: 「修正方法サービス・ポート」 (Enterprise Console とともにインストールされる) を構成します。このポートは HTTP 上で実行され、ASRA サーバーが「修正方法」を提供するために使用します。「修正方法」は、アプリケーションの問題の「この問題について」ページに表示され、修正の推奨事項を提供します。9444 が既に使用されている場合は、別のポートを選択できます。
-
(アップグレードのみ) 「データベース暗号化の変更」ウィンドウで、「ヘルプ」をクリックして、データベースがある SQL Server を保護する方法を確認します。TDE を有効にしない場合は、構成を続行できるようにチェック・ボックスを選択します。

注:AppScan® Enterprise は、SQL Server 2016 以降で使用可能な透過的なデータ暗号化 (TDE) テクノロジーを使用します。TDE は、データベースまたは物理メディア上のバックアップに保存されているデータを暗号化します。古いバージョンの SQL Server を使用している場合、そのデータベースに含まれるデータは、不正アクセスによる侵害のリスクにさらされています。 -
「製品管理者」ウィンドウで、製品管理者としてユーザーを指定します。このユーザーは個別にライセンスが付与されます。製品管理者ライセンスを再割り当てする場合は、構成ウィザードを再実行する必要があります。製品管理者を参照してください。

-
データベースに誰もアクセスしていないことを確認し、「仕様の完了」ウィンドウで「完了」をクリックして構成を完了します。このプロセスには時間がかかる場合があります。
注:
- Windows™ Server 上の IIS AppPool 設定は、構成中に設定されます:
- IIS のリサイクルは午前 2:00 に設定されます
- アイドル・タイムアウトは 120 分に設定されます
- プロキシー・サーバー証明書を構成できないというエラー・メッセージが表示される場合は、有効期限が切れている可能性があります。製品管理者に連絡して詳しく調査してください。
- Windows™ Server 上の IIS AppPool 設定は、構成中に設定されます:
- オプション:
「サービスの開始」チェック・ボックスを選択して、サービスを自動的に開始します。
注:エージェント・サービスの自動開始を選択しない場合、エージェントはユーザーによって作成されたジョブを取得しません。管理ツールを使用してサービスを手動で開始できます。エージェント・サービスおよび警告サービスのインストールの検証を参照してください。
- 「デフォルト設定ウィザード」を実行します。このウィザードは、多数の構成可能なオプションのデフォルトを提供することにより、サンプル・データをインストールするのに役立ちます。
- 「終了」をクリックします。
デフォルト設定ウィザードの実行
このウィザードは、多数の構成可能なオプションのデフォルトを提供することにより、サンプル・データをインストールするのに役立ちます。ユーザーの作成、セキュリティー・テスト・ポリシーの追加、スキャン・テンプレートの作成、作成済みダッシュボードの追加、および Rational® Quality Manager または Rational® Team Concert との不具合トラッキング統合の構成を行うことができます。
このタスクについて
手順
- 「ようこそ」ページで、更新するインスタンスを選択し、「次へ」をクリックします。
- 「初期化タイプ」ウィンドウで、利用可能な初期化のいずれかを選択し、「次へ」をクリックします。
-
「デフォルト設定」ウィンドウで、以下のオプションを構成し、「次へ」をクリックします:
-
(Windows™ 認証のみ): LDAP サーバーを使用する場合は、「LDAP 設定」ページで「LDAP を有効にする」チェック・ボックスを選択します。
- 「サーバー名」フィールドに、LDAP グループ名を入力します。
- 「グループ照会」フィールドに、ユーザー・グループ情報の取得に使用するグループ照会のパスを入力します。LDAP サーバーまたは Active Directory サーバーを使用できます。
- オプション: 匿名アクセスを使用して LDAP サーバーと統合する場合は、「匿名アクセス」チェック・ボックスを選択します。このオプションはデフォルトで無効になっています。
- 「LDAP のテスト」をクリックして、構成が機能することを確認します。
- 「IP セキュリティー権限」ページで、スキャンを許可する IP アドレスと範囲を構成します。ダッシュを使用して IPv4 範囲 (1.2.3.4 - など) を定義し、プレフィックスを使用して IPv6 範囲 (fe80::/10 など) を定義します。
- 「サンプル・データのデータベースへの取り込み」ページで、「サンプル・データの取り込み」チェック・ボックスを選択して、スキャン・テンプレート、作成済みダッシュボード、サーバー・グループ、およびテスト・ポリシーをデータベースに取り込みます。
- 「次へ」をクリックします。「デフォルト設定ウィザードの進行状況」ページが開き、セットアップの進行状況が表示されます。
- ウィザードが完了すると、「デフォルト設定ウィザードの完了」ページが開きます。
- 「終了」をクリックしてウィザードを閉じます。
HCL® Dynamic Analysis Scanner のインストール
この手順を使用して、Web サイト・アプリケーションのスキャンとテストに使用されるエージェントをインストールします。
始める前に
- インストール中に使用するユーザー・アカウントを確認するために、必ず インストールおよび構成の際に必要なユーザー・アカウント情報 をお読みください。
- Web サイトで使用するテクノロジーは、Scanner とともにインストールする必要もあります。たとえば、Web ページで Flash を使用する場合は、正しいバージョンの Flash をインストールする必要があります。
手順
-
実行可能ファイル (ASE_DASSetup_<version>.exe) をダウンロードしたディレクトリーに移動し、ファイルをダブルクリックします。
注:次の画面が表示されるまでに時間がかかる場合があります。
- 「使用許諾契約」ウィンドウで、「使用許諾契約の条項に同意します」オプションを選択し、「次へ」をクリックします。
- 「宛先フォルダー」ウィンドウで、「次へ」をクリックします。
- 「プログラムをインストールする準備ができました」ウィンドウで、「インストール」をクリックしてインストールを続行し、「完了」をクリックします。
構成ウィザードの実行
Server または Scanner をインストールまたはアップグレードした後、インストールされた各コンポーネントを構成し、すべてのインスタンスとすべてのサーバーで構成ウィザードを実行する必要があります。
始める前に
- 構成中に、使用する SQL Server データベースの名前と場所、およびサービス・アカウント名とパスワードを定義します。構成ウィザードを実行するユーザーには、データベースを作成し、権限を付与する機能が必要です。
- AppScan® Enterprise Server のインストール後にウィザードを実行すると、SQL Server 上にデータベースがセットアップされ、コンポーネントの初期セットアップが行われます。
- Dynamic Analysis Scanner のインストール後にウィザードを実行すると、Scanner が AppScan® Enterprise Server に登録されます。
- ライセンス・ファイル (AppScanEnterprise_License) が AppScan インストール・ディレクトリー (例: C:\Program Files (x86)\HCL\AppScan Enterprise) に配置されていることを確認してください。ライセンス・ファイルの生成と適用を参照してください。
手順
- インストールが完了すると、構成ウィザードが自動的に起動します。管理者として Windows™ の「スタート」メニューから「Configuration Wizard」を選択して起動することもできます。
- 「ようこそ」画面で、「次へ」をクリックします。
-
「ライセンス・サーバー」ウィンドウで、「次へ」をクリックします。

-
「サーバー・コンポーネント」ウィンドウで、構成するコンポーネントを選択します。利用可能なコンポーネントはライセンスによって異なります。サーバー・コンポーネントを参照してください。コンポーネントを 1 台のマシンにインストールする場合は、以前にコンポーネントの 1 つをインストールしていた場合でも、すべてのチェック・ボックスを選択してください。

-
「インスタンス名」ウィンドウで、構成するインスタンスの名前を指定します。インスタンス名を参照してください。

-
「サービス・アカウント」ウィンドウで、「ドメイン/ユーザー名 サービス・アカウント」とパスワードを入力し、「次へ」をクリックします。サービス・アカウントを参照してください。

-
「データベース接続」ウィンドウで、SQL Server 名、ポート番号を入力し、認証モードと接続先のデータベース名を選択します。SQL 認証を選択した場合は、ユーザー名とパスワードを入力してから、「接続のテスト」をクリックして SQL Server に接続できることを確認します。接続が成功するまで、構成ウィザードは続行されません。AppScan® Enterprise Server が SQL Server にデータベースを作成すると、照合順序が自動的に構成されます。

注:- AppScan Enterprise は、SQL Database への接続で Windows 認証と SQL 認証をサポートしています。Microsoft の記事「認証モード」を参照し、あなたの要件に合った認証モードを選択してください。認証モードを別の認証モードに変更することはできますが、必ず構成ウィザードを再実行してください。
- ユーザーはSQLサーバーでsysadminサーバーロールを割り当てられる必要があります。ユーザーはデータベースへのアクセスを持ち、最低でもdb_ddladmin、db_datawriter、およびdb_datareaderの権限、またはdb_ownerの権限を付与されなければなりません。
- v8.6 以前から既存のデータベースをアップグレードする場合は、次の画面で「データベース・マスター・キーのパスワード」を入力してアクセスします。このパスワードは安全な場所に保管してください。
- 環境で AppScan Enterprise データベースに名前付き SQL Server インスタンスを使用している場合は、SQL Server 構成マネージャーで TCP/IP が有効になっていることを確認し、SQL Server の SQL サービスを再起動してください。デフォルトのポート番号 (1433) の代わりに、名前付き SQL Server インスタンスのポート番号を使用してください。
-
(アップグレードのみ) 「データベース暗号化の変更」ウィンドウで、「ヘルプ」をクリックして、データベースがある SQL Server を保護する方法を確認します。TDE を有効にしない場合は、構成を続行できるようにチェック・ボックスを選択します。

注:AppScan® Enterprise は、SQL Server 2016 以降で使用可能な透過的なデータ暗号化 (TDE) テクノロジーを使用します。TDE は、データベースまたは物理メディア上のバックアップに保存されているデータを暗号化します。古いバージョンの SQL Server を使用している場合、そのデータベースに含まれるデータは、不正アクセスによる侵害のリスクにさらされています。 -
データベースに誰もアクセスしていないことを確認し、「仕様の完了」ウィンドウで「完了」をクリックして構成を完了します。このプロセスには時間がかかる場合があります。
注:
- Windows™ Server 上の IIS AppPool 設定は、構成中に設定されます:
- IIS のリサイクルは午前 2:00 に設定されます
- アイドル・タイムアウトは 120 分に設定されます
- プロキシー・サーバー証明書を構成できないというエラー・メッセージが表示される場合は、有効期限が切れている可能性があります。製品管理者に連絡して詳しく調査してください。
- Windows™ Server 上の IIS AppPool 設定は、構成中に設定されます:
- オプション:
「サービスの開始」チェック・ボックスを選択して、サービスを自動的に開始します。
注:エージェント・サービスの自動開始を選択しない場合、エージェントはユーザーによって作成されたジョブを取得しません。管理ツールを使用してサービスを手動で開始できます。エージェント・サービスおよび警告サービスのインストールの検証を参照してください。
- 「終了」をクリックします。
Enterprise Console のインストールの検証
インストール・プロセスが完了したら、Enterprise Console のインストールを検証できます。