此页面由 Cloud Translation API 翻译。

安装 Edge SSO 以实现高可用性

适用于私有云的 Edge v4.19.01

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

在同一处安装两个 Edge SSO 模块数据中心

您需要在一个数据中心的不同节点上部署两个 Edge SSO 实例，高可用性在这种情况下：

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

如果您使用 HTTP 访问 Edge SSO，请将负载平衡器配置为：

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

默认情况下，Edge SSO 会监听端口 9099 上的 HTTP 请求。您可以根据需要使用 SSO_TOMCAT_PORT 用于设置 Edge 单点登录端口。如果您使用的是 SSO_TOMCAT_PORT 将 Edge SSO 端口从默认值更改为其他端口，请确保负载平衡器监听该端口端口。

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

SSO_TOMCAT_PORT=9033

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

http://LB_DNS_NAME:9033

您可以将 Edge SSO 实例配置为使用 HTTPS。在这种情况下，请按照配置 apigee-sso 以进行 HTTPS 访问。如是启用 HTTPS 的组成部分，请在 Edge SSO 中设置 SSO_TOMCAT_PROFILE 配置文件，如下所示：

SSO_TOMCAT_PROFILE=SSL_TERMINATION

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

SSO_TOMCAT_PORT=9443

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

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

https://LB_DNS_NAME:9443

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

在两个数据中心中安装 Edge SSO 之前，您需要做好以下准备：

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

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

在每个数据中心中安装 Edge SSO 时，请将两者都配置为使用 Postgres 主实例数据中心 1：

## Postgres configuration
PG_HOST=IP_or_DNS_of_PG_Master_in_DC1
PG_PORT=5432

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

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

如果数据中心 1 的 Edge SSO 出现故障，您可以切换到数据中的 Edge SSO 实例中心 2：

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

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

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