Before you can create a new connection we need a few prerequisites: an API Key and an Organization.
For more information on these two items please review our quick start guide here .
The last step of the quick start describes how to create a new connection, the POST body consists of:
vendor
- The Enum of the vendor product you want to connect to.
credentials
- The specific credential body for the vendor you are connecting to, this is not required for Oauth based connections.
options
- (Optional) Any additional options you want to pass to the connection, each vendor has different options available.
Since creating a connection requires you to have the correct combination of vendor, credentials, and options in the correct combination we have provided examples of each below.
VMS Connections
{
"credentials" : {
"client_key" : "<string>" ,
"secret_key" : "<string>"
},
"vendor" : "TENABLE"
}
{
"credentials" : {
"username" : "test" ,
"password" : "pass" ,
},
"options" : { # Optional not required
"init_load_timestamp" : "2021-01-01T00:00:00+00:00" , # Timestamp to start the data pull from
},
"vendor" : "QUALYS"
}
{
"credentials" : {
"base_url" : "https://api.url.com" ,
"api_key" : "api_key"
},
"vendor" : "INSIGHTVM"
}
{
"vendor" : "MS_DEFENDER_VMS" ,
"options" : { # Optional not required
"oauth2_redirect_urls" : { # Overried the default redirect to Leen's splash page'
"success" : "https://myapp.com/success" ,
"error" : "https://myapp.com/error"
}
}
}
More info on our OAuth flow can be found here
{
"credentials" : {
"base_url" : "https://api.url.com" ,
"api_token" : "api_token"
},
"vendor" : "SENTINELONE_VMS"
}
{
"credentials" : {
"client_id" : "client_id" ,
"client_secret" : "client_secret"
},
"vendor" : "CROWDSTRIKE_SPOTLIGHT"
}
{
"credentials" : {
"aws" : {
"aws_access_key_id" : "access_key_id" ,
"aws_secret_access_key" : "secret_key" ,
"aws_region_name" : "us-east-1" ,
"type" : "direct_access"
}
},
"vendor" : "AWS_INSPECTOR2"
}
{
"credentials" : {
"aws" : {
"aws_role_arn" : "role_arn" ,
"external_id" : "external_id" ,
"aws_region_name" : "us-east-1" ,
"type" : "leen_role"
}
},
"vendor" : "AWS_INSPECTOR2"
}
{
"credentials" : {
"aws" : {
"aws_role_arn" : "role_arn" ,
"external_id" : "external_id" ,
"aws_region_name" : "us-east-1" ,
"type" : "role_chaining"
}
},
"vendor" : "AWS_INSPECTOR2"
}
{
"credentials" : {
"base_url" : "https://api.usxx.app.wiz.io" ,
"client_id" : "client_id" ,
"client_secret" : "client_secret"
},
"vendor" : "WIZ_VMS"
}
EDR Connections
{
"vendor" : "MS_DEFENDER_ENDPOINT" ,
"options" : { # Optional not required
"oauth2_redirect_urls" : { # Overried the default redirect to Leen's splash page'
"success" : "https://myapp.com/success" ,
"error" : "https://myapp.com/error"
}
}
}
More info on our OAuth flow can be found here
{
"credentials" : {
"base_url" : "https://api.url.com" ,
"api_token" : "api_token"
},
"vendor" : "SENTINELONE"
}
{
"credentials" : {
"client_id" : "client_id" ,
"client_secret" : "client_secret"
},
"vendor" : "CROWDSTRIKE"
}
AppSec Connections
{
"vendor" : "SNYK" ,
"options" : { # Optional not required
"oauth2_redirect_urls" : { # Overried the default redirect to Leen's splash page'
"success" : "https://myapp.com/success" ,
"error" : "https://myapp.com/error"
}
}
}
More info on our OAuth flow can be found here
{
"vendor" : "SEMGREP" ,
"credentials" : {
"web_api_token" : "web_api_token"
}
}
{
"vendor" : "AIKIDO" ,
"credentials" : {
"client_id" : "client_id" ,
"client_secret" : "client_secret" ,
}
}
{
"credentials" : {
"base_url" : "https://api.usxx.app.wiz.io" ,
"client_id" : "client_id" ,
"client_secret" : "client_secret"
},
"vendor" : "WIZ_CODE"
}
{
"credentials" : {
"base_url" : "https://us.ast.checkmarx.net" ,
"tenant_name" : "tenant-name" ,
"client_id" : "client_id" ,
"client_secret" : "client_secret"
},
"vendor" : "CHECKMARX"
}
{
"credentials" : {
"user_email" : "user-email" ,
"user_key" : "user-key" ,
"org_uuid" : "org-uuid" ,
"base_url" : "https://api-saas.mend.io"
}
"vendor" : "MEND"
},
IDP Connections
{
"vendor" : "OKTA" ,
"credentials" : {
"org_url" : "https://{your-tenant}.okta.com" ,
"api_token" : "api_token"
}
}
{
"vendor" : "MS_ENTRA" ,
"options" : { # Optional not required
"oauth2_redirect_urls" : { # Overried the default redirect to Leen's splash page'
"success" : "https://myapp.com/success" ,
"error" : "https://myapp.com/error"
}
}
}
More info on our OAuth flow can be found here
{
"vendor" : "MS_ENTRA" ,
"credentials" : {
"client_id" : "client_id" ,
"client_secret" : "client_secret" ,
"tenant_id" : "tenant_id"
}
}