AppScan 360° 在单个虚拟机上的快速安装

快速模式用于在单个 VM 安装中进行概念验证 (POC) 评估。与定制模式相比，它提供了引导式安装路径，并且需要做出的决策更少。

💡 最佳实践：在每次进行全新安装或重大升级之前，运行 AppScan 360 Setup Assistant。

重要说明：

以管理员身份在目标系统上执行所有安装和配置活动。
安装脚本会询问特定于环境的问题。开始前，请查看先决条件设置指南并准备所需的值。
快速模式用于评估方案。对于生产部署和升级计划，请使用定制/生产指南。

准备安装文件

将单个 VM 安装工具包和所需的 AppScan 工具包从 MyHCLSoftware 门户网站下载到一个目录中。例如，/home/username/AppScan360_singleVM。
将所有安装工具包文件保存在同一目录中。典型工具包文件：
- AppScan360_SingleVMsetup_v<version>.run
- AppScan360_v<version>.run
- AppScan360_ASRA_v<version>.run
- AppScan360_DTCS_v<version>.run（DAST 模板功能所需）
- AppScan360_SCA_v<version>.run （可选）

将所有工具包移入工作文件夹，并赋予其可执行权限。

mkdir -p ~/aio-setup
mv *.run ~/aio-setup/
cd ~/aio-setup
chmod +x *.run

放置证书（可选）

如果您对 SSO（LDAP、OIDC）或 SMTP 等服务使用定制或自签名证书，请先创建证书文件夹。

sudo ./AppScan360_SingleVMsetup_v<version>.run -- $PWD prepareCertsFolders

该命令将创建以下文件夹结构：


文件夹	函数
`~/aio-setup/certs/`	主证书文件夹
`~/aio-setup/certs/docker/`	Docker 注册表证书（通常在进行快速/PoC 安装时不需要）
`~/aio-setup/certs/ldap/`	LDAP 证书 (LDAPS)
`~/aio-setup/certs/smtp/`	SMTP 证书 (SMTPS)
`~/aio-setup/certs/oidc/`	OIDC 证书
`~/aio-setup/certs/otel/`	开放遥测证书（在收集器由专用 CA 签名时使用）
`~/aio-setup/certs/ingress/`	入口/应用程序域证书（可选；如果未提供，则将生成自签名证书）

创建文件夹后，将证书文件放入相应的路径中。

运行安装

开始安装：
```
cd ~/aio-setup
sudo ./AppScan360_SingleVMsetup_v<version>.run -- $PWD
```
要停止并清除中断的安装，请执行以下操作：
```
cd aioWorkspace
./disengageAS360-AIO.sh
```
安装日志文件将写入 ./aioWorkspace/logs 中。

出现提示时，选择快速模式 (POC)：

Please select your installation path:
1. 🚀  Express Mode (POC)
2. 🛠️  Custom Mode (Production)
Enter 1 or 2 [Default: 1]:

完成快速模式 (POC) 调查问卷。

Express Mode (POC)中的关键提示。

可选软件组成分析 (SCA) 部分：

Do you want to install the optional SCA kit for this evaluation? (y/n) [Default: n]:

主域（用于生成最终访问 URL）：

Please enter the primary domain name for this instance. This will be used to create the access URL.(e.g., appscan-test.local):

出站访问所需的外部域或 IP（例如，SSO 或 SMTP 端点）：

Provide the external domain(s) or IP address(es) this instance must access for external services (e.g., SSO, SMTP). Use commas to separate multiple values. If none, press Enter to skip:

本地 DNS 连接：

Is the VM connected to a local DNS server? (y/n) [Default: n]:

共享存储大小（缺省值为 20 GB）：

A small amount of storage is required for your evaluation. We will allocate a default of 20 GB to accommodate all chosen components. Press Enter to accept 20 GB or specify a different size:

SMTP 邮件中继（可选）：
```
Do you want to configure an SMTP Mail Relay(SMR)? (y/n) [Default: n]:
```
如果启用了 SMTP，则其他提示包括：
- SMR 主机
- SMR 端口
- SMR 用户名
- 认证方式：
```
Select SMTP authentication mode:
1. Password
2. Client Secret
Enter 1 or 2 [Default: 1]:
```
根据您的选择，安装程序会要求输入 SMR 密码或 SMR 客户机密钥。

SMTP 安全传输：

Does the SMR operate over SSL/TLS. If yes, a certificate is required to be present in certs/smtp folder (y/n)?

确认并继续：
```
> Continue with installation? (y/n) [Default: y]:
```
确认后，安装程序将继续进行快速安装组件的部署，包括：
- Kubernetes 集群 (K0S)
- Docker 专用注册表 (DPR)
- SQL Server 实例 (MSSQL)
- AppScan 360° Central Platform (ASCP) 和组件。
- AppScan Remediation Advisories (ASRA)
- DAST Template Converter Service (DTCS)
- 软件组成分析 (SCA)（如果已选择）
完成后，安装程序将输出：
- 要添加的主机文件条目
- 用于访问 AppScan 360 的最终 URL

将生成 IP 地址和主机名映射添加到主机文件中。


操作系统	主机文件路径
Linux、MacOS	`/etc/hosts`
Windows	`C:\Windows\System32\drivers\etc\hosts`

例如：

192.168.1.100 appscan.appscan-test.local

登录并激活 AppScan 360°

要登录并激活 AppScan 360°，请执行以下操作：

打开安装完成时输出的 URL：https://<host>.<domain>。
使用缺省凭证登录：
- 用户名：Admin
- 密码：Admin12!
上载您的 AppScan 360° 许可证文件以激活部署。

卸载

要移除 AppScan 360° 的快速单个 VM 安装，请执行以下操作：

cd ~/aio-setup/aioWorkspace
sudo ./disengageAS360-AIO.sh

这将移除已安装的组件及此安装版本创建的 AppScan 360° 资源。

更改安装方法

如果您向跳出快速模式：

有关单个 VM 的生产安装，请参阅在单个虚拟机上定制安装 AppScan 360°。
有关多节点部署，请参阅AppScan 360° 的分布式安装。