安裝所有所需的組件在一台電腦上
在此實務中,所有元件都安裝在一部電腦上。此類型的部署最適合示範或訓練部署,而不是完整正式作業環境。
About this task
- <uicontrol>AppScan Enterprise</uicontrol> 的許可信息
- 通過 <uicontrol>MHS</uicontrol> 在 <uicontrol>HCLAppScan Enterprise</uicontrol> 中配置許可
- 安裝 <ui®control®>HCLAppScan Enterprise Server</uicontrol>
- 運行配置嚮導以獲取指紋密鑰
- 生成並應用許可文件
- 完成配置嚮導
- 執行預設值精靈
- 安裝 HCL 動態分析掃描器
- 執行配置精靈
- 驗證 Enterprise Console 的安裝
- 此場景假設 <uicontrol>SQL Server</uicontrol> 數據庫已安裝並配置,以便在配置 <uicontrol>AppScan® Enterprise Server</uicontrol> 時可以獲取關鍵信息。
- 如果您是從 AppScan Enterprise 舊版升級,在開始升級之前,請閱讀將 Jazz Team Server 取代為 WebSphere。
- 要將 <uicontrol>Jazz Team Users</uicontrol> 用戶遷移到此新的身份驗證方法,請在升級到 v9.0.1 之前,使用 <menucascade><uicontrol>cd <install-dir>\Appscan Enterpise\JazzTeamServer\server\</uicontrol><uicontrol>repotools-jts.bat -exportUsers toFile=C:\users.csv repositoryURL=https://<hostname>:9443/jts</uicontrol></menucascade> 導出用戶的 .csv 文件。然後按照本主題中的步驟:為 <uicontrol>Liberty</uicontrol> 配置基本用戶註冊表以將用戶導入 <uicontrol>Liberty</uicontrol>。
<uicontrol>AppScan® Enterprise</uicontrol> 的許可信息
<uicontrol>AppScan Enterprise 10.8.0</uicontrol> 不再支持 <uicontrol>FlexNet</uicontrol> 許可 (FNO)。相反,必須通過 <uicontrol>My HCLSoftware (MHS)</uicontrol> 入口配置許可。隨著此更改,<uicontrol>AppScan Enterprise</uicontrol> 現在在應用程序內管理許可,消除了對本地許可服務器 (LLS) 和雲許可服務器 (CLS) 的依賴。如果從 <uicontrol>AppScan Enterprise 10.6.0</uicontrol> 或更早版本升級,請退役本地許可服務器 (LLS)。請參閱 KB 文章 <uicontrol>KB0119306</uicontrol> 以獲取卸載 LLS 的說明。要了解有關 <uicontrol>MHS</uicontrol> 入口的更多信息,請參閱 <uicontrol>MHS</uicontrol> 幫助。
通過 <uicontro®l>MHS</®uicontrol> 在 <uicontrol>HCLAppScan Enterprise</uicontrol> 中配置許可
此任務涵蓋了通過 My HCLSoftware (MHS) 入口網站配置 HCL AppScan Enterprise 授權的步驟,包括創建部署和分配功能。
Before you begin
Procedure
-
在 MHS 中創建部署:
- 導航至 <><uicontrol>MHS 入口網站</uicontrol><uicontrol>部署</uicontrol></menucascade>。
- 點擊<uicontrol>創建部署</uicontrol>。
- 輸入部署名稱,並從產品列表中選擇<uicontrol>AppScan Enterprise</uicontrol>。
- 按一下新增部署。
-
將功能分配給部署:
安裝 HCL®AppScan® Enterprise 服務器
使用此程序來安裝「使用者管理」元件和「企業主控台」以進行報告作業和使用者管理作業。
Before you begin
Procedure
-
前往下載壓縮檔案 (AppScanEnterpriseServerSetup_<version>.zip) 的目錄,解壓縮檔案,然後雙擊 AppScanEnterpriseServerSetup_<version>.exe 檔案。
Note:顯示下一個畫面可能需要一點時間。此壓縮檔包含這些檔案:
- AppScanEnterpriseServerSetup_<version>.exe
- HCL AppScan Enterprise Server.msi - 不要執行此檔案
- Data1.cab
- 在「安裝」精靈的歡迎使用畫面中,按下一步。
- 在授權合約視窗中,選取我接受授權合約中的條款選項,然後按下一步。
-
在目的地資料夾視窗中,執行下列其中一項動作,然後按下一步:
- 按下一步以接受預設安裝位置。
- 按一下變更來選取不同的安裝位置。
- 在備妥可安裝程式視窗中,按一下安裝來繼續進行安裝。
- 在「安裝精靈已完成」畫面中,按一下完成以啟動「配置精靈」。
運行配置嚮導以獲取指紋密鑰
安裝或升級伺服器或掃描器後,必須配置每個已安裝的組件,並在所有實例和所有伺服器上運行配置嚮導。AppScan Enterprise 使用 MHS 進行授權。授權過程需要指紋密鑰,該密鑰是在運行配置嚮導時生成的。如果需要在運行嚮導之前生成此密鑰,可以使用在為 AppScan Enterprise 生成機器指紋中描述的獨立工具。
Before you begin
- 您在配置期間,定義要使用的 SQL Server 資料庫的名稱和位置,以及服務帳戶名稱和密碼。執行配置精靈的使用者必須能夠建立資料庫及授予權限。
- 如果遇到錯誤 "**WARNING** 無法為本地目錄 "C:\Program Files (x86)\HCL\AppScan Enterprise\WebApp" 配置虛擬目錄 "ase"。請確定 IIS 配置適當,然後再試一次。在您執行配置精靈時,請考量停用防毒軟體。如果您不希望停用防毒軟體,您可以從防毒配置中排除 AppScan Enterprise 資料夾,然後再次執行配置精靈。Important:在執行 AppScan Enterprise 的同一部電腦上執行的個人防火牆和防毒程式可能會封鎖通訊,並導致安裝和配置期間發生配置失敗。它也會在執行掃描時導致不精確的發現項目,並降低效能。為了得到最佳結果,請不要在電腦上執行防火牆或防毒。
Procedure
- 安裝完成時,「配置精靈」會自動啟動。您也可以通過從 Windows™ 開始菜單中以管理員身份選擇配置嚮導來啟動它。
- 在歡迎使用畫面中,按下一步。
-
在授權伺服器窗口中,複製屏幕上顯示的指紋密鑰。此密鑰是您機器的唯一密鑰,並且需要生成有效的授權。

