---
agent_auth:
  register_uri: https://mambamentality.com/auth.md
  supported_identity_types:
    - "did:web"
    - service-account
    - api-key
  credential_types:
    - client_secret
    - private_key_jwt
  claims_uri: https://mambamentality.com/oauth/claims
  revocation_uri: https://mambamentality.com/oauth/revoke
  authorization_server: https://mambamentality.com/.well-known/oauth-authorization-server
  protected_resource: https://mambamentality.com/.well-known/oauth-protected-resource
  oidc_discovery: https://mambamentality.com/.well-known/openid-configuration
  jwks_uri: https://mambamentality.com/.well-known/jwks.json
  scopes:
    - read
    - write
    - admin
---

# auth.md

## Overview
mambamentality.com supports AI agent authentication via OAuth 2.0 and OpenID Connect.

## Registration
Agents can register for API access at: https://mambamentality.com/oauth/register

## Supported Identity Types
- **did:web** — Decentralized identifiers using the web method (did:web:mambamentality.com)
- **service-account** — Service accounts for automated agents
- **api-key** — API keys for simple integrations

## Credential Types
- **client_secret** — Shared secret (client_secret_basic or client_secret_post)
- **private_key_jwt** — JWT signed with agent private key

## OAuth/OIDC Endpoints
- Authorization: https://mambamentality.com/oauth/authorize
- Token: https://mambamentality.com/oauth/token
- UserInfo: https://mambamentality.com/oauth/userinfo
- JWKS: https://mambamentality.com/.well-known/jwks.json
- Registration: https://mambamentality.com/oauth/register
- Claims: https://mambamentality.com/oauth/claims
- Revocation: https://mambamentality.com/oauth/revoke

## Scopes
- `read` — Read access to public API resources
- `write` — Write access to API resources
- `admin` — Administrative access

## Discovery
- OAuth Authorization Server Metadata: https://mambamentality.com/.well-known/oauth-authorization-server
- OAuth Protected Resource Metadata: https://mambamentality.com/.well-known/oauth-protected-resource
- OpenID Connect Discovery: https://mambamentality.com/.well-known/openid-configuration