Skip to content

common_auth.contracts.identity

Stable authentication identities shared by configs and runtime components.

Identifiers preserve their supplied text. Construction validates without I/O; issuer-specific syntax and trust requirements belong to the consuming protocol. These references carry no credentials and do not establish authentication.

Classes

ConnectionRef

Bases: BaseModel

A configured connection identified within an explicit namespace.

Namespace and name together define identity and remain stable through credential rotation. The caller chooses its namespace; none is assumed. Dictionary and JSON loading use the same validation as direct construction.

Fields and properties declared here; inherited members belong to the bases above.

key

Read-only property.

key: tuple[str, str]

The separate key components, suitable for a composite lookup.

name

name: _IdentityText

namespace

namespace: _IdentityText

PrincipalRef

Bases: BaseModel

An authority-qualified subject reference, independent of verification.

The issuer and subject retain exact spelling. Neither a URL normalizer nor a provider-name mapping may silently change which principal this names.

Fields and properties declared here; inherited members belong to the bases above.

issuer

issuer: IssuerId

key

Read-only property.

key: tuple[str, str]

The issuing authority and its subject identifier.

subject

subject: _IdentityText