生成並應用授權檔案
此任務涵蓋為 AppScan Enterprise 生成和應用許可文件的步驟,包括生成、配置和放置許可文件。
Before you begin
Procedure
-
生成許可文件:
- 前往lDeployment</uicontrol>。
- 找到您現有的部署,然後點擊部署旁邊的三點菜單。
- 點擊<uicontrol>Download License File</uicontrol>。
- 在<uicontrol>Download License File</uicontrol>窗口中,粘貼從配置向導或獨立工具複製的指紋密鑰。
- 完成後,點擊<uicontrol>Submit</uicontrol>以下載許可文件。
-
應用許可文件:
- 將下載的許可文件複製到 AppScan 安裝目錄(例如,C:\Program Files (x86)\HCL\AppScan Enterprise)。
- 文件名必須是<uicontrol>AppScanEnterprise_License.license</uicontrol>。
Note:每當<uicontrol>AppScanEnterprise_License</uicontrol>文件被修改時,例如許可到期或其他更改,AppScan Enterprise 不會自動識別更新。為確保正常功能,在修改許可文件後重新啟動 AppScan Enterprise 服務。
完成配置向導
應用許可後,按照步驟完成 AppScan Enterprise 的配置。您必須配置每個已安裝的組件,並在所有實例和所有服務器上運行配置向導。
Before you begin
Procedure
- 再次以管理員身份從 Windows™ <uicontrol>開始</uicontrol> 菜單或從安裝目錄(例如,C:\Program Files (x86)\HCL\AppScan Enterprise\WFCfgWiz.exe)打開配置嚮導。
- 在歡迎使用畫面中,按下一步。
-
在 <uicontrol>授權伺服器</uicontrol> 視窗中,點擊 <uicontrol>下一步</uicontrol>。

