SDK Guide · SecureNative Docs

Here you can find all the information that you need to get started using SecureNative SDK:

Installation

Node.js

Java

Python

Ruby

PHP

    npm install @securenative/sdk

// When using Maven, add the following dependency to your `pom.xml` file:

<dependency>
    <groupId>com.securenative.java</groupId>
    <artifactId>sdk-base</artifactId>
    <version>0.2.2</version>
</dependency>


// Gradle:

// compile group: 'com.securenative.java', name: 'sdk-base', version: 'LATEST'

pip install securenative

Install the `SecureNative.Sdk` nuget.
 
//Command line:
nuget install SecureNative.Sdk

//Packet Manager Console

 install-package SecureNative.Sdk

//Visual Studio

1. Go to Tools -> Package Manager -> Manage NuGet Packages for Solution...
2. Click the Browse tab and search for `SecureNative.Sdk`
3. Click the `SecureNative.Sdk` package in the search results, select version and what projects to apply it to on the right side, and click Install

# Add this line to your application's Gemfile:

gem 'securenative'

# And then execute:

$ bundle

# Or install it yourself as:

$ gem install securenative

$ composer require securenative/securenative-php

$ go get github.com/securenative/securenative-go

Initialize the SDK

Go to the settings page of your SecureNative account and find your API KEY

Initialize using API KEY

Node.js

Java

Python

Ruby

PHP

import { SecureNative, EventTypes } from "@securenative/sdk";
or;
const { SecureNative, EventTypes } = require("@securenative/sdk"); // if your using ES5

//Option 1: Initialize via Config file
SecureNative can automatically load your config from securenative.properties file or from the file that is specified in your SECURENATIVE_CONFIG_FILE env variable:

SecureNative secureNative =  SecureNative.init();
//Option 2: Initialize via API Key
SecureNative secureNative =  SecureNative.init("YOUR_API_KEY");

from securenative.securenative import SecureNative

# Option 1: Initialize via Config file
# SecureNative can automatically load your config from securenative.properties file or from the file that is specified in your SECURENATIVE_CONFIG_FILE env variable:
secureative =  SecureNative.init()

# Option 2: Initialize via API Key
securenative =  SecureNative.init("YOUR_API_KEY")

var apiKey = "API_KEY";
var sn = new SecureNative.SDK.SecureNative(apiKey, new SecureNative.SDK.Models.SecureNativeOptions());

require 'securenative'

# Option 1: Initialize via Config file
# SecureNative can automatically load your config from securenative.properties file or from the file that is specified in your SECURENATIVE_CONFIG_FILE env variable:
secureative =  SecureNative.init

# Option 2: Initialize via API Key
securenative =  SecureNative.init_with_api_key('YOUR_API_KEY')

require_once __DIR__ . '/vendor/autoload.php';

use SecureNative\sdk\SecureNative;
use SecureNative\sdk\SecureNativeOptions;
use SecureNative\sdk\EventTypes;

// Option 1: Initialize via Config file
// SecureNative can automatically load your config from securenative.yml file or from the file that is specified in your SECURENATIVE_CONFIG_FILE env variable:
package main

import (
    "github.com/securenative/securenative-go/sdk"
    "log"
)

func main() {
    sn, err :=  sdk.InitSDK("path/to/securenative.yml")
    if err != nil || sn == nil {
         log.Fatal("Do some error handling")
    }

    defer sn.Stop()
}

// Option 2: Initialize via API Key
package main

import (
    "github.com/securenative/securenative-go/sdk"
    "log"
)

func main() {
    sn, err :=  sdk.InitSDKWithApiKey("YOUR_API_KEY")
    if err != nil {
         log.Fatal("Do some error handling")
    }

    defer sn.Stop()
}

Configuration

You can pass empty SecureNativeOptions object or you can set the following:

Option	Type	Optional	Default Value	Description
apiKey	string	false	none	SecureNative api key
apiUrl	string	true	https://api.securenative.com/v1/collector	Default api base address
interval	number	true	1000	Default interval for SDK to try to persist events
maxEvents	number	true	1000	Max in-memory events queue
timeout	number	true	1500	API call timeout in ms
autoSend	Boolean	true	true	Should api auto send the events

