# HAVEN Psicología — Agent Authentication & Registration (`auth.md`)

Este documento especifica el modelo de acceso, descubrimiento y registro para agentes autónomos de IA que interactúan con **HAVEN - Consulta de Psicología** (`https://havenpsicologia.es`), titularidad de **Aitor Patiño Martínez** (Psicólogo General Sanitario, Col. CV20898 COPCV).

---

## 1. Modelo de Acceso para Agentes

### Endpoints Públicos de Solo Lectura (Sin Autenticación)
Los recursos informativos de la clínica son públicos y accesibles directamente mediante `HTTPS GET` sin necesidad de token (`authentication: none`):

- **Información clínica, colegiación y tarifas vigentes:** [`https://havenpsicologia.es/api/info.json`](https://havenpsicologia.es/api/info.json)
- **Estado operativo del servicio:** [`https://havenpsicologia.es/api/status.json`](https://havenpsicologia.es/api/status.json)
- **Especificación OpenAPI 3.1.0:** [`https://havenpsicologia.es/openapi.json`](https://havenpsicologia.es/openapi.json)
- **Catálogo de APIs (RFC 9727):** [`https://havenpsicologia.es/.well-known/api-catalog`](https://havenpsicologia.es/.well-known/api-catalog)
- **Índice de Habilidades (Agent Skills v0.2.0):** [`https://havenpsicologia.es/.well-known/agent-skills/index.json`](https://havenpsicologia.es/.well-known/agent-skills/index.json)
- **MCP Server Card (SEP-1649):** [`https://havenpsicologia.es/.well-known/mcp/server-card.json`](https://havenpsicologia.es/.well-known/mcp/server-card.json)
- **ARD Capability Manifest:** [`https://havenpsicologia.es/.well-known/ai-catalog.json`](https://havenpsicologia.es/.well-known/ai-catalog.json)

---

## 2. Metadatos de Descubrimiento OAuth / OIDC y Registro de Agentes

Para compatibilidad con clientes estandarizados de descubrimiento (RFC 8414, RFC 9728, OIDC Discovery y `auth.md`):

- **Protected Resource Metadata (RFC 9728):** [`/.well-known/oauth-protected-resource`](https://havenpsicologia.es/.well-known/oauth-protected-resource)
- **OAuth 2.0 Authorization Server Metadata (RFC 8414):** [`/.well-known/oauth-authorization-server`](https://havenpsicologia.es/.well-known/oauth-authorization-server)
- **OpenID Connect Discovery Metadata:** [`/.well-known/openid-configuration`](https://havenpsicologia.es/.well-known/openid-configuration)
- **Public Key Set (JWKS):** [`/.well-known/jwks.json`](https://havenpsicologia.es/.well-known/jwks.json)
- **Web Bot Auth Directory (RFC 9421):** [`/.well-known/http-message-signatures-directory`](https://havenpsicologia.es/.well-known/http-message-signatures-directory)

### Identidades y Scopes Soportados
- **`identity_types_supported`:** `anonymous` (acceso directo a endpoints públicos), `jwk_thumbprint` (firmas HTTP RFC 9421).
- **`scopes_supported`:** `read:clinic_info`, `read:service_status`.

---

## 3. Reglas Sanitarias y Protección de Datos (RGPD / Ley 41/2002)

1. **Principio de Minimización de Datos (Art. 5.1.c RGPD):** Los agentes **nunca** deben transmitir diagnósticos médicos, historiales clínicos ni información sensible de salud a través de formularios o URLs públicas. Únicamente se requiere nombre, teléfono/WhatsApp, modalidad preferida y preferencia horaria para coordinar cita previa.
2. **Intervención Humana Obligatoria (Human-in-the-Loop):** La solicitud formal de cita asistencial requiere que la persona usuaria revise y acepte de forma expresa e informada la [Política de Privacidad](https://havenpsicologia.es/privacidad.html) y los [Términos y Condiciones](https://havenpsicologia.es/terminos.html) (incluyendo la política de cancelación con 24 horas de antelación).
3. **Contacto de Soporte Técnico y Sanitario:** `aitor.psychohaven@gmail.com` | Teléfono / WhatsApp: `+34 633 198 254`.