Testing Authentication with Jersey REST Client

Learn to build Jersey rest client using HttpAuthenticationFeature, which can be used to access REST APIs behind authentication/authorization security. For example, we will create jersey client for services which we secured in Jersey Secured REST APIs tutorial; and I will be extending the sourcecode created for Jersey RESTful client example.

Table of Contents

1. HttpAuthenticationFeature
2. How to secure REST APIs
3. Jersey REST Client Code

1. Jersey Client – HttpAuthenticationFeature

HttpAuthenticationFeature class provides HttpBasic and Digest client authentication capabilities. The feature work in one of 4 modes i.e. BASIC, BASIC NON-PREEMPTIVE, DIGEST and UNIVERSAL. Let’s quickly learn about them.

  1. BASIC – It’s preemptive authentication way i.e. information is send always with each HTTP request. This mode must be combined with usage of SSL/TLS as the password is send only BASE64 encoded.
  2. BASIC NON-PREEMPTIVE – It’s non-preemptive authentication way i.e. auth information is added only when server refuses the request with 401 status code and then the request is repeated with authentication information.
  3. DIGEST – Http digest authentication. Does not require usage of SSL/TLS.
  4. UNIVERSAL – Combination of basic and digest authentication in non-preemptive mode i.e. in case of 401 response, an appropriate authentication is used based on the authentication requested as defined in WWW-Authenticate HTTP header.

To use HttpAuthenticationFeature, build an instance of it and register with client.

1.1. Basic authentication mode

HttpAuthenticationFeature feature = HttpAuthenticationFeature.basic("username", "password");

final Client client = ClientBuilder.newClient();

1.2. Basic authentication – non-prempitive mode

 HttpAuthenticationFeature feature = HttpAuthenticationFeature.basicBuilder()
     								.credentials("username", "password")

final Client client = ClientBuilder.newClient();

1.3. Universal mode

//HttpAuthenticationFeature feature = HttpAuthenticationFeature.universal("username", "password");

//Universal builder having different credentials for different schemes
HttpAuthenticationFeature feature = HttpAuthenticationFeature.universalBuilder()
				.credentialsForBasic("username1", "password1")
				.credentials("username2", "password2").build();

final Client client = ClientBuilder.newClient();

2. How to secure REST APIs

For authentication enabled rest apis, use roles related annotations, such as @RolesAllowed. For example, this is the code of secured REST API.

public class JerseyService 
	public Employees getAllEmployees() 
		Employees list = new Employees();
		list.setEmployeeList(new ArrayList<Employee>());
		list.getEmployeeList().add(new Employee(1, "Lokesh Gupta"));
		list.getEmployeeList().add(new Employee(2, "Alex Kolenchiskey"));
		list.getEmployeeList().add(new Employee(3, "David Kameron"));
		return list;

Read More : Jersey Secured REST APIs Tutorial

3. Jersey REST Client Code

Below is the jersey rest client basic authentication example which accept username and password details for authentication purpose.

public static void main(String[] args) throws IOException 

private static void httpGETCollectionExample() 
	ClientConfig clientConfig = new ClientConfig();

	HttpAuthenticationFeature feature = HttpAuthenticationFeature.basic("howtodoinjava", "password");
	clientConfig.register( feature) ;


	Client client = ClientBuilder.newClient( clientConfig );
	WebTarget webTarget = client.target("http://localhost:8080/JerseyDemos/rest").path("employees");
	Invocation.Builder invocationBuilder =	webTarget.request(MediaType.APPLICATION_JSON);
	Response response = invocationBuilder.get();
	if(response.getStatus() == 200)
		Employees employees = response.readEntity(Employees.class);
		List<Employee> listOfEmployees = employees.getEmployeeList();
		System.out.println(Arrays.toString( listOfEmployees.toArray(new Employee[listOfEmployees.size()]) ));

3.1. Output with correct username/password

[Employee [id=1, name=Lokesh Gupta], Employee [id=2, name=Alex Kolenchiskey], Employee [id=3, name=David Kameron]]

3.2. Output with in-correct username/password


Drop me your queries in comments section.

Happy Learning !!

Was this post helpful?

Join 7000+ Awesome Developers

Get the latest updates from industry, awesome resources, blog updates and much more.

* We do not spam !!