-
在伺服器元件視窗中選取您要配置的元件。您可用的元件視授權而定。請參閱伺服器元件。如果您在一台機器上安裝組件,請選擇所有的複選框,即使您之前已安裝其中一個組件。

-
在實例名稱視窗中,指定您要配置之實例的名稱。請參閱實例名稱。

-
在服務帳戶視窗中,輸入網域/使用者名稱服務帳戶和密碼,然後按下一步。請參閱服務帳戶。

-
在資料庫連線視窗中,輸入 SQL Server 名稱、埠號,選取鑑別模式和您要連接的資料庫名稱。如果您選取「SQL 鑑別」,請先輸入使用者名稱和密碼,再按一下測試連線來驗證您是否可以連接至 SQL Server。配置精靈在連線成功之前不會繼續。當 AppScan® Enterprise Server 在 SQL Server 中創建數據庫時,它會自動配置排序規則。

Note:- AppScan Enterprise 支援使用 Windows 鑑別和 SQL 鑑別來連接至 SQL 資料庫。請參考 Microsoft 的文章,了解 驗證模式,並選擇符合您需求的驗證模式。您可以將鑑別模式變更為另一個鑑別模式,但請務必重新執行配置精靈。
- 用戶必須在 SQL 伺服器上被分配一個 sysadmin 伺服器角色。用戶還必須擁有資料庫的訪問權限,並且必須被授予至少db_ddladmin、db_datawriter和db_datareader權限或db_owner權限。
- 隨著 Liberty 支援的引入,SQL Server 名稱的語法已更改。".\SQL_SERVER_NAME" 不再有效。請改用 "HOSTNAME\SQL_SERVER_NAME"。
- 如果是從 8.6 版或更舊版本升級現有資料庫,請在下一個畫面中輸入資料庫主要金鑰密碼來存取它。請將此密碼保存在安全的位置。
- 如果您的環境使用命名的 SQL Server 實例作為 AppScan Enterprise 數據庫,請確保在 SQL Server 配置管理器中啟用了 TCP/IP,並重新啟動 SQL Server 的 SQL 服務。請使用指名 SQL Server 實例的埠號,而不是預設埠號 (1433)。
-
在伺服器憑證視窗中,選擇您組織專用的憑證。此步驟有助於您在環境中部署安全的 AppScan® Enterprise。請參閱伺服器憑證。

-
(僅限升級)。在 <uicontrol>恢復 AppScan 伺服器設置</uicontrol> 屏幕中,您可以選擇恢復 Liberty Server(默認)上的先前 AppScan 伺服器自定義設置。此畫面會在升級時出現一次;如果您稍後執行配置精靈,此畫面不會出現。請參閱還原 AppScan Server 設定。
-
在伺服器金鑰儲存庫畫面中,選取 Enterprise Console 要使用的伺服器金鑰儲存庫。如果您已匯出 .pfx 檔,請選取公開金鑰密碼化標準 #12 (PKCS #12)。瀏覽至在其中儲存 .pfx 檔的位置,將它匯入並輸入匯出檔案時所建立的密碼。請參閱伺服器金鑰儲存庫。

-
在鑑別機制視窗中,選取要用來登入 Enterprise Console 的鑑別機制。默認情況下是通過 Windows™ 進行身份驗證。如果要使用 LDAP,請參閱鑑別機制。