Node.js

Java

Python

Ruby

PHP

 // will initialize singleton instance
 SecureNative.init({ apiKey: "Your API_KEY", maxEvents: 10, logLevel: "error" });
 // get singleton instance
 const secureNative = SecureNative.getInstance();

SecureNative secureNative = SecureNative.init(SecureNative.configBuilder()
                                        .withApiKey("API_KEY")
                                        .withMaxEvents(10)
                                        .withLogLevel("error")
                                        .build());

from securenative.securenative import SecureNative


securenative = SecureNative.init_with_options(SecureNative.config_builder()
                                        .with_api_key("API_KEY")
                                        .with_max_events(10)
                                        .with_log_level("ERROR")
                                        .build())

var apiKey = "API_KEY";
var sn = new SecureNative.SDK.SecureNative(apiKey, new SecureNative.SDK.Models.SecureNativeOptions(){
            ApiUrl = "https://other.domain.com",
           Interval = 1000,
           MaxEvents = 1000,
           Timeout = 1500,
           AutoSend = true
        });

require 'securenative'

securenative = SecureNative.init_with_options(SecureNative.config_builder(api_key = 'API_KEY', max_event = 10, log_level = 'ERROR'))

$options =  new SecureNativeOptions();

$options->setMaxEvents(10);
$options->setLogLevel("error");

SecureNative::init("YOUR_API_KEY", $options);

package main

import (
    "github.com/securenative/securenative-go/config"
    "github.com/securenative/securenative-go/sdk"
    "log"
)

func main() {
    configBuilder := config.NewConfigurationBuilder()
    sn, err := sdk.InitSDKWithOptions(configBuilder.WithApiKey("API_KEY").WithMaxEvents(10).WithLogLevel("ERROR").Build())
    if err != nil {
         log.Fatal("Do some error handling")
    }

    defer sn.Stop()
}

Tracking events

Once the SDK has been initialized, tracking requests are sent through the SDK instance. Make sure you build an event with the EventBuilder:

Building Event Entity

Node.js

Java

Python

Ruby

PHP

const event = {
  event: EventTypes.LOG_IN,
  userId: '1234',
  userTraits: {
    name: 'Your Name',
    email: 'name@gmail.com'
  },
  context: contextFromRequest(req)
};

SecureNative secureNative = SecureNative.getInstance();

SecureNativeContext context = SecureNative.contextBuilder()
       .withIp("127.0.0.1")
       .withClientToken("SECURED_CLIENT_TOKEN")
       .withHeaders(Maps.defaultBuilder()
                   .put("user-agent", "Mozilla/5.0 (iPad; U; CPU OS 3_2_1 like Mac OS X; en-us) AppleWebKit/531.21.10 (KHTML, like Gecko) Mobile/7B405")
                   .build())
       .build();

EventOptions eventOptions = EventOptionsBuilder.builder(EventTypes.LOG_IN)
       .userId("USER_ID")
       .userTraits("USER_NAME", "USER_EMAIL")
       .context(context)
       .properties(Maps.builder()
               .put("prop1", "CUSTOM_PARAM_VALUE")
               .put("prop2", true)
               .put("prop3", 3)
               .build())
       .timestamp(new Date())
       .build();

secureNative.track(eventOptions);

from securenative.securenative import SecureNative
from securenative.event_options_builder import EventOptionsBuilder
from securenative.enums.event_types import EventTypes
from securenative.models.user_traits import UserTraits


securenative = SecureNative.get_instance()

context = SecureNative.context_builder().\
        with_ip("127.0.0.1").\
        with_client_token("SECURED_CLIENT_TOKEN").\
        with_headers({"user-agent", "Mozilla/5.0 (iPad; U; CPU OS 3_2_1 like Mac OS X; en-us) AppleWebKit/531.21.10 (KHTML, like Gecko) Mobile/7B405"}).\
        build()

