# auth.md — Agent Authentication & Registration Discovery (razvanmares.ro)

## Audience
Autonomous AI agents, MCP clients, and A2A orchestrators interacting with **razvanmares.ro** (Răzvan Mareș — RazvanApps).

## 1. Anonymous Public Read Access & Agent Registration
All public web pages, Markdown content-negotiated representations (`Accept: text/markdown`), `/llms.txt`, `/llms-full.txt`, `/.well-known/*` discovery manifests, public blog/portfolio read endpoints, and read-only MCP (`/mcp`) / A2A (`/a2a`) tools work directly without credentials, or via anonymous/assertion-based agent token provisioning:

- **Registration Endpoint (`register_uri`)**: `POST https://razvanmares.ro/agent/auth`
- **Claim Endpoint (`claim_uri`)**: `POST https://razvanmares.ro/agent/auth/claim`
- **Revocation Endpoint (`revocation_uri`)**: `POST https://razvanmares.ro/agent/auth/revoke`
- **Supported Methods**:
  - `anonymous` — ephemeral `bearer` credential scoped to `read:public`, `mcp:tools`, `a2a:invoke`
  - `identity_assertion` — `urn:ietf:params:oauth:token-type:id-jag` and `verified_email` assertions exchanging for `bearer` credentials
- **Credential Usage**: Pass `Authorization: Bearer <jwt>` in the HTTP request header over HTTPS (query-string tokens are rejected).
- **Content Signals Policy**: `search=yes, ai-input=yes, ai-train=yes`
- **Rate Limits**: Public endpoints enforce fair-use per-IP rate limiting; honor HTTP `429` and `Retry-After`.

## 2. OAuth 2.0 Discovery Metadata
- **OAuth 2.0 Protected Resource Metadata (RFC 9728)**: `https://razvanmares.ro/.well-known/oauth-protected-resource`
- **OAuth 2.0 Authorization Server Metadata (RFC 8414)**: `https://razvanmares.ro/.well-known/oauth-authorization-server`
- **Public JWKS Endpoint**: `https://razvanmares.ro/.well-known/jwks.json`
- **PKCE**: `S256` required; private operator endpoints (`/api/admin/*`) remain restricted to authorized operators.

## 3. Technical Contact
- **Owner**: Răzvan Mareș (RazvanApps)
- **Contact**: contact@razvanmares.ro | https://razvanmares.ro/contact
