Skip to main content

Overview

In this quickstart, you’ll add Fingerprint to a Java server using the Spring Boot framework to prevent fraudulent account creation. The example use case in this quickstart is stopping new account fraud, where attackers create multiple fake accounts to abuse promotions, exploit systems, or evade bans. However, the steps you’ll follow apply to most use cases. You can flag and block suspicious users by identifying the device behind each sign-up attempt, login, or transaction. In this quickstart, you’ll learn how to:
  • Set up a Spring Boot server with a Fingerprint integration
  • Retrieve visitor identification data using the Server API
  • Block bots and suspicious devices
  • Prevent multiple signups from the same device
This guide focuses on the backend integration and must be completed after identifying a visitor and generating an event ID. Before starting this quickstart, start with one of the frontend or mobile quickstarts to see how to identify a visitor in your frontend.
Estimated time: < 10 minutes

Prerequisites

Before you begin, make sure you have the following:
  • A completed frontend or mobile Fingerprint implementation (See the quickstarts)
  • Java (v11, v17, v21, or v25) installed
  • Your favorite code editor or IDE
  • Basic knowledge of Java and Spring Boot

1. Get your secret API key

Before starting this quickstart, you should already have a frontend Fingerprint implementation that sends the event_id to your server. If not, pause here and check out one of the frontend or mobile quickstarts first.
If you’re ready:
  1. Sign in and go to the API keys page in the Fingerprint dashboard.
  2. Create a new secret API key.
  3. Copy it somewhere safe so you can use it to retrieve full visitor identification data from the Server API.

2. Set up your project

To get started, you need a basic Spring Boot server. If you already have a project, skip to the next step.
  1. Go to start.spring.io
  2. Configure the project:
    • Project: Maven (or Gradle if you prefer)
    • Language: Java
    • Spring Boot: 4.x latest version
    • Dependencies:
      • Spring Web
      • Spring Data JPA
    • Everything else can remain as default
  3. Click Generate to download the starter project and unzip it.
  4. Open the project in your IDE and add these dependencies to your build file:
Maven (pom.xml):
pom.xml