event_options = EventOptionsBuilder(EventTypes.LOG_IN).\
with_user_id("USER_ID").\
        with_user_traits(UserTraits("USER_NAME", "USER_EMAIL")).\
        with_context(context).\
        with_properties({"prop1": "CUSTOM_PARAM_VALUE", "prop2": True, "prop3": 3}).\
        build()

            var snEvent = new SecureNative.SDK.Models.EventOptions(EventTypes.LOG_IN)
             {
               IP = "162.247.74.201",
               RemoteIP = "10.99.98.97",
               UserAgent = "Mozilla/5.0 (Linux; U; Android 4.4.2; zh-cn; GT-I9500 Build/KOT49H) AppleWebKit/537.36 (KHTML,                      like Gecko)Version/4.0 MQQBrowser/5.0 QQ-URL-Manager Mobile Safari/537.36",
               User = new SecureNative.SDK.Models.User()
               {
                   Id = "csharp@securenative.com",
                   Email = "csharp@securenative.com",
                   Name = "CSharp"
               },
               Device = new Device("device"),
               FP = "fp",
               CID = "client_id_uuid",
               VID = "uuid",
           };

require 'securenative'
require 'securenative/enums/event_types'
require 'securenative/event_options_builder'
require 'securenative/models/user_traits'
require 'securenative/context/context_builder'


securenative = SecureNative.instance

context = securenative.context_builder(ip = '127.0.0.1', client_token = 'SECURED_CLIENT_TOKEN',
       headers = { 'user-agent' => 'Mozilla/5.0 (iPad; U; CPU OS 3_2_1 like Mac OS X; en-us) AppleWebKit/531.21.10 (KHTML, like Gecko) Mobile/7B405' })

event_options = EventOptionsBuilder(event_type = EventTypes::LOG_IN,
       user_id = 'USER_ID', user_traits = UserTraits('USER_NAME', 'USER_EMAIL'),
       context = context, properties = {prop1 => 'CUSTOM_PARAM_VALUE', prop2 => true, prop3 => 3}).build

$event = array(
    'event' => EventTypes::LOG_IN,
    'context' => SecureNative::contextFromContext(),
    'userId' => '1234',
    'userTraits' => (object)[
        'name' => 'Your Name',
        'email' => 'name@gmail.com'
    ]
)

package main

import (
    "github.com/securenative/securenative-go/enums"
    "github.com/securenative/securenative-go/events"
    "github.com/securenative/securenative-go/models"
    "log"
)

func main() {
    eventOptionsBuilder := events.NewEventOptionsBuilder(enums.EventTypes.LogIn)
    eventOptions, err := eventOptionsBuilder.WithUserId("1234").WithUserTraits(models.UserTraits{Name:"Your Name", Email:"name@gmail.com"}).WithContext(c).WithProperties(map[string]string{"prop1": "CUSTOM_PARAM_VALUE", "prop2": "true", "prop3": "3"}).Build()
    if err != nil {
        log.Fatal("Do some error handling")
    }
}

Tracking events

Node.js

Java

Python

PHP

REST API

secureNative.track({
  event: EventTypes.LOG_IN,
  userId: '1234',
  userTraits: {
    name: 'Your Name',
    email: 'name@gmail.com'
  },
  context: contextFromRequest(req)
});

SecureNative secureNative = SecureNative.getInstance();

SecureNativeContext context = SecureNative.contextBuilder()
       .withIp("127.0.0.1")
       .withClientToken("SECURED_CLIENT_TOKEN")
       .withHeaders(Maps.defaultBuilder()
                   .put("user-agent", "Mozilla/5.0 (iPad; U; CPU OS 3_2_1 like Mac OS X; en-us) AppleWebKit/531.21.10 (KHTML, like Gecko) Mobile/7B405")
                   .build())
       .build();

EventOptions eventOptions = EventOptionsBuilder.builder(EventTypes.LOG_IN)
       .userId("USER_ID")
       .userTraits("USER_NAME", "USER_EMAIL")
       .context(context)
       .properties(Maps.builder()
               .put("prop1", "CUSTOM_PARAM_VALUE")
               .put("prop2", true)
               .put("prop3", 3)
               .build())
       .timestamp(new Date())
       .build();

from securenative.securenative import SecureNative
from securenative.event_options_builder import EventOptionsBuilder
from securenative.enums.event_types import EventTypes
from securenative.models.user_traits import UserTraits


securenative = SecureNative.get_instance()

