APINHI

Test NHI credentials

Check credentials without storing anything, so a client can report a specific failure before creating the source.

POST
/nhi/providers/{provider}/test

Check credentials without storing anything, so a client can report a specific failure before creating the source.

Authorization

ApiKeyAuth
headerAuthorizationBearer <token>

Bearer token authentication. Send an API key (a saai_api_-prefixed token) as Authorization: Bearer <token>.

Required permission

manage_nhi

Path Parameters

provider*"microsoft_entra"

A directory that owns non-human identities.

Value in"microsoft_entra"

Request Body

application/json
  1. body

Request body for testing credentials without storing them. The config's provider must match the path.

config*

Provider-specific config, discriminated on provider.

Response Body

There is no content to send for this request, but the headers may be useful.

Example Request
curl -X POST 'https://your-org.aisecurity.services.us.connect.secureauth.com/api/v1/nhi/providers/microsoft_entra/test' \  -H 'Content-Type: application/json' \  -d '{  "config": {    "provider": "microsoft_entra",    "tenant_id": "string",    "client_id": "string",    "client_secret": "string"  }}'
Example Response
Empty