Populating SignalPrint
Collect usage logs first and submit them to Verosint using the command-line interface or directly using the API. The more complete picture you have about recent user activity, the more accurate account fraud analysis Verosint can surface in the SignalPrint Explorer.
Supported Identifier Fields
The following table lists the fields that you can submit to Verosint:
| Identifier Name | Description | Example |
|---|---|---|
| timestamp | RFC3339 formatted timestamp (defaults to the time of submission when omitted) | 2023-03-25T16:04:43.865-05:00 |
| accountID | the unique user identifier (may be the same as email) | babsjensen |
| the email address of the user | [email protected] | |
| userAgent | the full user agent string associated with the event | Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/111.0.0.0 Safari/537.36 |
| ip | the origin IPv4 or IPv6 address | 97.105.216.107 |
| phone | the phone number of the user in the international phone number format | +15123944240 |
| type | the event type | LOGIN_SUCCESS |
Required Identifiers
Event type, IP address, and user agent are required.
Each event may have at most one identifier for each type. For example, each event can only have a single IP address.
Visit the API reference for a full list of supported event types.
Submitting Events
Before submitting events to Verosint, copy the API key available to the clipboard. The key is available from the Account Settings menu in the top-right corner of the interface.
API Keys in the Account Menu
Upload a CSV File or Integrate with a Partner
As a new user, you can upload a file to get a sample view of your users and potential fraud in your environment, or you can integrate with one of Verosint's partners.
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.
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",
"type": "SIGNUP_FAILED"
},
{
"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",
"type": "SIGNUP_SUCCESS"
}
]
Updated 4 months ago