AuthenticationResource (Silverpeas Core 6.3 API)

java.lang.Object
- org.silverpeas.core.web.rs.RESTWebService
- - org.silverpeas.core.webapi.profile.AuthenticationResource

All Implemented Interfaces:

ProtectedWebResource, WebAuthenticationValidation, WebAuthorizationValidation, SilverpeasWebResource
```
@WebService
@Path("authentication")
public class AuthenticationResource
extends RESTWebService
```
A REST-based Web service that handles the authentication of a user to the data server. If the authentication matches the basic authentication scheme, then a session is opened in Silverpeas for the user behind the request and that session can be used both for browsing the Silverpeas web portal or to access the REST API by the same client. If the authentication matches a bearer authentication scheme, then a session is created just for the HTTP request. The latter is then pertinent only to check the authorization of the user to access the REST API of Silverpeas.
This service is only interesting for opening an HTTP session before performing several tasks in Silverpeas. It avoids to authenticate the user by its login and password for each HTTP request against the REST API of Silverpeas. Nevertheless, the recommended (and better) way to consume the REST API is to use the bearer authentication scheme with the API token of the user; the token can be passed in each request against the REST API in the Authorization HTTP header without passing through the heaver authentication mechanism by user credentials (login/domain/password).

Nested Class Summary
- Nested classes/interfaces inherited from class org.silverpeas.core.web.rs.RESTWebService
  RESTWebService.WebProcess<R>, RESTWebService.WebTreatment<R>

Field Summary
- Fields inherited from class org.silverpeas.core.web.rs.RESTWebService
  RESPONSE_HEADER_ARRAYSIZE
- Fields inherited from interface org.silverpeas.core.web.SilverpeasWebResource
  BASE_PATH

Constructor Summary

Constructors
Constructor Description

AuthenticationResource()

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`UserProfileEntity`	`authenticate()`	Authenticates the user identified either by its credentials passed through the Authorization HTTP header.
`String`	`getComponentId()`	Gets the identifier of the component instance to which the requested resource belongs to.
`protected String`	`getResourceBasePath()`	Gets the base path of the web resource relative to the root path of all of the web resources in Silverpeas as given by `SilverpeasWebResource.getBasePath()`.

Methods inherited from class org.silverpeas.core.web.rs.RESTWebService
fromPage, getBundle, getBundleLocation, getHighestUserRole, getHttpRequest, getHttpServletRequest, getHttpServletResponse, getOrganisationController, getSilverpeasContext, getUri, getUser, getUserPreferences, getUserRoles, identifiedBy, identifiedBy, initContext, initWebResourceUri, isUserDefined, process

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.silverpeas.core.web.rs.ProtectedWebResource
validateUserAuthorization

Methods inherited from interface org.silverpeas.core.web.rs.WebAuthenticationValidation
validateUserAuthentication

- Constructor Detail
  - AuthenticationResource
```
public AuthenticationResource()
```
- Method Detail
  - authenticate
```
@POST
@Produces("application/json")
public UserProfileEntity authenticate()
```
    Authenticates the user identified either by its credentials passed through the Authorization HTTP header.
    
    Returns:
    
    The profile of the user once authenticated.
  - getResourceBasePath
```
protected String getResourceBasePath()
```
    Description copied from class: RESTWebService
    
    Gets the base path of the web resource relative to the root path of all of the web resources in Silverpeas as given by SilverpeasWebResource.getBasePath().
    
    Specified by:
    
    getResourceBasePath in class RESTWebService
    
    Returns:
    
    the relative path that identifies this REST web service among all other REST web services.
  - getComponentId
```
public String getComponentId()
```
    Description copied from interface: SilverpeasWebResource
    
    Gets the identifier of the component instance to which the requested resource belongs to.
    
    Returns:
    
    the identifier of the Silverpeas component instance.