Step 2: Test Authentication

Once you have the username and password for your NAPI account, you can use the Test Authentication endpoint to check that they're working. The only thing you need to provide in this request is an authorization header, as shown below. To generate the "ACCESS_TOKEN" portion of the header, combine your username and password into a string username:password and run the resulting string through Base64 encryption. Alternatively, you can use a program such as SOAPUI or Postman to construct the authorization header for you.

Request

GET <<endpoint>>/v3/connection/testauthentication
Authorization: OAuth
//Example Username: JoeNapoli_API_Demo, Example Password: 05uZuPRCyPi!6
var truliooClient = new TruliooApiClient("JoeNapoli_API_Demo", "05uZuPRCyPi!6");
var responseString = await truliooClient.Connection
    .TestAuthenticationAsync();
//Example Username: JoeNapoli_API_Demo, Example Password: 05uZuPRCyPi!6
ApiClient apiClient = new ApiClient();
apiClient.setUsername("JoeNapoli_API_Demo");
apiClient.setPassword("05uZuPRCyPi!6");
ConnectionApi connectionClient = new ConnectionApi(apiClient);

//testAuthentication
String testResult = connectionClient.testAuthentication();

//testAuthenticationAsync
connectionClient.testAuthenticationAsync(new ApiCallback<String>() {
    @Override
    public void onFailure(ApiException e, int statusCode, Map<String, List<String>> responseHeaders) {
        Logger.getLogger(SdkJavaV1Sample.class.getName()).log(Level.SEVERE, null, e);
    }
    @Override
    public void onSuccess(String result, int statusCode, , Map<String, List<String>> responseHeaders) {
        System.out.println(result);
    }
    @Override
    public void onUploadProgress(long bytesWritten, long contentLength, boolean done) {
        //To change body of generated methods, choose Tools | Templates.
    }
    @Override
    public void onDownloadProgress(long bytesRead, long contentLength, boolean done) {
        //To change body of generated methods, choose Tools | Templates.
    }
});

🚧

Important:

Trulioo provides multiple global and regional endpoints. Please choose the correct endpoint based on your business use case and your regulatory and compliance requirements. See the full list here.

Response

Hello JoeNapoli_API_Demo

You should receive a response containing your username, as shown above. The most common reasons for an error response are:

  • The authorization header isn't set properly. It should be a Base64 - encrypted Basic Authentication header.
  • The spelling is incorrect.
  • The wrong credentials were used.

Ensure that you are setting the authorization header correctly, using the right username/password without any typos.

🚧

Error Messages

If you aren't receiving a successful response of the string you sent as a parameter visit our Error Page here to diagnose.

📘

Frequently Asked Questions

1. Do I need to get my IP address whitelisted?

No, Global Gateway only uses Basic Authentication where the Username and Password are combined into a string "username:password". The resulting string is then encoded. Reach out to [email protected] for your API credentials.