Edge pour Private Cloud v. 4.17.09
Vous pouvez installer plusieurs instances d'Edge SSO pour assurer une haute disponibilité dans deux scénarios :
- Dans un environnement de centre de données unique, installez deux instances Edge SSO pour créer un environnement à haute disponibilité, ce qui signifie que le système continue de fonctionner si l'un des modules Edge SSO tombe en panne.
- Dans un environnement comportant deux centres de données, installez Edge SSO dans les deux centres de données afin que le système continue de fonctionner si l'un des modules Edge SSO tombe en panne.
Installer deux modules d'authentification unique Edge dans le même centre de données
Vous déployez deux instances d'Edge SSO sur des nœuds différents, dans un seul centre de données, pour assurer une haute disponibilité. Dans ce cas, on a :
- Les deux instances d'Edge SSO doivent être connectées au même serveur Postgres. Apigee recommande d'utiliser un serveur Postgres dédié pour l'authentification unique Edge et de ne pas utiliser le même serveur Postgres que celui que vous avez installé avec Edge.
- Vous avez besoin d'un équilibreur de charge devant les deux instances d'Edge SSO :
- L'équilibreur de charge doit accepter l'affinité de cookie générée par l'application, et le cookie de session doit être nommé
JSESSIONID. - Configurez l'équilibreur de charge pour qu'il effectue une vérification d'état TCP ou HTTP sur Edge SSO. Pour TCP, utilisez l'URL de l'authentification unique Edge :
http_or_https://edge_sso_IP_DNS:9099
Spécifiez le port défini par l'authentification unique Edge. Le port 9099 est le port par défaut.
Pour HTTP, incluez/healthz:
http_or_https://edge_sso_IP_DNS:9099/healthz - Certains paramètres de l'équilibreur de charge dépendent de l'activation ou non du protocole HTTPS sur Edge SSO. Pour plus d'informations, consultez les sections suivantes.
- L'équilibreur de charge doit accepter l'affinité de cookie générée par l'application, et le cookie de session doit être nommé
Utiliser l'accès HTTP à l'authentification unique Edge
Si vous utilisez l'accès HTTP à l'authentification unique Edge, configurez l'équilibreur de charge pour :
- Utiliser le mode HTTP pour se connecter à Edge SSO
- Écouter sur le même port qu'Edge SSO
Par défaut, Edge SSO écoute les requêtes HTTP sur le port 9099. Vous pouvez éventuellement utiliserSSO_TOMCAT_PORTpour définir le port SSO Edge. Si vous avez utiliséSSO_TOMCAT_PORTpour modifier le port SSO Edge par défaut, assurez-vous que l'équilibreur de charge écoute sur ce port.
Par exemple, sur chaque instance Edge SSO, vous définissez le port sur 9033 en ajoutant ce qui suit au fichier de configuration :
SSO_TOMCAT_PORT=9033
Vous configurez ensuite l'équilibreur de charge pour qu'il écoute sur le port 9033 et transfère les requêtes vers une instance Edge SSO sur le port 9033. L'URL publique de l'authentification unique Edge dans ce scénario est la suivante :
http://LB_DNS_NAME:9033
Utiliser l'accès HTTPS à l'authentification unique Edge
Vous pouvez configurer les instances Edge SSO pour qu'elles utilisent HTTPS. Dans ce scénario, suivez la procédure décrite dans Configurer apigee-sso pour l'accès HTTPS. Lors du processus d'activation du protocole HTTPS, vous définissez SSO_TOMCAT_PROFILE dans le fichier de configuration de l'authentification unique Edge, comme indiqué ci-dessous :
SSO_TOMCAT_PROFILE=SSL_TERMINATION
Vous pouvez également définir le port utilisé par l'authentification unique Edge pour l'accès HTTPS :
SSO_TOMCAT_PORT=9443
Si vous utilisez l'accès HTTPS à l'authentification unique Edge, configurez l'équilibreur de charge pour :
- Utiliser le mode TCP, et non le mode HTTP, pour se connecter à Edge SSO
- Écouter sur le même port qu'Edge SSO, tel que défini par
SSO_TOMCAT_PORT
Vous configurez ensuite l'équilibreur de charge pour qu'il transfère les requêtes à une instance Edge SSO sur le port 9433. L'URL publique de l'authentification unique Edge dans ce scénario est la suivante :
https://LB_DNS_NAME:9443
Installer Edge SSO dans plusieurs centres de données
Dans un environnement à plusieurs centres de données, vous installez une instance Edge SSO dans chaque centre de données. Une seule instance Edge SSO gère alors tout le trafic. Si cette instance Edge SSO tombe en panne, vous pouvez passer à la deuxième instance Edge SSO.
Avant d'installer l'authentification unique Edge dans deux centres de données, vous devez disposer des éléments suivants :
- Adresse IP ou nom de domaine du serveur Postgres maître.
Dans un environnement à plusieurs centres de données, vous installez généralement un serveur Postgres dans chaque centre de données et vous les configurez en mode de réplication maître-veille. Dans cet exemple, le centre de données 1 contient le serveur Postgres maître et le centre de données 2 contient le serveur Postgres de secours. Pour en savoir plus, consultez Configurer la réplication maître-serveur de secours pour Postgres. - Une seule entrée DNS qui pointe vers une instance Edge SSO. Par exemple, vous créez une entrée DNS au format ci-dessous qui pointe vers l'instance SSO Edge dans le centre de données 1 :
my-sso.domain.com => apigee-sso-dc1-ip-or-lb
Lorsque vous installez l'authentification unique Edge dans chaque centre de données, vous configurez les deux pour utiliser le maître Postgres dans le centre de données 1 :
## Postgres configuration.
PG_HOST=IP_or_DNS_of_PG_Master_in_DC1
PG_PORT=5432Vous configurez également les deux pour utiliser l'entrée DNS comme URL accessible publiquement :
# Externally accessible URL of Edge SSO. SSO_PUBLIC_URL_HOSTNAME=my-sso.domain.com # Default port is 9099. SSO_PUBLIC_URL_PORT=9099
Si l'authentification unique Edge dans le centre de données 1 tombe en panne, vous pouvez passer à l'instance d'authentification unique Edge dans le centre de données 2 :
- Convertissez le serveur de secours Postgres du centre de données 2 en serveur maître, comme décrit dans Gérer un basculement de base de données PostgreSQL.
- Mettez à jour l'enregistrement DNS pour faire pointer
my-sso.domain.comvers l'instance d'authentification unique Edge dans le centre de données 2 :
my-sso.domain.com => apigee-sso-dc2-ip-or-lb - Mettez à jour le fichier de configuration de l'authentification unique Edge dans le centre de données 2 pour qu'il pointe vers le nouveau serveur maître Postgres dans le centre de données 2 :
## Postgres configuration.
PG_HOST=IP_or_DNS_of_PG_Master_in_DC2 - Redémarrez l'authentification unique Edge dans le centre de données 2 pour mettre à jour sa configuration :
/opt/apigee/apigee-service/bin/apigee-service apigee-sso restart