About OAuth 2 Policy Implementation (Nov 2017)
This following diagram shows how the OAuth 2 policy works with an existing OpenAM or PingFederate authorization server, or OpenID Connect Token Introspection endpoint, to protect access to your API version.
The user or application requests an access token using any valid grant type defined in the client application.
The user or application sends a request with the access token. The federated policy validates the access token, provided as a well-formed query param or authorization header.
The federated policy validates the token against the OAuth provider. To improve performance, Mule caches the call to the authorization server, which is only performed once during the lifetime of the token.
When OpenId, PingFederate, or OAuth 2.0 Access Token Enforcement Using External Provider policies are in effect and your API is deployed under Mule 4, the client ID returned by the OAuth provider is validated by the Client Id Enforcement policy.
All fulfilled requests in the flow are enriched with the information provided by the OAuth Provider when running under Mule 4, but information is not returned to the user. In releases earlier than Mule 4, this information was returned to the user.
Possible responses are:
Mule 4.0.0 or later
The token was successfully validated.
400 Bad Request
This Bad Request error can be caused by: no token sent, the token was sent both as query param and header, or the token was sent as header but does not have prefix "Bearer".
The token is unauthorized.
This error could be the result of the validation to the OAuth Provider, the scopes validation, or the result of Client Id Enforcement Policy.
The following diagram represents a successfully validated token for OpenId, PingFederate, and OAuth 2.0 Access Token Enforcement Using External Provider policies:
The following diagram represents a successfully validated for OpenAM policy:
The following diagram represents an Unauthorized Token error:
The following diagram represents a Forbidden Error from OAuth Provider error:
The following diagram represents Invalid Scopes error:
The following diagram represents a Client Id Enforcement Validation Failed (Not valid for OpenAM Policy) error:
The following diagram represents a Bad Request error: