Highlights
- Go 1.25+ - the core module has no dependencies at all; the AWS SDK is needed only to sign an STS request for the
aws_iamprovider, so that provider ships as its own module - Thread-safe TTL cache with atomic snapshot replacement and ETag/304 support
- Background refresh - caller goroutines are never blocked on cache expiry
- SSE live updates - started automatically by
NewClient; propagates remote changes within milliseconds; after 3 consecutive transport errors waits out a reconnect schedule and reconnects on its own - Public-key vs secret-key access control - public-key clients get
ErrPublicKeyRestrictedfromGetSecret - Sentinel errors -
errors.Is(err, nexus.ErrUnauthorized)style, idiomatic Go - Workload Identity Federation - Kubernetes / AWS IRSA / GCP / Azure auto-detected; bearer-JWT auth with automatic refresh; AWS IAM (
aws_iam) for ECS/Fargate/Lambda/plain-EC2; adevelopercredential so a laptop authenticates the same way - Stream observer hooks - opt-in structured callbacks for ops dashboards and load-test tooling
- Service kind awareness -
GetSecretblocked withErrServiceKindMismatchonkind=frontend - 402 Payment Required handling -
ErrBillingreturned, background refresh throttled to one attempt every five minutes, cache served - AB Testing batch evaluation -
EvaluateAB(ctx, keys, userID, attributes)for the AB Testing add-on;ErrABAddonNotAvailableon 403 - File-type secrets -
SecretTypeFilematerialised as0600files inside a0700directory private to the client (nexus-secrets-*under the system temp directory), with SHA-256-derived names so neither the key name nor the value appears in the path;GetSecretFilePath(key)exposes the path;Close()removes the directory
Module
The module is served directly viaproxy.golang.org - there is no separate package registry.
