単一のコンピューターへの必要なすべてのコンポーネントのインストール
このシナリオでは、すべてのコンポーネントを単一のコンピューターにインストールします。このタイプのデプロイメントは、完全な実稼働環境ではなく、デモンストレーションや研修のデプロイメントに最適です。
このタスクについて
- AppScanEnterprise のライセンス情報
- HCLでのライセンスの設定AppScanEnterprise MHSの経由
- HCL®AppScan®Enterpriseサーバーのインストール
- 設定ウィザードを実行してフィンガープリントキーを取得する
- ライセンスファイルの生成と適用
- 設定ウィザードの完了
- デフォルト設定ウィザードの実行
- HCL Dynamic Analysis Scanner のインストール
- 構成ウィザードの実行
- Enterprise Console のインストールの検証
- このシナリオでは、SQL Serverデータベースがインストールされ、AppScan® エンタープライズサーバーの構成中に重要な情報が利用可能になるように設定されていることを前提としています。
- 旧バージョンの 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) を廃止します。KB0119306の記事を参照して、LLSのアンインストール手順を確認してください。MHSポータルについて詳しく知るには、MHSヘルプを参照してください。
HCL®でのライセンスの設定AppScan®Enterprise MHSの経由
HCL AppScan Enterprise のライセンスを設定する手順には、My HCLSoftware (MHS) ポータルを通じて、デプロイメントの作成と機能の割り当てが含まれます。
始める前に
手順
-
MHSでデプロイメントを作成する:
- に移動してください。
- 「デプロイメントの作成」をクリックします。
- デプロイメント名を入力し、製品リストからAppScan Enterpriseを選択してください。
- 「デプロイメントを追加」をクリックします。
-
展開に機能を割り当てる:
HCL®AppScan®Enterpriseサーバーのインストール
レポート作成タスクおよびユーザー管理タスクのためにユーザーの管理コンポーネントおよび Enterprise Console をインストールするには、以下の手順を使用します。
始める前に
手順
-
圧縮ファイルをダウンロードしたディレクトリに移動します( AppScanEnterpriseServerSetup_<version>.zip ) からファイルを解凍し、 AppScanEnterpriseServerSetup_<バージョン>.exeファイル。
注:次の画面が表示されるまでに時間がかかる場合があります。圧縮ファイルには、次のファイルが含まれています。
- AppScanEnterpriseServerSetup_<バージョン>.exe
- HCL AppScan Enterprise Server.msi - このファイルを実行しないでください
- データ1.cab
- セットアップ・ウィザードのウェルカム画面で、「次へ」をクリックします。
- 「ご使用条件」ウィンドウで、「使用条件の条項に同意します」オプションを選択し、「次へ」をクリックします。
-
「宛先フォルダー」ウィンドウで、次のいずれかのアクションを実行して、「次へ」をクリックします。
- 「次へ」をクリックして、デフォルトのインストール場所を受け入れます。
- 「変更」をクリックして、別のインストール場所を選択します。
- 「プログラムのインストール準備の完了」ウィンドウで、「インストール」をクリックしてインストールを進めます。
- 「セットアップ・ウィザードの完了」画面で「終了」をクリックすると、構成ウィザードが起動します。
設定ウィザードを実行してフィンガープリントキーを取得する
サーバーまたはスキャナーをインストールまたはアップグレードした後、各インストール済みコンポーネントを構成し、すべてのインスタンスとすべてのサーバーで構成ウィザードを実行する必要があります。AppScan EnterpriseはライセンスにMHSを使用しています。ライセンスプロセスには、構成ウィザードを実行する際に生成される指紋キーが必要です。ウィザードを実行する前にこのキーを生成する必要がある場合は、「AppScan Enterpriseのためのマシンフィンガープリントの生成」に記載されているスタンドアロンユーティリティを使用できます。
始める前に
- 構成時に、使用する SQL Server データベースの名前と場所、およびサービス・アカウント名とパスワードを定義します。構成ウィザードを実行するユーザーは、データベースを作成して権限を付与することができる必要があります。
- エラー「**警告** ローカルディレクトリ「C:\Program Files (x86)\HCL\AppScan Enterprise\WebApp」の仮想ディレクトリ「ase」を構成できません」が発生した場合。IIS が正しく構成されていることを確認し、再試行してください」が発生した場合は、構成ウィザードの実行中にアンチウィルス・ソフトウェアを無効にすることを検討してください。アンチウィルス・ソフトウェアを無効にしたくない場合は、AppScan Enterprise フォルダーをアンチウィルス構成から除外してから、構成ウィザードを再度実行することができます。重要:AppScan Enterprise が実行されているのと同じコンピューターでパーソナル・ファイアウォールおよびアンチウィルス・プログラムが実行されている場合、通信がブロックされ、その結果、インストールおよび構成時に構成が失敗することがあります。また、スキャンを実行すると、不正確な結果が生成され、パフォーマンスが低下します。最良の結果を得るため、コンピューターでファイアウォールやアンチウィルスを実行しないでください。
手順
- インストールが完了すると、構成ウィザードが自動的に起動します。管理者としてWindowsスタート™メニューから構成ウィザードを選択して開始することもできます。
- ウェルカム画面で「次へ」をクリックします。
-
ライセンスサーバーウィンドウで、画面に表示されているフィンガープリントキーをコピーしてください。このキーはマシンに固有のものであり、有効なライセンスを生成するために必要です。