23 thoughts on “Testing Authentication with Jersey REST Client”

  1. Thanks for the post , It’s really nice and informative but i have doubt .
    How to authenticate a Rest web service with Client “Security Certificate” , PEM File and Pass Pharse using Jersey client or any other client in java.

    Thanks in advance 🙂

  2. how ADMIN played role here. I still do not understand. You declare rolesallowed annotation. But how to identify that request from client side is made from particular user/role.

    Here, in client side code, ADMIN role is not specified. Please elaborate.

  3. Hi ,

    I want to fetch data from HPQC URL. When ever I run the code I get following error :
    Could you please help me with it

    Exception in thread “main” javax.ws.rs.NotAuthorizedException: HTTP 401 No credentials found the request.
    at org.glassfish.jersey.client.JerseyInvocation.convertToException(JerseyInvocation.java:1080)
    at org.glassfish.jersey.client.JerseyInvocation.translate(JerseyInvocation.java:883)
    at org.glassfish.jersey.client.JerseyInvocation.lambda$invoke$1(JerseyInvocation.java:767)
    at org.glassfish.jersey.internal.Errors.process(Errors.java:316)
    at org.glassfish.jersey.internal.Errors.process(Errors.java:298)
    at org.glassfish.jersey.internal.Errors.process(Errors.java:229)
    at org.glassfish.jersey.process.internal.RequestScope.runInScope(RequestScope.java:414)
    at org.glassfish.jersey.client.JerseyInvocation.invoke(JerseyInvocation.java:765)
    at org.glassfish.jersey.client.JerseyInvocation$Builder.method(JerseyInvocation.java:428)
    at org.glassfish.jersey.client.JerseyInvocation$Builder.get(JerseyInvocation.java:324)
    at alm.HPQC_Projects.main(HPQC_Projects.java:37)

    public static void main(String args[]){
    ClientConfig clientConfig = new ClientConfig();
    Client client = ClientBuilder.newClient(clientConfig);
    HttpAuthenticationFeature feature = HttpAuthenticationFeature.digest(“XXX”, “XXX”);
    WebTarget url = client.target(“hpqc_URL”);

    String result = url.request().get(String.class);


  4. Please can you provide me the dependencies required

    I get the below error

    The method basic(String, String) is undefined for the type HttpAuthenticator

    also below error

    The method newClient() is undefined for the type ClientFilter

    My code

    public class Example {
    public static void main(String a[]){
    HttpAuthenticator feature = HttpAuthenticator.basic(“username”, “password”);
    final Client client = ClientFilter.newClient();

    Will i be able to connect in rest 2 APIs using above code

  5. I am able to do authentication and authorization using provided details, now I want to do some logging for each REST call, i want to fetch the details of the User and log in our system, how can I get user details in my API call.

  6. I am user jersey client 2.4 on gradle build. I am not able to resolve the HttpAuthenticationFeature class. Can anyone please tell the library and import statement for this class.

  7. I am unable to POST java pojo object with authentication using webtarget. Can i get some example code snippet for authentication with POST method?

  8. Hi Lokes,

    I want to connect to JIRA using username and password.
    I have URL as with username and password.
    Please provide a demo code for that

  9. There is following way to configure the authentication header in Jersey API .

    //Universal builder having different credentials for different schemes
    HttpAuthenticationFeature feature = HttpAuthenticationFeature.universalBuilder()
    .credentialsForBasic(“username1”, “password1”)
    .credentials(“username2”, “password2”).build();

    final Client client = ClientBuilder.newClient();

    But not able to figure out how to pass extra parameter to authentication header for e.g. IntegatorKey, SendBehalfOf. those are specific REST service call.

    In My Case to call REST service need to pass following parameter as part of authentication header .

    2. Password
    3. IntegatorKey
    4. SendBehalfOf

    How should I achieve this using the jersey API ?

  10. Hi,

    The example is fine for standalone java application for testing , could you please help to achieve the same for browser based application and how it can be done in both client and server side. Please if you have any example please share us.

  11. I want to know how to get the data from the restfull Api which is digest authenticated in android. Please acknowledge me ASAP waiting for your response.

    Thank you

    Mukta Bansal

  12. How to call secure rest api from java client? I am getting SSLHandshake Exception. I am using BasicAuth in my code.

    By typing url(https) in web browser, Browser prompts for userid and password then its return WADL file.

    Please share the code to access these REST API.


Leave a Comment


A blog about Java and related technologies, the best practices, algorithms, and interview questions.