REST API Overview

This document provides various examples of connecting to a SevOne REST API from edgeCore. It is written
against SevOne version 5.6. Please see the following link as needed for SevOne REST API
documentation and explorer: https://<SevOne Instance>/api/docs/index.html#/

REST API Authentication

Access to the SevOne REST API requires a token that is obtained via a request to: URL: https://<SevOne
Instance>/api/v1/authentication/signin name: <user name> password: <password> The authentication
token is returned as follows:

<authentication> <token>b1e9484f72406ecf724011e67240a7da7240d4ae5280ef5f</token> </authentication>

The following cURL reference illustrates the authentication token request:

curl -X POST --header "Content-Type: application/json" --header "Accept: application/json" -d "{ \"name\": \"<user name>\", \"password\": \"password\" }" "https://<SevOne Instance>/api/v1/authentication/signin"

The authentication token is then embedded in the header for subsequent requests by edgeCore. cURL
reference example below:

curl -X GET --header "Accept: application/json" --header "X-AUTH-TOKEN: b1e9484f72406ecf724011e67240a7da7240d4ae5280ef5f" "https://<SevOne Instance>/api/v1/alerts?size=20"

Configuring edgeCore SSO for SevOne Rest API

edgeCore SSO handles acquisition of the authentication token and uses it for subsequent requests to the SevOne REST
API. To enable the REST API SSO, copy the SevOneRESTSso.js file to the edgeCore
<Install_Home>/webrules/generic/sso/ directory. When creating a connection to SevOne, set the SSO
Handler to SevOneRESTSso.

<table"> Connection PropertyExampleConnection NameSevOne REST
APIDestinationhttps://<SevOneRestApiEndpoint>SSO HandlerSevOneRESTSsoSSO
CredentialsUsername: <sevone user> Password: <sevone password>