此页面由 Cloud Translation API 翻译。

安装 Apigee SSO 以实现高可用性

在以下两种情况下，您需要安装多个 Apigee SSO 实例以实现高可用性：

在单个数据中心环境中，安装两个 Apigee SSO 实例以创建高可用性单点登录可用性环境，这表示如果其中某个 Apigee 单点登录 (SSO) 服务启用，系统会继续运行都会发生故障
在具有两个数据中心的环境中，请在两个数据中心都安装 Apigee SSO，以便在其中一个 Apigee SSO 模块发生故障时，系统仍能继续运行。

在同一项目中安装两个 Apigee SSO 模块数据中心

您在单个数据中心的不同节点上部署两个 Apigee SSO 实例，以支持高可用性。在这种情况下：

Apigee SSO 的两个实例都必须连接到同一 Postgres 服务器。Apigee 推荐使用专用 Postgres 服务器进行 Apigee SSO，而不要随 Edge 一起安装。
两个 Apigee SSO 实例都必须使用 SSO_JWT_SIGNING_KEY_FILEPATH和SSO_JWT_VERIFICATION_KEY_FILEPATH 属性。如需详细了解如何设置这些属性，请参阅安装和配置 Apigee SSO。
您需要在两个 Apigee SSO 实例的前面添加负载平衡器：
- 负载平衡器必须支持应用生成的 Cookie 粘性，并且会话 Cookie 必须命名为 JSESSIONID。
- 配置负载均衡器以对 Apigee SSO 执行 TCP 或 HTTP 健康检查。对于 TCP，请使用 Apigee SSO 的网址：
```
http_or_https://edge_sso_IP_DNS:9099
```
  指定 Apigee SSO 设置的端口。默认端口为 9099。
  
  对于 HTTP，请添加 /healthz：
```
http_or_https://edge_sso_IP_DNS:9099/healthz
```
- 某些负载平衡器设置取决于您是否在 Apigee SSO 上启用了 HTTPS。请参阅。

如果您使用的是对 Apigee SSO 的 HTTP 访问权限，请将负载平衡器配置为：

使用 HTTP 模式连接到 Apigee SSO。
监听与 Apigee SSO 相同的端口。

默认情况下，Apigee SSO 会监听端口 9099 上的 HTTP 请求。（可选）您可以使用 SSO_TOMCAT_PORT 设置 Apigee SSO 端口。如果您使用的是 SSO_TOMCAT_PORT 将 Apigee SSO 端口从默认值更改为其他端口，请确保负载平衡器监听该端口端口。

例如，在每个 Apigee SSO 实例上，您可以通过将以下内容添加到配置文件：

SSO_TOMCAT_PORT=9033

然后，将负载平衡器配置为监听端口 9033 并将请求转发到 Edge 端口 9033 上的 SSO 实例。在此场景中，Apigee SSO 的公共网址是：

http://LB_DNS_NAME:9033

您可以将 Apigee SSO 实例配置为使用 HTTPS。在这种情况下，请按照为 HTTPS 访问配置 Apigee SSO 中的步骤操作。如是启用 HTTPS 过程中的一部分，请在 Apigee SSO 中设置 SSO_TOMCAT_PROFILE 配置文件，如下所示：

SSO_TOMCAT_PROFILE=SSL_TERMINATION

您还可以选择设置 Apigee SSO 用于 HTTPS 访问的端口：

SSO_TOMCAT_PORT=9443

然后，配置负载平衡器，以便：

然后，将负载均衡器配置为将请求转发到端口 9433 上的 Apigee SSO 实例。在此场景中，Apigee SSO 的公共网址是：

https://LB_DNS_NAME:9443

在多数据中心环境中，您需要在每个数据中心内安装一个 Apigee SSO 实例。然后，通过一个 Apigee SSO 实例处理所有流量。如果该 Apigee SSO 实例发生故障，您可以切换到第二个 Apigee SSO 实例。

在两个数据中心内安装 Apigee SSO 之前，您需要满足以下条件：

主 Postgres 服务器的 IP 地址或域名。

在多数据中心环境中，您通常会在每个数据中心安装一个 Postgres 服务器，并将其配置为主-备用复制模式。在此示例中，data 中心 1 包含 Master Postgres 服务器和数据中心 2 包含待机模式。如需了解详情，请参阅为 Postgres 设置主-从复制。
一个指向一个 Apigee SSO 实例的 DNS 条目。例如，您创建了一个下方表单中指向数据中心 1 中的 Apigee SSO 实例的条目：
```
my-sso.domain.com => apigee-sso-dc1-ip-or-lb
```
Apigee SSO 的两个实例必须使用配置文件中的 SSO_JWT_SIGNING_KEY_FILEPATH 和 SSO_JWT_VERIFICATION_KEY_FILEPATH 属性指定的相同 JWT 密钥对。如需详细了解如何设置这些属性，请参阅安装和配置 Apigee SSO。

在每个数据中心安装 Apigee SSO 时，请将这两个实例配置为使用数据中心 1 中的 Postgres 主服务器：

## Postgres configuration
PG_HOST=IP_or_DNS_of_PG_Master_in_DC1
PG_PORT=5432

您还需要将两个数据中心配置为使用 DNS 条目作为可公开访问的网址：

# Externally accessible URL of Apigee SSO
SSO_PUBLIC_URL_HOSTNAME=my-sso.domain.com
# Default port is 9099.
SSO_PUBLIC_URL_PORT=9099

如果数据中心 1 中的 Apigee SSO 服务器宕机，您可以切换到数据中心 2 中的 Apigee SSO 实例：

按照处理 PostgreSQL 数据库故障切换中的说明，将数据中心 2 中的 Postgres 备用服务器转换为主服务器。
更新 DNS 记录以将 my-sso.domain.com 指向中的 Apigee SSO 实例数据中心 2：
```
my-sso.domain.com => apigee-sso-dc2-ip-or-lb
```
更新数据中心 2 中 Apigee SSO 的配置文件，以指向新的 Postgres 主实例服务器：
```
## Postgres configuration
PG_HOST=IP_or_DNS_of_PG_Master_in_DC2
```

在数据中心 2 中重启 Apigee SSO 以更新其配置：

/opt/apigee/apigee-service/bin/apigee-service apigee-sso restart