context = SecureNative.context_builder().\
        with_ip("127.0.0.1").\
        with_client_token("SECURED_CLIENT_TOKEN").\
        with_headers({"user-agent", "Mozilla/5.0 (iPad; U; CPU OS 3_2_1 like Mac OS X; en-us) AppleWebKit/531.21.10 (KHTML, like Gecko) Mobile/7B405"}).\
        build()

event_options = EventOptionsBuilder(EventTypes.LOG_IN).\
with_user_id("USER_ID").\
        with_user_traits(UserTraits("USER_NAME", "USER_EMAIL")).\
        with_context(context).\
        with_properties({"prop1": "CUSTOM_PARAM_VALUE", "prop2": True, "prop3": 3}).\
        build()

securenative.track(event_options)

var apiKey = "API_KEY";
var sn = new SecureNative.SDK.SecureNative(apiKey, new SecureNative.SDK.Models.SecureNativeOptions()
{
    ApiUrl = "https://api.securenative.com/collector/api/v1",
    Interval = 1000,
    MaxEvents = 1000,
    Timeout = 1500,
    AutoSend = true
});
sn.Track(new SecureNative.SDK.Models.EventOptions(EventTypes.LOG_IN)
{
    IP = "162.247.74.201",
    User = new SecureNative.SDK.Models.User()
    {
        Id = "1",
        Email = "1@example.com",
        Name = "example"
    }
});

SecureNative::track(array(
    'event' => EventTypes::LOG_IN,
    'context' => SecureNative::contextFromContext(),
    'userId' => '1234',
    'userTraits' => (object)[
        'name' => 'Your Name',
        'email' => 'name@gmail.com'
    ],
    // Custom properties
    'properties' => (object)[
        "prop1" => "CUSTOM_PARAM_VALUE",
        "prop2" => true,
        "prop3" => 3
    ]
));

package main

import (
    "github.com/securenative/securenative-go/context"
    "github.com/securenative/securenative-go/enums"
    "github.com/securenative/securenative-go/events"
    "github.com/securenative/securenative-go/models"
    "github.com/securenative/securenative-go/sdk"
    "log"
)

func main() {
    sn, err := sdk.GetInstance()
    if err != nil {
            log.Fatal("Do some error handling")
    }

    contextBuilder := context.NewSecureNativeContextBuilder()
    eventOptionsBuilder := events.NewEventOptionsBuilder(enums.EventTypes.LogIn)
    
    defer sn.Stop()
    
    c := contextBuilder.WithIp("127.0.0.1").WithClientToken("SECURED_CLIENT_TOKEN").WithHeaders(map[string][]string{"user-agent": {"Mozilla/5.0 (iPad; U; CPU OS 3_2_1 like Mac OS X; en-us) AppleWebKit/531.21.10 (KHTML, like Gecko) Mobile/7B405"}}).Build()
    eventOptions, err := eventOptionsBuilder.WithUserId("1234").WithUserTraits(models.UserTraits{Name:"Your Name", Email:"name@gmail.com"}).WithContext(c).WithProperties(map[string]string{"prop1": "CUSTOM_PARAM_VALUE", "prop2": "true", "prop3": "3"}).Build()
    if err != nil {
        log.Fatal("Do some error handling")
    }
    
    sn.Track(eventOptions)
}

curl -X POST \
  https://api.securenative.com/collector/api/v1/track \
  -H 'Authorization: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "eventType": "sn.user.login",
    "userId": "1234",
    "userTraits" : {
      "name" : "Your Name",
      "email" : "name@gmail.com"
    },
    "request": {
       "ip": "192.100.11.130",
       "clientToken": "cc103cc1c498f10ed6a3e7a0afb7fdf37b915cd5f8a56d2eee6177740b0c7a9edc833af05694b899ff739ac01b9656562e19655660651933ccf18fbaa305498a0e99a96b1e04b86525e0dfde5dccdb15c8fc49c3da3916ee461065c9a56a73bd0f41e12be152a0e4d6040a223c3775b8edec04ec1181f464e397c2bea361fbaccc013430b91ab0cb1265b4d4e385d507172af3a0d54b47d344a2b546974f049d0eafe01894f5529a51a42a47b75ad0f99c2fcc31394b331b50e1d2022f213382",
       "headers": {
            "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/81.0.4044.138 Safari/537.36",
            "Content-Type": "application/javascript",
            "Origin": "https://securenative.com/",
            "Referer": "https://securenative.com/login"
        }
    },
    "properties": {
       "prop1": "CUSTOM_PARAM_VALUE",
       "prop2": true,
       "prop3": 3
    },
    "timestamp": "2020-06-04T09:32:13.921Z"
}'

