CredentialRefreshFallbackWarning
Emitted when the SDK falls back to the developer-provided
CredentialProvider.refresh
because the Client Bound SAT path could not take over.
Common causes:
- The minted SAT lacks
sat:refreshscope (reason: 'no-scope'). - The
/devices/tokenexchange failed transiently (reason: 'endpoint-failed'; seeDeviceTokenError).
Subscribe via client.warnings$ to detect:
- SDKs running with plain SATs that rely on developer-managed refresh
- Deployments expected to use bound tokens that silently downgraded to bearer (a security-relevant signal for fleet observability)
Properties
code
Discriminant identifying this warning.
source
The SDK subsystem that emitted the warning.
reason
Why the fallback occurred. See CredentialRefreshFallbackReason.
message
Human-readable description of the fallback.