Estás viendo la documentación de Apigee Edge.
Ir a la
documentación de Apigee X. info
Para hacer su trabajo como un servidor de autorización de OAuth2, Apigee Edge debe exponer los extremos donde los clientes pueden solicitar tokens y códigos de autenticación. En este tema, se ofrece una introducción rápida a estos extremos y se muestra cómo configurarlos en Edge.
¿Qué es un extremo de OAuth2?
Un extremo de OAuth2 es una URL a la que los clientes llaman para solicitar tokens OAuth (o códigos de autenticación). A continuación, se muestra una solicitud de ejemplo de un token de acceso:
$ curl -i -H 'ContentType: x-www-form-urlencoded' \ -X POST 'https://docs-test.apigee.net/oauth/client_credential/accesstoken' \ -d 'grant_type=client_credentials' \ -H 'Authorization: Basic c3FIOG9vSGV4VHo4QzAySVg5T1JvNnJoZ3ExaVNyQWw6WjRsanRKZG5lQk9qUE1BVQ'
En tu entorno de Apigee Edge, se requiere una política para controlar este tipo de solicitud. Como puedes
inferir de la solicitud, la política debe admitir el tipo de otorgamiento de "credenciales de cliente" y
la política debe ejecutarse en la ruta /oauth/client_credentials/accesstoken.
La política correcta en este caso es una política de OAuthV2, configurada para ejecutarse en un flujo como se ilustra en el siguiente ejemplo (en el que el nombre de la política es GenerateAccessTokenClient):
<Flow name="AccessTokenClientCredential">
<Description/>
<Request>
<Step>
<FaultRules/>
<Name>GenerateAccessTokenClient</Name>
</Step>
</Request>
<Response/>
<Condition>(proxy.pathsuffix MatchesPath "/accesstoken") and (request.verb = "POST")</Condition>
</Flow>Si el cliente proporciona las credenciales correctas, la política genera y muestra un token; de lo contrario, muestra un error.
Cómo ubicar los extremos predeterminados
De forma predeterminada, Apigee agrega un proxy de extremo de OAuth2 de ejemplo a cada organización nueva que it crea. Si buscas, encontrarás un proxy llamado oauth en tu organización.
Para encontrar este proxy, haz lo siguiente:
- Accede a la página Proxies de API, como se describe a continuación.
Edge
Para acceder a la página Proxies de API con la IU de Edge, haz lo siguiente:
- Accede a apigee.com/edge.
- Selecciona Desarrollar > Proxies de API en la barra de navegación izquierda.
- Haz clic en Proxy.
Classic Edge (nube privada)
Para acceder a la página Proxies de API con la IU de Classic Edge, haz lo siguiente:
- Accede a
http://ms-ip:9000, donde ms-ip es la dirección IP o el nombre de DNS del nodo del servidor de administración. - Selecciona API > Proxies de API en la barra de navegación superior.
- En la lista de proxies, selecciona el que se llama oauth.
- En la página de descripción general del proxy, selecciona la pestaña Desarrollar para abrir el editor de proxy y examinar las políticas y los flujos en el proxy.
Práctica recomendada: Crea tu propio proxy de extremo de OAuth2
El proxy oauth predeterminado es limitado: solo admite el tipo de otorgamiento de credenciales de cliente. Este proxy solo debe ser un ejemplo. Para la producción, te recomendamos crear un proxy que configure los extremos de OAuth2 que cumplan con tus requisitos.
Una nota importante: Un proxy que define extremos de OAuth2 suele ser un proxy sin destino. El proxy actúa como un servicio que se ejecuta en el ProxyEndpoint y regresa directamente de vuelta al cliente.