Skip to content

Go: SDK overview

Generated from the Go source by scripts/gen-docs.sh — do not edit; run it to regenerate. Canonical deep reference: pkg.go.dev/github.com/dnsid-ai/dnsid-go. Guides and account setup: https://docs.dnsid.ai.

The Go SDK is the module github.com/dnsid-ai/dnsid-go, plus the separately tagged key/aws submodule. Install it with:

Terminal window
go get github.com/dnsid-ai/dnsid-go

Start with the root package: IdentityManager is the facade for verifying domains, creating and publishing identity records, and loading the agent identity your application acts as. The root package is documented across the dnsid pages below; the other packages are application profiles and infrastructure you pull in as needed.

PageWhat it covers
Core: IdentityManagerIdentityManager, domain verification, configuration, transport, and caching for the DNSid Go SDK.
ConfigurationLoad DNSid SDK configuration from DNSID_* environment variables and DNSid CLI directories; loaders parse, constructors default.
Records & keysTXT identity records, JWKS and JWK types, policy flags, and record parsing helpers.
Profile: JOSEDNSid JOSE profile: create and verify DNSid JWTs and compact JWS.
Profile: HTTP signaturesRFC 9421 HTTP Message Signatures for DNSid agents.
Profile: Web Bot AuthWeb Bot Auth profile: RFC 9421-signed HTTP requests identifying a DNSid agent.
Profile: OIDCMint and verify DNSid OIDC tokens.
Key providersKeyProvider implementations, key metadata, and log-event signing.
Key providers: AWS KMSAWS KMS-backed key provider for DNSid.
RegistryHTTPRegistryClient, publication workflows, and registry request/response types.
Lifecycle logAgent lifecycle log abstractions for DNSid.
Transparency logC2SP transparency-log (tlog) client support for DNSid lifecycle logs.
Errors & enumsTyped errors and verification codes returned across the SDK.

For a guided first verification see the Quickstart; for multi-language walkthroughs of verification, OIDC tokens, and freshness see the Libraries overview.