Qintorava DocsProduct documentation
Integration profile

Discovery provider · Generic REST API

Discover CIs from a governed REST API with explicit authentication, paging, and mapping.

Demo baseline · November 13, 2026
Download PDF

Prerequisites

  • API documentation and stable resource endpoint
  • Read-only API identity
  • Sample response for mapping and pagination tests

Configuration steps

  1. Configure URL and authentication
  2. Define resource path, paging, and rate limit
  3. Map response properties to CMDB fields
  4. Test a preview before scheduling

Provider fields

FieldTypeRequirement and options
Base URL
baseUrl		urlRequired
Authentication scheme
authScheme		selectRequired
oauth2_client_credentials, bearer_token, api_key, basic, mtls, none
OAuth token URL
tokenUrl		urlOptional
OAuth client ID
clientId		textOptional
Credential secret alias
credentialSecretAlias		textOptional
Resource path
resourcePath		textRequired
Pagination strategy
pagination		selectRequired
none, page_number, offset_limit, cursor, link_header
Header secret alias
requestHeadersSecretAlias		textOptional
Request template
requestTemplate		textareaOptional
Response-to-CMDB mapping
responseMapping		textareaRequired
Rate limit / minute
rateLimitPerMinute		numberOptional
Collector / MID server
collector		textOptional

Verify and troubleshoot

Test with the narrowest supported non-production scope. Confirm that the connection test reaches the expected provider and that the preview or receipt matches the intended scope. Check identity, credential references, network access and provider permissions before retrying. Record the failure stage and redact sensitive payloads when escalating.