Event Object
An Event Object describes an Authentication Event, and serves as a "proof" that the user has successfully authenticated. The field approved tells you whether this event is approved, and the signature can be validated to make sure that this "proof" is generated by Cotter.
1
{
2
"ID": 610152,
3
"user_id": "61e51b1b-55cd-4b00-9cc0-4b71fa0eb00f",
4
"client_user_id": "",
5
"issuer": "abababab-abab-abab-abab-ababab",
6
"event": "LOGIN_WITH_DEVICE",
7
"ip": "73.15.208.6",
8
"location": "Orinda",
9
"timestamp": "1591935918",
10
"method": "TRUSTED_DEVICE",
11
"new": false,
12
"approved": true,
13
"signature": "BqBQphW2G1QLn5/ZcrcRVJ/S..."
14
}
Copied!
Field
Description
ID
The event ID
user_id
Cotter's User ID of the user that requested this authentication event
client_user_id
[DEPRECATED] Your User ID for the user in your server
issuer
Your API_KEY_ID
event
A tag that describes the authentication event.
ip
The user's IP address when requesting authentication
location
The user's location when requesting authentication
timestamp
The UNIX timestamp when the user requested for authentication
method
The authentication method that was used: TRUSTED_DEVICE , PIN , or BIOMETRIC
new
Whether or not this is a new request. This is used for pending requests where the user need to tap on their device to approve the login request.
approved
Whether or not this authentication request was approved
signature
A signature from Cotter that prove that this Event Object is generated by Cotter.
To use this Event Object, you should validate it's authenticity following this guide:
​
Last modified 1yr ago
Copy link