在 Verify BridgeDocker 上安装和配置

在线编辑

在您的 IBM® Verify 租户上配置好 Verify Bridge 后，您必须在 Docker 上安装并配置 Verify Bridge。

准备工作

您必须满足以下需求。

操作系统: 一款基于 Linux® 的操作系统，支持 Docker Engine Community Edition (CE) 容器。参见 https://docs.docker.com/install/。
Docker 引擎。: 19.03.0 或更高
Docker Compose: 参见 https://docs.docker.com/compose/install/。
CPU: 保留四个核心。
系统内存: 保留 8 GB。
磁盘空间: 至少 50 GB 可用硬盘空间。
与租户的 IBM Verify 连接: Verify Bridge 租户 ID、API 客户端 ID 和密钥（ URL ）。

关于此任务

Verify Bridge请按照以下步骤部署 IBM。

如果您要升级 Docker 上的现有 Verify Bridge 安装，请参阅 Docker 上的《升级 Verify Bridge 》。

过程

从 IBM 容器注册表中拉取该镜像以查看许可证。
运行以下命令。
```
docker pull icr.io/isv-saas/verify-bridge:latest

docker run --rm  icr.io/isv-saas/verify-bridge:latest license
```
注意：您必须通过在文件 docker-compose.yml 中添加 [parameter - LICENSE_ACCEPT: "yes"] 来接受许可协议，才能部署 IBMVerify Bridge 。
创建一个文件 docker-compose.yml ，内容如下。
```
version: "3"
services:
    verify-bridge:
         image: icr.io/isv-saas/verify-bridge:latest
         container_name: verify-bridge
         environment:
                TRACE: "false"
                LICENSE_ACCEPT: "yes"
                TENANT_URI: "<tenantURL>"
                TENANT_PROXY: "<proxyURL>"
                CLIENT_ID: "<clientID>"
                OBF_CLIENT_SECRET: "<obfClientSecret>"
                
         restart: always
```
注意：添加后 GOLANG_FIPS: "1" ，在容器中运行的 Verify Bridge 进程将以 FIPS 140-2 模式运行。此环境变量是可选的。

TENANT_PROXY 是可选的环境值，允许通过代理服务器访问租户。代理类型由 proxyURL 方案确定。支持协议“http”、“https”和“socks5”。

在 “配置 ” IBM Verify 页面完成代理配置时，系统会生成 TENANT_URI、CLIENT_ID 和 CLIENT_SECRET。配置后，可以加密 CLIENT_SECRET。
可以通过运行以下 docker 命令，从客户机私钥获取 OBF_CLIENT_SECRET 值：
```
docker run -e "LICENSE_ACCEPT=yes" --rm icr.io/isv-saas/verify-bridge:latest obfuscate"<clientSecret>" 
```
例如，
```
docker run -e "LICENSE_ACCEPT=yes" --rm icr.io/isv-saas/verify-bridge:latest obfuscate "passw0rd"
Emulate Docker CLI using podman. Create /etc/containers/nodocker to quiet msg.
INFO: Found end user license acceptance.
ccxDMMPSE62AYi3o7y+cNCE+xCtTLOyEHZ5MCw4IUzA=
```
输出的最后一行包含 OBF_CLIENT_SECRET 的屏蔽私钥 (<obfClientSecret>)。对于向后兼容性，支持 CLIENT_SECRET 环境值。
租户 URI 必须包含完整的 URI 方案和域名，例如 https://tenant.verify.ibm.com。

完成配置后，将向您提供客户机标识和客户机密钥。请参阅 “配置验证桥和身份来源 ”。
要在 Docker 上部署 Verify Bridge ，请运行以下命令。
```
docker-compose -f docker-compose.yml up -d
```
验证容器是否已正确启动。
输入以下命令并观察容器的状态。
```
docker ps -a
```
可选： 若要查看日志 Verify Bridge 并进行故障排除，请执行以下命令。
```
docker logs -f  verify-bridge
```