3
,[ @ sn d Z ddlmZmZ ddlZddlmZ ddlmZm Z m
Z
m Z ddl m
Z
mZ ejeZG d d
d
e
ZdS ) z
oauthlib.oauth2.rfc6749.endpoint.revocation
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
An implementation of the OAuth 2 `Token Revocation`_ spec (draft 11).
.. _`Token Revocation`: https://tools.ietf.org/html/draft-ietf-oauth-revocation-11
)absolute_importunicode_literalsN)Request )InvalidClientErrorInvalidRequestError OAuth2ErrorUnsupportedTokenTypeError ) BaseEndpoint catch_errors_and_unavailabilityc @ s4 e Zd ZdZd
ZdddZedd d
Zd d ZdS )RevocationEndpointzToken revocation endpoint.
Endpoint used by authenticated clients to revoke access and refresh tokens.
Commonly this will be part of the Authorization Endpoint.
access_token
refresh_tokenNFc C s& t j| || _|p| j| _|| _d S )N)r __init__request_validatorvalid_token_typessupported_token_types enable_jsonp)selfr r r r /usr/lib/python3.6/revocation.pyr ! s
zRevocationEndpoint.__init__POSTc C s t ||||d}y| j| tjd| W nV tk
r } z:tjd|| |j}| jrj|jrjd|j|f }i ||jfS d}~X nX | j j
|j |j | d}| jr|jr|jd }i |dfS ) a Revoke supplied access or refresh token.
The authorization server responds with HTTP status code 200 if the
token has been revoked sucessfully or if the client submitted an
invalid token.
Note: invalid tokens do not cause an error response since the client
cannot handle such an error in a reasonable way. Moreover, the purpose
of the revocation request, invalidating the particular token, is
already achieved.
The content of the response body is ignored by the client as all
necessary information is conveyed in the response code.
An invalid token type hint value is ignored by the authorization server
and does not influence the revocation response.
) http_methodbodyheadersz Token revocation valid for %r.z)Client error during validation of %r. %r.z%s(%s);N z(); )
r validate_revocation_requestlogdebugr Zjsonr callbackZ status_coder Z revoke_tokentokentoken_type_hint)r Zurir r r requesteZ
response_bodyr r r create_revocation_response) s"
z-RevocationEndpoint.create_revocation_responsec C s |j st|dd| jj|rB| jj|shtjd| t|dn&| jj|j |shtjd| t|d|j
r|j
| j kr|j
| j krt
|ddS )a Ensure the request is valid.
The client constructs the request by including the following parameters
using the "application/x-www-form-urlencoded" format in the HTTP
request entity-body:
token (REQUIRED). The token that the client wants to get revoked.
token_type_hint (OPTIONAL). A hint about the type of the token
submitted for revocation. Clients MAY pass this parameter in order to
help the authorization server to optimize the token lookup. If the
server is unable to locate the token using the given hint, it MUST
extend its search accross all of its supported token types. An
authorization server MAY ignore this parameter, particularly if it is
able to detect the token type automatically. This specification
defines two such values:
* access_token: An Access Token as defined in [RFC6749],
`section 1.4`_
* refresh_token: A Refresh Token as defined in [RFC6749],
`section 1.5`_
Specific implementations, profiles, and extensions of this
specification MAY define other values for this parameter using
the registry defined in `Section 4.1.2`_.
The client also includes its authentication credentials as described in
`Section 2.3`_. of [`RFC6749`_].
.. _`section 1.4`: https://tools.ietf.org/html/rfc6749#section-1.4
.. _`section 1.5`: https://tools.ietf.org/html/rfc6749#section-1.5
.. _`section 2.3`: https://tools.ietf.org/html/rfc6749#section-2.3
.. _`Section 4.1.2`: https://tools.ietf.org/html/draft-ietf-oauth-revocation-11#section-4.1.2
.. _`RFC6749`: https://tools.ietf.org/html/rfc6749
zMissing token parameter.)r$ descriptionz!Client authentication failed, %r.)r$ N)r" r r Z client_authentication_requiredZauthenticate_clientr r r Zauthenticate_client_idZ client_idr# r r r )r r$ r r r r R s %
z.RevocationEndpoint.validate_revocation_request)r r )NF)r NN) __name__
__module__ __qualname____doc__r r r r& r r r r r r
s
'r
)r+ Z
__future__r r ZloggingZoauthlib.commonr errorsr r r r baser r Z getLoggerr( r r
r r r r s