Populating SignalPrint

To detect account fraud, collect logs first and submit them to Verosint either using the command-line interface or directly using the API. The more complete picture you have about recent user activity, the more accurate analysis Verosint can surface in the SignalPrint Explorer.

Supported Identifier Fields

The following table summarizes the list of fields that you can submit to Verosint:

Identifier NameDescriptionExample
timestampRFC3339 formatted timestamp (defaults to the time of submission when omitted)2023-03-25T16:04:43.865-05:00
accountIDthe unique user identifier (may be the same as email)babsjensen
emailthe email address of the user[email protected]
userAgentthe full user agent string associated with the eventMozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/111.0.0.0 Safari/537.36
ipthe origin IPv4 or IPv6 address97.105.216.107
phonethe phone number of the user in the international phone number format+15123944240

📘

Required Identifiers

IP address, and user agent are required for an initial post.

Note that each event may have at most one identifier for each type. For example, each event can only have a single IP address.

Submitting Events

Before you can submit events to Verosint, copy the API key available to the clipboard. The key is available under the Account page in the top-right corner.

API Keys in the Account Menu

API Keys in the Account Menu

Upload a CSV File or Integrate with a Partner

As a new user, you can add a file in the UI to get a sample view of your users and potential fraud in your environment or integrate with one of Verosint's partners.

New User Page

New User Page

Using the Command-Line

The CLI is the easiest way to upload events to Verosint. After installing the tool, the verosint signalprint send-events command can submit events from a comma-separated value (CSV) or an LDAP Interchange Format (LDIF) file.

Developer Playground Workspace in Postman

Visit Verosint's Developer Playground workspace in Postman.

Posting User Data to the SignalPrint API

With an API key from Verosint, you can post a collection of user data in CVS or JSON format to the SignalPrint API.

Verosint API Reference

The file data looks like this:

[
    {
        "timestamp": "2022-11-28T05:11:17.633Z",
        "email": "[email protected]",
        "ip": "172.66.40.217",
        "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/107.0.0.0 Safari/537.36"
    },
    {
        "timestamp": "2022-11-28T05:21:18.633Z",
        "email": "[email protected]",
        "phone": "18887183564",
        "ip": "172.66.40.217",
        "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/107.0.0.0 Safari/537.36"
    }
]