ライセンスファイルの生成と適用
ライセンスファイルを生成して適用する手順は、AppScan Enterpriseのためのものであり、ライセンスファイルの生成、設定、および配置を含みます。
始める前に
手順
-
ライセンスファイルを生成する:
- にアクセスする。
- 既存のデプロイメントを見つけ、そのデプロイメントの横にある三点メニューをクリックします。
- 「ライセンスファイルをダウンロードをクリックします。」
- ダウンロードライセンスファイルウィンドウで、フィンガープリントキー(構成ウィザードまたはスタンドアロンユーティリティからコピーしたもの)を貼り付けます。
- 完了したら、送信をクリックしてライセンスファイルをダウンロードしてください。
-
ライセンスファイルの適用:
- ダウンロードしたライセンスファイルを 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つをインストールしていたとしても、すべてのチェックボックスを選択してください。

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

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

-
「データベース接続」ウィンドウで、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のサービスを再起動してください。デフォルトのポート番号 (1433) の代わりに、名前付き SQL Server インスタンスのポート番号を使用します。
-
「サーバー証明書」ウィンドウで、組織に固有の証明書を選択します。このステップは、環境に安全なAppScan®Enterpriseを展開するのに役立ちます。『サーバー証明書』を参照してください。

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

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

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

注:AppScan® Enterpriseは、SQL Server 2014以降で利用可能な透過的データ暗号化(TDE)技術を使用しています。TDE は、データベースまたは物理メディアのバックアップに保管されているデータを暗号化します。古いバージョンの SQL Server を使用している場合、そのデータベース内に含まれるデータは無許可アクセスによるセキュリティー侵害のリスクにさらされます。 -
製品管理者ウィンドウで、ユーザーを製品管理者として指定します。このユーザーは別途ライセンスを受けます。製品管理者ライセンスを再度割り当てる場合は、構成ウィザードを再実行する必要があります。『製品管理者』を参照してください。

-
データベースにアクセスしているユーザーがいないことを確認し、「指定完了」ウィンドウで「終了」をクリックして、構成を完了します。このプロセスには時間がかかるかもしれません。
注:
-
Windows™ Server 上の IIS AppPool 設定は構成中に設定されます。
- IIS リサイクルは 2:00am に設定されます
- アイドル・タイムアウトは 120 分に設定されます
- プロキシー・サーバー証明書を構成できないというエラー・メッセージが表示される場合は、この証明書の有効期限が切れている可能性があります。製品管理者に連絡して詳しく調査してください。
-
Windows™ Server 上の IIS AppPool 設定は構成中に設定されます。
- オプション:
サービスを自動的に開始するには「サービスの開始」チェック・ボックスを選択します。
注:エージェント・サービスを自動的に開始することを選択しない場合、ユーザーが作成したジョブは、エージェントによって選出されません。管理ツールを使用して手動でサービスを開始することができます。エージェント・サービスおよび警告サービスのインストールの検証を参照してください。
- デフォルト設定ウィザードを実行します。このウィザードはいくつかの構成可能なオプションにデフォルト値を与えるので、サンプル・データのインストールに役立ちます。
- 「終了」をクリックします。
デフォルト設定ウィザードの実行
このウィザードはいくつかの構成可能なオプションにデフォルト値を与えるので、サンプル・データのインストールに役立ちます。ユーザーを作成し、セキュリティテストポリシーを追加し、スキャンテンプレートを作成し、事前に作成されたダッシュボードを追加し、Rational® Quality Manager または Rational® Team Concert と欠陥追跡の統合を構成できます。
このタスクについて
手順
- ウェルカム・ページで、更新するインスタンスを選択し、「次へ」をクリックします。
- 「初期化タイプ」ウィンドウで、使用可能な初期化の 1 つを選択し、「次へ」をクリックします。
-
「デフォルト設定」ウィンドウで、以下のオプションを構成し、「次へ」をクリックします。
-
(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) が保存されているディレクトリに移動し、そのファイルをダブルクリックしてください。
注:次の画面が表示されるまでに時間がかかる場合があります。
- 「ご使用条件」ウィンドウで、「使用条件の条項に同意します」オプションを選択し、「次へ」をクリックします。
- 「宛先フォルダー」ウィンドウで、「次へ」をクリックします。
- 「プログラムのインストール準備の完了」ウィンドウで、「インストール」をクリックしてインストールを進めていき、その後「終了」をクリックします。
構成ウィザードの実行
サーバーまたはスキャナーをインストールまたはアップグレードした後、各インストール済みコンポーネントを構成し、すべてのインスタンスとすべてのサーバーで構成ウィザードを実行する必要があります。
始める前に
- 構成時に、使用する SQL Server データベースの名前と場所、およびサービス・アカウント名とパスワードを定義します。構成ウィザードを実行するユーザーは、データベースを作成して権限を付与することができる必要があります。
- インストール後にウィザードを実行すると、AppScan® エンタープライズサーバーがSQLサーバー上でデータベースを設定し、コンポーネントの初期設定を行います。
- ダイナミック分析スキャナーをインストールした後、ウィザードを実行すると、スキャナーがAppScan®エンタープライズサーバーに登録されます。
- ライセンスファイル (AppScanEnterprise_License) が AppScan インストールディレクトリ (例: C:\Program Files (x86)\HCL\AppScan Enterprise) に配置されていることを確認してください。「ライセンスファイルの生成と適用」を参照してください。
手順
- インストールが完了すると、構成ウィザードが自動的に起動します。構成ウィザードをWindows™スタートメニューから選択して開始することもできます。
- ウェルカム画面で「次へ」をクリックします。
-
ライセンスサーバーウィンドウで、次へをクリックします。

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

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

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

-
「データベース接続」ウィンドウで、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のサービスを再起動してください。デフォルトのポート番号 (1433) の代わりに、名前付き SQL Server インスタンスのポート番号を使用します。
-
(アップグレードのみ) データベース暗号化の変更 ウィンドウで、ヘルプ をクリックして、データベースが配置されている SQL Server を保護する方法を学びます。TDE を有効にしない場合には、チェック・ボックスを選択すると続けて構成することができます。

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