En esta sección, se proporciona una descripción general de cómo los servicios de directorio externos se integran en una instalación existente de Apigee Edge para la nube privada. Esta función está diseñada para funcionar con cualquier servicio de directorio que admita LDAP, como Active Directory, SymasLDAP y otros.
Una solución LDAP externa permite a los administradores del sistema administrar las credenciales de los usuarios desde un servicio de administración de directorios centralizado, externo a sistemas como Apigee Edge que los usan. La función que se describe en este documento admite la autenticación de vinculación directa e indirecta.
Para obtener instrucciones detalladas sobre cómo configurar un servicio de directorio externo, consulta Configuración de la autenticación externa.
Público
En este documento, se supone que eres un administrador global del sistema de Apigee Edge para la Nube privada y que tienes una cuenta del servicio de directorio externo.
Descripción general
De forma predeterminada, Apigee Edge usa una instancia interna de SymasLDAP para almacenar las credenciales que se usan para la autenticación de usuarios. Sin embargo, puedes configurar Edge para que use un servicio LDAP de autenticación externo en lugar del interno. El procedimiento para esta configuración externa se explica en este documento.
Edge también almacena credenciales de autorización de acceso basado en roles en una instancia de LDAP interna y separada. Ya sea que configures o no un servicio de autenticación externo, las credenciales de autorización siempre se almacenan en esta instancia LDAP interna. En este documento, se explica el procedimiento para agregar usuarios que existen en el sistema LDAP externo al LDAP de autorización de Edge.
Ten en cuenta que la autenticación se refiere a la validación de la identidad de un usuario, mientras que la autorización se refiere a la verificación del nivel de permiso que se le otorga a un usuario autenticado para usar las funciones de Apigee Edge.
Qué necesitas saber sobre la autenticación y la autorización de Edge
Es útil comprender la diferencia entre la autenticación y la autorización, y cómo Apigee Edge administra estas dos actividades.
Acerca de la autenticación
Los usuarios que acceden a Apigee Edge a través de la IU o las APIs deben autenticarse. De forma predeterminada, las credenciales de usuario de Edge para la autenticación se almacenan en una instancia interna de SymasLDAP. Por lo general, los usuarios deben registrarse o se les pide que se registren para obtener una cuenta de Apigee, y, en ese momento, proporcionan su nombre de usuario, dirección de correo electrónico, credenciales de contraseña y otros metadatos. Esta información se almacena en el LDAP de autenticación y se administra a través de él.
Sin embargo, si deseas usar un LDAP externo para administrar las credenciales del usuario en nombre de Edge, puedes hacerlo configurando Edge para que use el sistema LDAP externo en lugar del interno. Cuando se configura un LDAP externo, las credenciales del usuario se validan en ese almacén externo, como se explica en este documento.
Acerca de la autorización
Los administradores de la organización de Edge pueden otorgar permisos específicos a los usuarios para que interactúen con entidades de Apigee Edge, como proxies de API, productos, cachés, implementaciones, etcétera. Los permisos se otorgan a través de la asignación de roles a los usuarios. Edge incluye varios roles integrados y, si es necesario, los administradores de la organización pueden definir roles personalizados. Por ejemplo, se le puede otorgar autorización a un usuario (a través de un rol) para crear y actualizar proxies de API, pero no para implementarlos en un entorno de producción.
La credencial de clave que usa el sistema de autorización de Edge es la dirección de correo electrónico del usuario. Esta credencial (junto con otros metadatos) siempre se almacena en el LDAP de autorización interno de Edge. Este LDAP es completamente independiente del LDAP de autenticación (ya sea interno o externo).
Los usuarios que se autentican a través de un LDAP externo también deben aprovisionarse manualmente en el sistema LDAP de autorización. Los detalles se explican en este documento.
Para obtener más información sobre la autorización y el RBAC, consulta Administra usuarios de la organización y Asigna roles.
Para obtener una vista más detallada, consulta también Cómo comprender los flujos de autenticación y autorización de Edge.
Información sobre la autenticación de vinculación directa e indirecta
La función de autorización externa admite la autenticación de vinculación directa e indirecta a través del sistema LDAP externo.
Resumen: La autenticación de vinculación indirecta requiere una búsqueda en el LDAP externo de las credenciales que coincidan con la dirección de correo electrónico, el nombre de usuario o cualquier otro ID que proporcione el usuario al acceder. Con la autenticación de vinculación directa, no se realiza ninguna búsqueda: las credenciales se envían directamente al servicio LDAP y este las valida. La autenticación de vinculación directa se considera más eficiente porque no implica búsquedas.
Acerca de la autenticación de vinculación indirecta
Con la autenticación de vinculación indirecta, el usuario ingresa una credencial, como una dirección de correo electrónico, un nombre de usuario o algún otro atributo, y el sistema de autenticación de Edge busca esta credencial o valor. Si el resultado de la búsqueda es correcto, el sistema extrae el DN de LDAP de los resultados de la búsqueda y lo usa con una contraseña proporcionada para autenticar al usuario.
El punto clave que debes conocer es que la autenticación de vinculación indirecta requiere que el llamador (p.ej., Apigee Edge) para proporcionar credenciales de administrador de LDAP externas, de modo que Edge pueda "acceder" al LDAP externo y realizar la búsqueda. Debes proporcionar estas credenciales en un archivo de configuración de Edge, que se describe más adelante en este documento. También se describen los pasos para encriptar la credencial de contraseña.
Acerca de la autenticación de vinculación directa
Con la autenticación de vinculación directa, Edge envía las credenciales que ingresa un usuario directamente al sistema de autenticación externo. En este caso, no se realiza ninguna búsqueda en el sistema externo. Las credenciales proporcionadas se validan o no (p.ej., si el usuario no está presente en el LDAP externo o si la contraseña es incorrecta, el acceso fallará).
La autenticación de vinculación directa no requiere que configures credenciales de administrador para el sistema de autenticación externo en Apigee Edge (como con la autenticación de vinculación indirecta). Sin embargo, hay un paso de configuración simple que debes realizar, el cual se describe en Configuración de la autenticación externa.
Accede a la comunidad de Apigee
La comunidad de Apigee es un recurso gratuito en el que puedes comunicarte con Apigee y otros clientes de Apigee con preguntas, sugerencias y otros problemas. Antes de publicar contenido en la comunidad, asegúrate de buscar primero las publicaciones existentes para ver si ya se respondió tu pregunta.