You can build an event from HttpServletRequest or from combination between event and HttpServletRequest, or HttpContext in C#:

Java

Ruby

@RequestMapping("/track")
public String track( HttpServletRequest request, HttpServletResponse response) {
    try {
        secureNative = new SecureNative(API_KEY,new SecureNativeOptions());
        Event e = new SnEvent.EventBuilder(EventTypes.LOG_IN.getType()).
                                                withUser(new User("","","your@domain.com")).
                                                build();
        Event event = secureNative.buildEventFromHttpServletRequest(request, e);
        secureNative.track(event);


    } catch (SecureNativeSDKException e) {
        e.printStackTrace();
        return "Api key is not valid";
    }
    return "tracked";
}


var apiKey = "API_KEY";
SecureNative.SDK.Models.EventOptions event1 = new SecureNative.SDK.Models.EventOptions(EventTypes.LOG_IN) {

           User = new SecureNative.SDK.Models.User()
           {
               Id = "user-id",
               Email = "user@domain.com"
           },
           IP="104.244.73.126"
       };



var ev = SecureNative.SDK.VerifyWebhook.BuildEventFromContxt(HttpContext.Current, event1,apiKey);
// you can either send null as ievent or half completed ievent object

require 'securenative'
require 'securenative/enums/event_types'
require 'securenative/event_options_builder'
require 'securenative/models/user_traits'
require 'securenative/context/context_builder'


securenative = SecureNative.instance

context = securenative.context_builder(ip = '127.0.0.1', client_token = 'SECURED_CLIENT_TOKEN',
       headers = { 'user-agent' => 'Mozilla/5.0 (iPad; U; CPU OS 3_2_1 like Mac OS X; en-us) AppleWebKit/531.21.10 (KHTML, like Gecko) Mobile/7B405' })

event_options = EventOptionsBuilder(event_type = EventTypes::LOG_IN,
       user_id = 'USER_ID', user_traits = UserTraits('USER_NAME', 'USER_EMAIL'),
       context = context, properties = {prop1 => 'CUSTOM_PARAM_VALUE', prop2 => true, prop3 => 3}).build

securenative.track(event_options)

package demo

import (
    "github.com/securenative/securenative-go/context"
    "github.com/securenative/securenative-go/enums"
    "github.com/securenative/securenative-go/events"
    "github.com/securenative/securenative-go/models"
    "github.com/securenative/securenative-go/sdk"
    "log"
    "net/http"
)

func Track(request *http.Request) {
    sn, err := sdk.GetInstance()
    if err != nil {
        log.Fatal("Do some error handling")
    }
    contextBuilder := context.NewSecureNativeContextBuilder()
    eventOptionsBuilder := events.NewEventOptionsBuilder(enums.EventTypes.LogIn) 
    c := contextBuilder.FromHttpRequest(request)

    defer sn.Stop()
    
    eventOptions, err := eventOptionsBuilder.WithUserId("1234").WithUserTraits(models.UserTraits{Name:"Your Name", Email:"name@gmail.com"}).WithContext(c).WithProperties(map[string]string{"prop1": "CUSTOM_PARAM_VALUE", "prop2": "true", "prop3": "3"}).Build()
    if err != nil {
        log.Fatal("Do some error handling")
    }
    
    sn.Track(eventOptions)
}

Verify endpoint

Node.js

Java

Python

Ruby

PHP

REST API

const verifyResult = await secureNative.verify({
  event: EventTypes.LOG_IN,
  userId: '1234',
  userTraits: {
    name: 'Your Name',
    email: 'name@gmail.com'
  },
  context: contextFromRequest(req)
})

console.log(res.riskLevel);
console.log(res.score);
console.log(res.triggers);

