Edge para nube privada v4.18.05
La IU de Edge y la API de Management de Edge funcionan realizando solicitudes al servidor de Edge Management, en el que el servidor de administración admite los siguientes tipos de autenticación:
- Autenticación básica Accede a la IU de Edge o realiza solicitudes a la API de administración de Edge pasando tu nombre de usuario y contraseña.
- OAuth2: Intercambia tus credenciales de autenticación básica de Edge por un token de acceso y un token de actualización de OAuth2. Realiza llamadas a la API de Management de Edge pasando el token de acceso de OAuth2 en el encabezado Bearer de una llamada a la API.
Edge también admite el lenguaje de marcado para confirmaciones de seguridad (SAML) 2.0 como mecanismo de autenticación. Con SAML habilitado, el acceso a la IU de Edge y a la API de administración de Edge sigue usando tokens de acceso de OAuth2. Sin embargo, ahora puedes generar estos tokens a partir de aserciones de SAML que devuelve un proveedor de identidad de SAML.
SAML admite un entorno de inicio de sesión único (SSO). Si usas SAML con Edge, puedes admitir el SSO para la IU y la API de Edge, además de cualquier otro servicio que proporciones y que también admita SAML.
Se agregó compatibilidad con OAuth2 en Edge para nube privada
Como se mencionó antes, la implementación de SAML en Edge se basa en tokens de acceso de OAuth2.Por lo tanto, se agregó compatibilidad con OAuth2 a Edge para la nube privada. Para obtener más información, consulta Introducción a OAuth 2.0.
Ventajas de SAML
La autenticación de SAML ofrece varias ventajas. Si utiliza SAML, puede hacer lo siguiente:
- Toma el control total de la administración de usuarios. Cuando los usuarios abandonan tu organización y se desaprovisionan de forma centralizada, se les deniega automáticamente el acceso a Edge.
- Controla cómo se autentican los usuarios para acceder a Edge. Puedes elegir diferentes tipos de autenticación para diferentes organizaciones de Edge.
- Controlar las políticas de autenticación Es posible que tu proveedor de SAML admita políticas de autenticación que se ajusten mejor a tus estándares empresariales.
- Puedes supervisar los accesos, los cierres de sesión, los intentos de acceso fallidos y las actividades de alto riesgo en tu implementación de Edge.
Usa SAML con Edge
Para admitir SAML en Edge, debes instalar apigee-sso, el módulo de SSO de Edge. En la siguiente imagen, se muestra el SSO de Edge en una instalación de Edge para la nube privada:
Puedes instalar el módulo de SSO de Edge en el mismo nodo que la IU de Edge y el servidor de administración, o en su propio nodo. Asegúrate de que el SSO de Edge tenga acceso al servidor de administración a través del puerto 8080.
El puerto 9099 debe estar abierto en el nodo de SSO de Edge para admitir el acceso al SSO de Edge desde un navegador, desde el IDP de SAML externo y desde el servidor de administración y la IU de Edge. Como parte de la configuración del SSO de Edge, puedes especificar que la conexión externa use HTTP o el protocolo HTTPS encriptado.
El SSO de Edge usa una base de datos de Postgres a la que se puede acceder en el puerto 5432 del nodo de Postgres. Por lo general, puedes usar el mismo servidor de Postgres que instalaste con Edge, ya sea un servidor de Postgres independiente o dos servidores de Postgres configurados en modo principal/en espera. Si la carga en tu servidor de Postgres es alta, también puedes optar por crear un nodo de Postgres independiente solo para el SSO de Edge.
Con SAML habilitado, el acceso a la IU de Edge y a la API de Management de Edge usa tokens de acceso de OAuth2. Estos tokens los genera el módulo de SSO de Edge, que acepta las aserciones de SAML que devuelve tu IdP.
Una vez que se genera a partir de una aserción de SAML, el token de OAuth es válido durante 30 minutos y el token de actualización es válido durante 24 horas. Es posible que tu entorno de desarrollo admita la automatización de tareas de desarrollo comunes, como la automatización de pruebas o la integración continua/implementación continua (CI/CD), que requieren tokens con una duración más larga. Consulta Usa SAML con tareas automatizadas para obtener información sobre cómo crear tokens especiales para tareas automatizadas.
URLs de la IU y la API de Edge
La URL que usas para acceder a la IU de Edge y a la API de Management de Edge es la misma que usabas antes de habilitar SAML. Para la IU de Edge:
http://edge_ui_IP_DNS:9000 https://edge_ui_IP_DNS:9000
donde edge_ui_IP_DNS es la dirección IP o el nombre de DNS de la máquina que aloja la IU de Edge. Como parte de la configuración de la IU de Edge, puedes especificar que la conexión use HTTP o el protocolo HTTPS encriptado.
Para la API de administración de Edge, haz lo siguiente:
http://ms_IP_DNS:8080/v1 https://ms_IP_DNS:8080/v1
en el que ms_IP_DNS es la dirección IP o el nombre de DNS del servidor de administración. Como parte de la configuración de la API, puedes especificar que la conexión use HTTP o el protocolo HTTPS encriptado.
Configura TLS en el SSO de Edge
De forma predeterminada, la conexión al SSO de Edge usa HTTP en el puerto 9099 en el nodo que aloja
apigee-sso, el módulo de SSO de Edge. En apigee-sso, se incluye una instancia de Tomcat
que controla las solicitudes HTTP y HTTPS.
El SSO de Edge y Tomcat admiten tres modos de conexión:
- DEFAULT: La configuración predeterminada admite solicitudes HTTP en el puerto 9099.
- SSL_TERMINATION: Habilita el acceso TLS al SSO de Edge en el puerto que elijas. Debes especificar una clave y un certificado TLS para este modo.
- SSL_PROXY: Configura el SSO de Edge en modo de proxy, lo que significa que instalaste un balanceador de cargas frente a
apigee-ssoy finalizaste TLS en el balanceador de cargas. Puedes especificar el puerto que se usa enapigee-ssopara las solicitudes del balanceador de cargas.
Habilita la compatibilidad con SAML para el portal
Después de habilitar la compatibilidad con SAML para Edge, puedes habilitar SAML para el portal de servicios para desarrolladores de Apigee (o simplemente, el portal). El portal admite la autenticación de SAML cuando se realizan solicitudes a Edge. Ten en cuenta que esto es diferente de la autenticación de SAML para el acceso de desarrolladores al portal. La autenticación de SAML para el acceso de desarrolladores se configura por separado. Consulta Configura el portal para usar SAML y comunicarte con Edge para obtener más información.
Como parte de la configuración del portal, debes especificar la URL del módulo de SSO de Edge que instalaste con Edge:
