Redback Rest Support

Prior to 1.3 version some redback services are available trough rest request.

We use jaxrs annotations and authz/karma are verified through cxf interceptors.

Maven Module

You must add the following maven dependency


CXF setup

The spring file is in the redback-rest-services module. You must add META-INF/spring-context.xml in your spring configuration.

And add cxf servlet in your web.xml :



CXF interceptors

Rest services are declared as it in the cxf configuration :

  <jaxrs:server id="redbackServices" address="/redbackServices">
      <ref bean="authenticationInterceptor#rest"/>
      <ref bean="permissionInterceptor#rest"/>
      <ref bean="userService#rest"/>
      ... more coming ...


This interceptor is basic on HTTP BASIC authz with using HttpBasicAuthentication spring component.


This inceptor will use a new created annotation named @RedbackAuthorization which supports attributes : permissions, resource and noRestriction.

You can use it :

   @RedbackAuthorization( permissions = "user-management-user-create" )
   public Boolean deleteUser( @PathParam( "userName" ) String username )

The interceptor will basically check if the user has one of the required permissions.

Note all exposed services must be marked with this annotation. If not forbidden http response will be returned.

If the service doesn't need special permissions you must do :

   @RedbackAuthorization(noRestriction = true)
   public Boolean ping()

Client Usage

Dependencies to add in order to use those REST Services


    if you use CXF:


Sample on how to use

Error during retrieving content skip as ignoreDownloadError activated.
Error during retrieving content skip as ignoreDownloadError activated.