@RequestMapping("/track")
public void track(HttpServletRequest request, HttpServletResponse response) {
    SecureNativeContext context = SecureNative.contextBuilder()
                                              .fromHttpServletRequest(request)
                                              .build();

    EventOptions eventOptions = EventOptionsBuilder.builder(EventTypes.LOG_IN)
            .userId("USER_ID")
            .userTraits("USER_NAME", "USER_EMAIL")
            .context(context)
            .properties(Maps.builder()
                    .put("prop1", "CUSTOM_PARAM_VALUE")
                    .put("prop2", true)
                    .put("prop3", 3)
                    .build())
            .timestamp(new Date())
            .build();
    
    VerifyResult verifyResult = secureNative.verify(eventOptions);
    verifyResult.getRiskLevel() // Low, Medium, High
    verifyResult.score() // Risk score: 0 - 1 (0 - Very Low, 1 - Very High)
    verifyResult.getTriggers() // ["TOR", "New IP", "New City"]
}

from securenative.securenative import SecureNative
from securenative.event_options_builder import EventOptionsBuilder
from securenative.enums.event_types import EventTypes
from securenative.models.user_traits import UserTraits


def track(request):
    securenative = SecureNative.get_instance()
    context = SecureNative.context_builder().from_http_request(request).build()

    event_options = EventOptionsBuilder(EventTypes.LOG_IN).\
        with_user_id("USER_ID").\
        with_user_traits(UserTraits("USER_NAME", "USER_EMAIL")).\
        with_context(context).\
        with_properties({"prop1": "CUSTOM_PARAM_VALUE", "prop2": True, "prop3": 3}).\
        build()
    
    verify_result = securenative.verify(event_options)
    verify_result.risk_level  # Low, Medium, High
    verify_result.score  # Risk score: 0 - 1 (0 - Very Low, 1 - Very High)
    verify_result.triggers  # ["TOR", "New IP", "New City"]

var apiKey = "API_KEY";
var sn = new SecureNative.SDK.SecureNative(apiKey, new SecureNative.SDK.Models.SecureNativeOptions()
{
    ApiUrl = "https://api.securenative.com/collector/api/v1",
    Interval = 1000,
    MaxEvents = 1000,
    Timeout = 1500,
    AutoSend = true
});

var verified = sn.Verify(new SecureNative.SDK.Models.EventOptions(EventTypes.LOG_IN)
{
    IP = "162.247.74.201",
    User = new SecureNative.SDK.Models.User()
    {
        Id = "1",
        Email = "1@example.com",
        Name = "example"
    }
});

require 'securenative'
require 'securenative/enums/event_types'
require 'securenative/event_options_builder'
require 'securenative/models/user_traits'


def track(request)
    securenative = SecureNative.instance
    context = SecureNative.context_builder.from_http_request(request).build

    event_options = EventOptionsBuilder(event_type = EventTypes::LOG_IN,
        user_id = 'USER_ID', user_traits = UserTraits('USER_NAME', 'USER_EMAIL'),
        context = context, properties = {prop1 => 'CUSTOM_PARAM_VALUE', prop2 => true, prop3 => 3}).build
    
    verify_result = securenative.verify(event_options)
    verify_result.risk_level  # Low, Medium, High
    verify_result.score  # Risk score: 0 - 1 (0 - Very Low, 1 - Very High)
    verify_result.triggers  # ["TOR", "New IP", "New City"]
end

$ver = SecureNative::verify(array(
    'event' => EventTypes::VERIFY,
    'userId' => '1234',
    'context' => SecureNative::contextFromContext()
    'userTraits' => (object)[
        'name' => 'Your Name',
        'email' => 'name@gmail.com'
    ]
));

package main

import (
    "github.com/securenative/securenative-go/context"
    "github.com/securenative/securenative-go/enums"
    "github.com/securenative/securenative-go/events"
    "github.com/securenative/securenative-go/models"
    "github.com/securenative/securenative-go/sdk"
    "log"
)

