APINHI

Get an NHI source

Get a source by ID.

GET
/nhi/sources/{source_id}

Get a source by ID.

Authorization

ApiKeyAuth
headerAuthorizationBearer <token>

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

Required permission

view_nhi

Path Parameters

source_id*string
Formatuuid

Response Body

The request has succeeded.

application/json
  1. response

A connected directory. Credentials are never returned.

id*uuid
Formatuuid
provider*"microsoft_entra"

A directory that owns non-human identities.

Value in"microsoft_entra"
name*string
Length1 <= length <= 255
external_id*string

The provider's canonical ID for the directory. For Entra, the tenant ID.

status*NhiSourceStatus

Whether the stored credentials last authenticated successfully.

Value in"connected""error"
last_checked_at?string

When the credentials were last checked; absent until the first check.

Formatdate-time
config*

Provider-specific config, discriminated on provider.

created_at*string
Formatdate-time
updated_at*string
Formatdate-time
curl -X GET "https://example.com/nhi/sources/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "provider": "microsoft_entra",  "name": "string",  "external_id": "string",  "status": "connected",  "last_checked_at": "2019-08-24T14:15:22Z",  "config": {    "provider": "microsoft_entra",    "tenant_id": "string",    "client_id": "string",    "has_client_secret": true  },  "created_at": "2019-08-24T14:15:22Z",  "updated_at": "2019-08-24T14:15:22Z"}