Skip to content

README.md

Latest commit

 

History

History
122 lines (89 loc) · 3.27 KB

README.md

File metadata and controls

122 lines (89 loc) · 3.27 KB
Raw

Operator identity

Optional verified operator trailer for enterprise session receipts (#55).

Default (unchanged)

No identity adapter → lite agent_ref + aura_id only. No login, no extra fields.

Enable mock (CI / local)

export AURA_MOCK_OPERATOR_SUBJECT=ci-operator@corp.com
# ~/.aura/config.yaml or aura.project.yaml
identity:
  adapter: mock
  subject: ci-operator@corp.com
identity_export_pii: false

OIDC / Auth0

identity:
  adapter: auth0
  domain: your-tenant.auth0.com
  audience: your-api-audience
export AURA_AUTH0_TOKEN="<access_token>"
# or AURA_OIDC_TOKEN
pip install "aura-harness[identity]"

Signature verification uses JWKS (pyjwt + cryptography). Do not use verify_signature: false in production — that mode is for local tests only.

SDK

from aura import agent, configure
from aura.identity.adapters.mock import MockIdentityAdapter

configure()
ag = agent("bot")
adapter = MockIdentityAdapter(subject="ops@corp.com")
with ag.session(identity_adapter=adapter) as run:
    run.emit("turn.start", {})
print(run.summary["identity"])

Manual (unverified) operator on profile:

ids:
  operator:
    subject: ops@corp.com
    verified: false
    method: manual

Bring your own adapter

Implement the protocol and pass it to session() — no central AURA identity service required:

from aura.identity.models import OperatorIdentity
from aura.identity.protocol import IdentityContext


class CorpSsoAdapter:
    method = "corp_sso"

    def resolve(self, context: IdentityContext) -> OperatorIdentity | None:
        token = context.env.get("CORP_SSO_TOKEN")
        if not token:
            return None
        # validate with your IdP here
        return OperatorIdentity(
            verified=True,
            method=self.method,
            subject="user-123",
            session_ref=context.session_id,
        )


with ag.session(identity_adapter=CorpSsoAdapter()) as run:
    run.emit("turn.start", {})

For opaque third-party ids without verification, nest under ids.external on the agent profile — no adapter needed.

Profile types entry (built-in adapter names):

types:
  - role: identity
    type_id: arpa.identity.oidc
    config:
      adapter: oidc
      issuer: https://login.example.com/
      audience: aura-api

Spine and export

Successful bind emits identity.bound. Operator appears under agent_ids.ids.operator on every event for SIEM parity.

By default, email / name / phone are stripped from summary and OTel export (JSONL spine keeps full fields for forensic review):

identity_export_pii: true   # opt in to include PII on export surfaces
identity_required: true     # global: fail session open when no verified operator resolves

Spectrum profiles can also set spectrum.identity_required (wins over global). high and full default to required when a profile has a spectrum block — set identity_required: false to opt out. Session override: aura run --require-identity or session(identity={"require_verified": True}).

CLI: aura identity show

→ trust-paths.md · examples/13-operator-identity