Scoria.Connectors.Auth (scoria v0.1.3)

Copy Markdown View Source

Scoria.Connectors.Auth coordinates host-owned connector authorization with Scoria's connector records, grants, approvals, and audit evidence.

Use this module when a remote connector needs an authorization start, callback completion, auth-failure evidence, or scope-escalation approval. The host app owns the authenticated subject, tenant membership, redirect route, OAuth app configuration, and business decision to grant scopes. Scoria records the connector grant and projects failures or escalations into reviewer trace evidence.

See guides/capabilities/connectors-and-mcp.md for connector/MCP setup and verification guidance.

Summary

Functions

complete_authorization(connector_id, params, auth_state, attrs \\ %{})

record_remote_auth_failure(connector, local_tool, context, reason_code, opts \\ [])

record_scope_escalation(connector, local_tool, context, missing_scopes, opts \\ [])

start_authorization(connector_id, attrs \\ %{})