Package org.apache.syncope.common.rest.api.service

Interface AccessTokenService

All Superinterfaces:

JAXRSService

All Known Implementing Classes:

AccessTokenServiceImpl

@Path("accessTokens")
public interface AccessTokenService
extends JAXRSService

REST operations for access tokens.

Field Summary

Fields inherited from interface org.apache.syncope.common.rest.api.service.JAXRSService

CRLF, DOUBLE_DASH, PARAM_ANYTYPE_KIND, PARAM_ANYTYPEKEY, PARAM_CONNID_PAGED_RESULTS_COOKIE, PARAM_DETAILS, PARAM_ENTITY_KEY, PARAM_FIQL, PARAM_KEYWORD, PARAM_MAX, PARAM_NOTIFICATION, PARAM_ORDERBY, PARAM_PAGE, PARAM_REALM, PARAM_RECURSIVE, PARAM_RESOURCE, PARAM_SIZE, PARAM_USER

Method Summary

Modifier and Type	Method	Description
void	delete(String key)	Invalidates the access token matching the provided key.
PagedResult<AccessTokenTO>	list(AccessTokenQuery query)	Returns a paged list of existing access tokens matching the given query.
javax.ws.rs.core.Response	login()	Returns an empty response bearing the X-Syncope-Token header value, in case of successful authentication.
void	logout()	Invalidates the access token of the requesting user.
javax.ws.rs.core.Response	refresh()	Returns an empty response bearing the X-Syncope-Token header value, with extended lifetime.

Method Detail

login

@POST
@Path("login")
@Produces({"application/json","application/yaml","application/xml"})
javax.ws.rs.core.Response login()

Returns an empty response bearing the X-Syncope-Token header value, in case of successful authentication. The provided value is a signed JSON Web Token.

Returns:

empty response bearing the X-Syncope-Token header value, in case of successful authentication

refresh

@POST
@Path("refresh")
@Produces({"application/json","application/yaml","application/xml"})
javax.ws.rs.core.Response refresh()

Returns an empty response bearing the X-Syncope-Token header value, with extended lifetime. The provided value is a signed JSON Web Token.

Returns:

an empty response bearing the X-Syncope-Token header value, with extended lifetime

logout

@POST
@Path("logout")
@Produces({"application/json","application/yaml","application/xml"})
void logout()

Invalidates the access token of the requesting user.

list

@GET
@Consumes({"application/json","application/yaml","application/xml"})
@Produces({"application/json","application/yaml","application/xml"})
PagedResult<AccessTokenTO> list(@BeanParam
                                AccessTokenQuery query)

Returns a paged list of existing access tokens matching the given query.

Parameters:

query - query conditions

Returns:

paged list of existing access tokens matching the given query

delete

@DELETE
@Path("{key}")
@Produces({"application/json","application/yaml","application/xml"})
void delete(@PathParam("key")
            String key)

Invalidates the access token matching the provided key.

Parameters:

key - access token key