Class: Infrawrench::DnsNamespace

Inherits:
Object
  • Object
show all
Defined in:
lib/infrawrench/client.rb,
sig/infrawrench/sdk.rbs

Overview

client.dns

Instance Method Summary collapse

Constructor Details

#initialize(transport) ⇒ DnsNamespace

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Returns a new instance of DnsNamespace.

Parameters:



7335
7336
7337
 
# File 'lib/infrawrench/client.rb', line 7335

def initialize(transport)
  @transport = transport
end

Instance Method Details

#get(org_id: nil, request_options: nil) ⇒ Hash

List every DNS zone and record, with dangling targets flagged

One view over every zone and record across the connected DNS providers (Cloudflare, Route 53, Cloud DNS, DigitalOcean, Netlify, Azure DNS, Vercel), with each record target classified against the rest of the workspace. No provider API calls are made and no DNS is resolved — results reflect the last sync.

A dangling target is a subdomain-takeover candidate: the record points into a provider namespace this workspace manages and nothing synced claims it. The same records surface as dns-dangling-target findings on GET /posture and alert through the posture channel, so there is no separate DNS alert setting.

Requires permission: resources:read.

GET /api/org/orgId/dns

Parameters:

  • org_id (String, nil) (defaults to: nil) —

    Organization id. Defaults to the org_id the client was constructed with.

  • request_options (Hash, nil) (defaults to: nil) —

    Per-call :headers, :timeout and :open_timeout.

  • org_id: (String, nil) (defaults to: nil)
  • request_options: (Hash[Symbol, untyped], nil) (defaults to: nil)

Returns:

  • (Hash) —

    Parsed JSON, shaped as DnsInventoryResponse — see sig/infrawrench/sdk.rbs.

Raises:



7363
7364
7365
7366
7367
7368
7369
7370
 
# File 'lib/infrawrench/client.rb', line 7363

def get(org_id: nil, request_options: nil)
  @transport.request(
    http_method: "GET",
    path: "/api/org/{orgId}/dns",
    path_params: { "orgId" => org_id },
    request_options: request_options
  )
end