func main() {
    sn, err := sdk.GetInstance()
    if err != nil {
        log.Fatal("Do some error handling")
    }

    contextBuilder := context.NewSecureNativeContextBuilder()
    eventOptionsBuilder := events.NewEventOptionsBuilder(enums.EventTypes.LogIn)
    
    defer sn.Stop()
    
    c := contextBuilder.WithIp("127.0.0.1").WithClientToken("SECURED_CLIENT_TOKEN").WithHeaders(map[string][]string{"user-agent": {"Mozilla/5.0 (iPad; U; CPU OS 3_2_1 like Mac OS X; en-us) AppleWebKit/531.21.10 (KHTML, like Gecko) Mobile/7B405"}}).Build()
    eventOptions, err := eventOptionsBuilder.WithUserId("1234").WithUserTraits(models.UserTraits{Name:"Your Name", Email:"name@gmail.com"}).WithContext(c).WithProperties(map[string]string{"prop1": "CUSTOM_PARAM_VALUE", "prop2": "true", "prop3": "3"}).Build()
    if err != nil {
        log.Fatal("Do some error handling")
    }
        
    verifyResult := sn.Verify(eventOptions)
    verifyResult.RiskLevel  // Low, Medium, High
    verifyResult.Score  // Risk score: 0 - 1 (0 - Very Low, 1 - Very High)
    verifyResult.Triggers  // ["TOR", "New IP", "New City"]

curl -X POST \
  https://api.securenative.com/collector/api/v1/verify \
  -H 'Authorization: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "eventType": "sn.verify",
    "userId": "1234",
    "request": {
       "ip": "192.100.11.130",
       "clientToken": "cc103cc1c498f10ed6a3e7a0afb7fdf37b915cd5f8a56d2eee6177740b0c7a9edc833af05694b899ff739ac01b9656562e19655660651933ccf18fbaa305498a0e99a96b1e04b86525e0dfde5dccdb15c8fc49c3da3916ee461065c9a56a73bd0f41e12be152a0e4d6040a223c3775b8edec04ec1181f464e397c2bea361fbaccc013430b91ab0cb1265b4d4e385d507172af3a0d54b47d344a2b546974f049d0eafe01894f5529a51a42a47b75ad0f99c2fcc31394b331b50e1d2022f213382",
       "headers": {
            "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/81.0.4044.138 Safari/537.36"
        }
    },
    "timestamp": "2020-06-04T09:32:13.921Z"
}'

Example Response:
{
 "riskLevel" : "low",
 "score" : "0.2",
 "triggers" : ["NewDevice"]
}

Webhooks

Use verify Webhook middleware to ensure that webhook is coming from SecureNative

Node.js

Java

Python

Ruby

PHP

const secureNative = SecureNative.getInstance();
app.post("/securewebhook", secureNative.middleware.verifyWebhook, (req, res) => {
    const {riskLevel, riskScore, triggers } = req.body;
}

@RequestMapping("/webhook")
public void webhookEndpoint(HttpServletRequest request, HttpServletResponse response) {
    SecureNative secureNative = SecureNative.getInstance();
    
    // Checks if request is verified
    Boolean isVerified = secureNative.verifyRequestPayload(request);
}

from securenative.securenative import SecureNative


def webhook_endpoint(request):
    securenative = SecureNative.get_instance()
    
    # Checks if request is verified
    is_verified = securenative.verify_request_payload(request)


var apiKey = "1234";
var sn = new SecureNative.SDK.SecureNative(apiKey, new SecureNative.SDK.Models.SecureNativeOptions());
bool isOk = SecureNative.SDK.VerifyWebhook.IsRequestFromSecureNative(HttpContext.Current, apiKey);
//if isOK is true, continue. Otherwise, consider ruturning http code 401.

require 'securenative'


def webhook_endpoint(request)
    securenative = SecureNative.instance
    
    # Checks if request is verified
    is_verified = securenative.verify_request_payload(request)
end

$verified = SecureNative::getMiddleware()->verifySignature();

if ($verified) {
    // Request is trusted (coming from SecureNative) 
}

package demo

import (
    "github.com/securenative/securenative-go/sdk"
    "log"
    "net/http"
)

func VerifyWebHook(request *http.Request) bool {
    sn, err := sdk.GetInstance()
    if err != nil {
        log.Fatal("Do some error handling")
    }
    defer sn.Stop()
    
    return sn.VerifyRequestPayload(request)
}