Note:如果您需要使用通用訪問卡 (CAC) 進行身份驗證,請確保選擇 <uicontrol>LDAP</uicontrol> 作為您的身份驗證機制。在配置 AppScan Enterprise 之後,請遵循使用「通用存取卡 (CAC)」來鑑別中的指示,使用 CAC 來鑑別。 -
在 <uicontrol>Server Configuration</uicontrol> 視窗中,
- 配置 <uicontrol>Liberty</uicontrol> 伺服器的主機名和埠以供 <uicontrol>AppScan Server</uicontrol> 使用。如果您使用的是 <uicontrol>Windows</uicontrol> 身份驗證,請在主機名前加上您的網域名稱。
- 雖然這不是一個建議的做法,您可以容許 SSL 連線在掃描過程中的無效或不受信任的憑證。當該選項被禁用時,掃描日誌中將出現消息,指示無法訪問不安全的伺服器進行掃描。此選項也影響「手動探索」功能。
-
:配置 <uicontrol>How to Fix</uicontrol> 服務埠(隨 <uicontrol>Enterprise Console</uicontrol> 安裝)。此埠通過 <uicontrol>HTTP</uicontrol> 運行,並由 <uicontrol>ASRA</uicontrol> 伺服器用於提供 <uicontrol>How to Fix</uicontrol>。<uicontrol>How to Fix</uicontrol> 出現在應用程序問題的 <uicontrol>About this Issue</uicontrol> 頁面上,並提供修復建議。如果已使用 9444, 您可以選取不同埠。
-
(僅升級)在 <uicontrol>Database Encryption Changes</uicontrol> 視窗中,點擊 <uicontrol>Help</uicontrol> 以了解如何保護數據庫所在的 <uicontrol>SQL Server</uicontrol>。如果您決定不啟用 TDE,請選取勾選框以繼續配置。

Note:<uicontrol>AppScan® Enterprise</uicontrol> 使用 <uicontrol>SQL Server 2016</uicontrol> 及更高版本中提供的透明數據加密 (<uicontrol>TDE</uicontrol>) 技術。TDE 可加密儲存在資料庫或實體媒體上之備份中的資料。如果您使用的是舊版的 SQL Server,可能會面臨資料庫內含資料遭到未獲授權存取的風險。 -
在 <uicontrol>Product Administrator</uicontrol> 視窗中,指定一位用戶作為 <uicontrol>Product Administrator</uicontrol>。這個使用者是個別授權的;如果您想要重新指派「產品管理者」授權,則必須重新執行配置精靈。請參閱產品管理者。

