Azure Active Directory API

Use these operations to interact with the Azure Active Directory integration in Cortex.

Operations

Retrieve a configuration

get

Authorizations

Responses

get

HTTPcURLJavaScriptPython

GET /api/v1/active-directory/default-configuration HTTP/1.1
Host: api.getcortexapp.com
Authorization: Bearer JWT
Accept: */*

{
  "clientId": "text",
  "clientSecretLastFour": "text",
  "groupsFilter": "text",
  "tenantId": "text"
}

Add a configuration

post

Authorizations

Body

clientIdstringRequired

clientSecretstringRequired

groupsFilterstringOptional

tenantIdstringRequired

Responses

post

HTTPcURLJavaScriptPython

POST /api/v1/active-directory/configuration HTTP/1.1
Host: api.getcortexapp.com
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 81

{
  "clientId": "text",
  "clientSecret": "text",
  "groupsFilter": "text",
  "tenantId": "text"
}

{
  "configurations": [
    {
      "clientId": "text",
      "clientSecretLastFour": "text",
      "groupsFilter": "text",
      "tenantId": "text"
    }
  ]
}

Replace the existing configuration

put

Authorizations

Body

clientIdstringRequired

clientSecretstringRequired

groupsFilterstringOptional

tenantIdstringRequired

Responses

put

HTTPcURLJavaScriptPython

PUT /api/v1/active-directory/configuration HTTP/1.1
Host: api.getcortexapp.com
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 81

{
  "clientId": "text",
  "clientSecret": "text",
  "groupsFilter": "text",
  "tenantId": "text"
}

{
  "configurations": [
    {
      "clientId": "text",
      "clientSecretLastFour": "text",
      "groupsFilter": "text",
      "tenantId": "text"
    }
  ]
}

Validate a configuration

post

Authorizations

Responses

post

HTTPcURLJavaScriptPython

POST /api/v1/active-directory/configuration/validate HTTP/1.1
Host: api.getcortexapp.com
Authorization: Bearer JWT
Accept: */*

{
  "configurations": [
    {
      "alias": "text",
      "isValid": true,
      "message": "text"
    }
  ]
}

Delete a configuration

delete

Authorizations

Responses

delete

HTTPcURLJavaScriptPython

DELETE /api/v1/active-directory/configurations HTTP/1.1
Host: api.getcortexapp.com
Authorization: Bearer JWT
Accept: */*

{
  "configurations": [
    {
      "clientId": "text",
      "clientSecretLastFour": "text",
      "groupsFilter": "text",
      "tenantId": "text"
    }
  ]
}