Skip to content

Configuration & authentication

Related guidance: getting-started/configuration, getting-started/authentication, security/credentials.

Runnable examples: preflight.py.

SymbolSummary
ECNConfigConfigure one immutable SDK MQTT v5 connection.
ReconnectPolicyConfigure one bounded exponential reconnect policy with mandatory full jitter.
ReviewedContainerNetworkRecord an operator attestation the SDK cannot prove; the SDK enforces that every resolved address is private and revalidated on connect and reconnect.
load_configLoad a named non-secret profile with environment overrides.
AuthConfigAuthentication configuration discriminated by the literal kind field.
BearerTokenAuthConfigure MQTT CONNECT authentication with a current bearer token.
MTLSAuthConfigure MQTT authentication with a client certificate and private key.
NoAuthConfigure no-auth, which is not a standalone unauthenticated mode and is accepted only with an explicit reviewed-container-network attestation and explicit TLS disablement.
CertificateMaterialProvide a certificate from a filesystem path or secret PEM text.
PrivateKeyMaterialProvide a private key from a filesystem path or secret PEM text.
TLSConfigConfigure TLS transport and optional custom certificate authority material.
TokenProviderA cooperative asynchronous callable that supplies the current bearer token.
CredentialsProviderA cooperative asynchronous callable supplying one username-token pair.
WireFormatSelect the entity and location payload encoding.

Version 0.2.0 · branch main