-
確定沒有人正在存取資料庫,然後在規格完成視窗中,按一下完成來完成配置。此過程可能需要一段時間。
Note:
- IIS AppPool 設定在 Windows™ Server 上的配置過程中設置:
- IIS 回收設在 2:00am
- 閒置逾時值設為 120 分鐘
- 如果您看到無法配置 Proxy 伺服器憑證的錯誤訊息,它可能已過期。請聯絡「產品管理者」以進一步調查。
- IIS AppPool 設定在 Windows™ Server 上的配置過程中設置:
- Optional:
選取啟動服務勾選框來自動啟動服務。
Note:如果您未選擇自動啟動代理程式服務,代理程式便不會挑選使用者所建立的任何工作。您可以利用「系統管理工具」,用手動方式來啟動服務;請參閱驗證代理程式服務和警示服務安裝。
- 執行預設值精靈。這個精靈提供許多可配置選項的預設值,來協助您安裝範例資料。
- 按一下結束。
執行預設值精靈
這個精靈提供許多可配置選項的預設值,來協助您安裝範例資料。您可以創建用戶、添加安全測試策略、創建掃描模板、添加預先創建的儀表板,並配置與 Rational® Quality Manager 或 Rational® Team Concert 的缺陷跟踪集成。
About this task
Procedure
- 在歡迎使用頁面中,選擇您要更新的實例,然後按下一步。
- 在起始設定類型視窗中,選取其中一個可用的起始設定,然後按下一步。
-
在預設值視窗中,配置下列選項,然後按下一步:
-
(僅限 Windows™ 身份驗證):在 LDAP 設置頁面中,如果您使用 LDAP 服務器,請選擇啟用 LDAP 選項。
- 在伺服器名稱欄位中,輸入 LDAP 群組名稱。
- 在群組查詢欄位中,輸入用來擷取使用者群組資訊的群組查詢路徑。您可以使用 LDAP 伺服器或 Active Directory 伺服器。
- Optional: 如果您想要使用匿名存取來與 LDAP 伺服器整合,請選取匿名存取勾選框。依預設,此選項已停用。
- 按一下測試 LDAP 來確認配置能夠運作。
- 在 IP 安全許可權頁面中,配置允許進行掃描的 IP 位址和範圍。利用虛線來定義 IPv4 範圍(例如 1.2.3.4-);利用字首來定義 IPv6 範圍(例如 fe80::/10)。
- 在在資料庫中移入範例資料頁面中,選取移入範例資料勾選框,以便在資料庫中移入掃描範本、預先建立的儀表板、伺服器群組和測試原則。
- 按「下一步」。這時會開啟預設值精靈進度頁面,其顯示設定的進度。
- 精靈完成之後,即會開啟預設值精靈完成頁面。
- 按一下結束來關閉精靈。
安裝 HCL® 動態分析掃描器
使用此程序來安裝用於掃描和測試網站應用程式的代理程式。
Before you begin
- 確保您閱讀了安裝與配置期間的必要使用者帳戶資訊相關文檔,以便知道在安裝過程中使用哪個用戶帳戶。
- 您的網站所用的任何技術,也都必須隨著 Sanner 一起安裝。例如,如果您在任何網頁上使用 Flash,您就必須安裝 Flash 的正確版本。
Procedure
-
轉到下載可執行文件(ASE_DASSetup_<version>.exe)的目錄,然後雙擊該文件。
Note:顯示下一個畫面可能需要一點時間。
- 在授權合約視窗中,選取我接受授權合約中的條款選項,然後按下一步。
- 在「目的地資料夾」視窗中,按下一步。
- 在備妥可安裝程式視窗中,按一下安裝來繼續進行安裝,然後按一下完成。
執行配置精靈
在您安裝或升級伺服器或掃描器後,您必須配置每個已安裝的組件,並在所有實例和所有伺服器上運行<uicontrol>配置精靈</uicontrol>。
Before you begin
- 您在配置期間,定義要使用的 SQL Server 資料庫的名稱和位置,以及服務帳戶名稱和密碼。執行配置精靈的使用者必須能夠建立資料庫及授予權限。
- 在您安裝<uicont®rol>AppScan Enterprise Server</uicontrol>後運行<uicontrol>精靈</uicontrol>會在<uicontrol>SQL Server</uicontrol>上設置數據庫並進行組件的初始設置。
- 在您安裝<uicontrol>Dynamic Analysis Scanner</uicontr®ol>後運行<uicontrol>精靈</uicontrol>會將掃描器註冊到<uicontrol>AppScan Enterprise Server</uicontrol>。
- 確保<uicontrol>許可文件</uicontrol>(<uicontrol>AppScanEnterprise_License</uicontrol>)已放置在<uicontrol>AppScan</uicontrol>安裝目錄中(例如,C:\Program Files (x86)\HCL\AppScan Enterprise)。請參閱<uicontrol>生成和應用許可文件</uicontrol>。
Procedure
- 安裝完成時,「配置精靈」會自動啟動。您也可以通過從<uicont™rol>Windows開始</uicontrol>菜單中選擇<uicontrol>配置精靈</uicontrol>來啟動它。
- 在歡迎使用畫面中,按下一步。
-
在<uicontrol>許可伺服器</uicontrol>窗口中,點擊<uicontrol>下一步</uicontrol>。

