Telesign Full-service Java SDK

Telesign connects, protects, and defends the customer experience with intelligence from billions of digital interactions and mobile signals. Through developer-friendly APIs that deliver user verification, digital identity, and omnichannel communications, we help the world's largest brands secure onboarding, maintain account integrity, prevent fraud, and streamline omnichannel engagement.

Requirements

• JDK 7+
• (Optional) Gradle This package manager isn't required to use this SDK, but it is required to use the installation instructions below.
• (Optional) Kotlin This domain-specific langage (DSL) isn't required to use this SDK, but it is required to use the installation instructions below. These installation steps rely on using Kotlin as your DSL for the build script in the Gradle project. Some steps need to be adapted if you are using Groovy as your DSL.

NOTE:

These instructions are for MacOS. They will need to be adapted if you are installing on Windows.

Installation

Follow these steps to add this SDK as a dependency to your project.

1. Create a directory where you want to create your Telesign integration. Skip this step if you already have created a project. If you plan to create multiple Java projects that use Telesign, we recommend that you group them within a telesign_integrations directory.

   cd ~/code/local
   mkdir telesign_integrations
   cd telesign_integrations
   mkdir {your project directory name}
   cd {your project directory name}

2. Create a new Gradle project.

   gradle init

3. Select the following options at each of the prompts that appear at the command line.

• Select type of project to generate: 2: application
• Select implementation language: 3: Java
• Split functionality across multiple subprojects?: 1: no - only one application project
• Select build script DSL: 2: Kotlin
• Generate build using new APIs and behavior: yes
• Select test framework: {your preferred test framework}
• Project name (default: {default project name}): {your project name}
• Source package (default: {default source package name}): {your source package name}

You should then see a message that indicates the build was successful.

4. Add the following dependency to the dependencies block in the file "app/build.gradle.kts" in your project:

   implementation("com.telesign.enterprise:telesignenterprise:2.2.3")
   

This pulls in the Telesign Full-service Java SDK.

This will also install the Telesign Self-service Java SDK since it is a dependency for the Full-service SDK.

Authentication

If you use a Telesign SDK to make your request, authentication is handled behind-the-scenes for you. All you need to provide is your Customer ID and API Key. The SDKs apply Digest authentication whenever they make a request to a Telesign service where it is supported. When Digest authentication is not supported, the SDKs apply Basic authentication.

What's next

• Learn to send a request to Telesign with code with one of our tutorials.
• Browse our Developer Portal for tutorials, how-to guides, reference content, and more.
• Check out our sample code on GitHub.