-
在伺服器元件視窗中選取您要配置的元件。您可用的元件視授權而定。請參閱伺服器元件。如果您在一台機器上安裝組件,請選擇所有的複選框,即使您之前已安裝過其中一個組件。

-
在實例名稱視窗中,指定您要配置之實例的名稱。請參閱實例名稱。

-
在服務帳戶視窗中,輸入網域/使用者名稱服務帳戶和密碼,然後按下一步。請參閱服務帳戶。

-
在資料庫連線視窗中,輸入 SQL Server 名稱、埠號,選取鑑別模式和您要連接的資料庫名稱。如果您選取「SQL 鑑別」,請先輸入使用者名稱和密碼,再按一下測試連線來驗證您是否可以連接至 SQL Server。配置精靈在連線成功之前不會繼續。當<uicontrol>AppScan Enterp®rise Server</uicontrol>在<uicontrol>SQL Server</uicontrol>中創建數據庫時,它會自動配置排序規則。

Note:- AppScan Enterprise 支援使用 Windows 鑑別和 SQL 鑑別來連接至 SQL 資料庫。請參考 Microsoft 的文章,了解 驗證模式,並選擇符合您需求的驗證模式。您可以將鑑別模式變更為另一個鑑別模式,但請務必重新執行配置精靈。
- 用戶必須在 SQL 伺服器上被分配一個 sysadmin 伺服器角色。用戶還必須擁有資料庫的訪問權限,並且必須被授予至少db_ddladmin、db_datawriter和db_datareader權限或db_owner權限。
- 如果是從 8.6 版或更舊版本升級現有資料庫,請在下一個畫面中輸入資料庫主要金鑰密碼來存取它。請將此密碼保存在安全的位置。
- 如果您的環境使用<uicontrol>命名的SQL Server實例</uicontrol>作為<uicontrol>AppScan Enterprise</uicontrol>數據庫,請確保在<uicontrol>SQL Server配置管理器</uicontrol>中啟用<uicontrol>TCP/IP</uicontrol>,並重新啟動<uicontrol>SQL Server</uicontrol>的<uicontrol>SQL服務</uicontrol>。請使用指名 SQL Server 實例的埠號,而不是預設埠號 (1433)。
-
(僅升級)在資料庫加密變更視窗中,按一下說明,以瞭解如何保護該資料庫所在的 SQL Server。如果您決定不啟用 TDE,請選取勾選框以繼續配置。

Note:AppScan® Enterprise 使用在 SQL Server 2016 及更高版本中可用的透明數據加密 (TDE) 技術。TDE 可加密儲存在資料庫或實體媒體上之備份中的資料。如果您使用的是舊版的 SQL Server,可能會面臨資料庫內含資料遭到未獲授權存取的風險。 -
確定沒有人正在存取資料庫,然後在規格完成視窗中,按一下完成來完成配置。此過程可能需要一些時間。
Note:
- 在配置期間,Windows™ Server 上的 <uicontrol>IIS AppPool</uicontrol> 設置已設置:
- IIS 回收設在 2:00am
- 閒置逾時值設為 120 分鐘
- 如果您看到無法配置 Proxy 伺服器憑證的錯誤訊息,它可能已過期。請聯絡「產品管理者」以進一步調查。
- 在配置期間,Windows™ Server 上的 <uicontrol>IIS AppPool</uicontrol> 設置已設置:
- Optional:
選取啟動服務勾選框來自動啟動服務。
Note:如果您未選擇自動啟動代理程式服務,代理程式便不會挑選使用者所建立的任何工作。您可以利用「系統管理工具」,用手動方式來啟動服務;請參閱驗證代理程式服務和警示服務安裝。
- 按一下結束。
驗證 Enterprise Console 的安裝
安裝程序完成之後,您可以驗證 Enterprise Console 的安裝。