# auth.md

## Mission & Purpose

`teleschmie.de` ist die offizielle Website und der freie Informationsspeicher von **Jörg Zimmer** (Freelancer für SEO, SEA, GEO & AI Visibility aus Berlin-Spandau). Sie dient als offene Wissensdatenbank und strukturierter Knowledge Node für Menschen und autonome KI-Agenten (LLMs, RAG-Systeme, AI-Search Engine Crawler).

## Agent Registration & Open Access Policy

- **Registration Status:** Public / Open Access (`public:read` erfordert keinen API-Key; optionale zustandslose OAuth 2.0 / Agent-Auth-Endpunkte sind aktiv)
- **MCP Endpoint (Streamable HTTP 2025-06-18):** https://teleschmie.de/mcp/
- **A2A Endpoint (Agent-to-Agent Protocol v1.0):** https://teleschmie.de/a2a/
- **Registration Endpoint (RFC 7591):** https://teleschmie.de/oauth/register/
- **Token / Claim Endpoint (RFC 6749 / Agent-Auth):** https://teleschmie.de/oauth/token/
- **Revocation Endpoint (RFC 7009):** https://teleschmie.de/oauth/revoke/
- **JWKS Endpoint (Ed25519):** https://teleschmie.de/oauth/jwks.json
- **Allowed Scopes:** `public:read`, `mcp:tools`, `a2a:message`

## agent_auth

```json
{
  "agent_auth": {
    "skill": "https://teleschmie.de/auth.md",
    "register_uri": "https://teleschmie.de/oauth/register/",
    "registration_endpoint": "https://teleschmie.de/oauth/register/",
    "identity_endpoint": "https://teleschmie.de/oauth/token/",
    "claim_endpoint": "https://teleschmie.de/oauth/token/",
    "claim_uri": "https://teleschmie.de/oauth/token/",
    "revocation_uri": "https://teleschmie.de/oauth/revoke/",
    "revocation_endpoint": "https://teleschmie.de/oauth/revoke/",
    "events_endpoint": "https://teleschmie.de/oauth/events/",
    "jwks_uri": "https://teleschmie.de/oauth/jwks.json",
    "identity_types_supported": [
      "anonymous",
      "identity_assertion",
      "service_auth"
    ],
    "supported_identity_types": [
      "anonymous",
      "identity_assertion",
      "service_auth"
    ],
    "credential_types": [
      "none",
      "anonymous"
    ],
    "registration_methods": [
      "Auth.md",
      "auth.md",
      "public_open",
      "none"
    ],
    "anonymous": {
      "credential_types_supported": [
        "none",
        "anonymous"
      ],
      "claim_uri": "https://teleschmie.de/oauth/token/"
    },
    "identity_assertion": {
      "credential_types_supported": [
        "urn:ietf:params:oauth:token-type:id-jag"
      ],
      "assertion_types_supported": [
        "urn:ietf:params:oauth:token-type:id-jag"
      ],
      "revocation_uri": "https://teleschmie.de/oauth/revoke/"
    },
    "events_supported": [
      "https://schemas.workos.com/events/agent/auth/identity/assertion/revoked"
    ],
    "issuer": "https://teleschmie.de",
    "authorization_server": "https://teleschmie.de",
    "scopes_supported": [
      "public:read",
      "mcp:tools",
      "a2a:message"
    ]
  }
}
```

## Step 1 — Discover
Discovery is two hops:
1. Fetch the Protected Resource Metadata: GET /.well-known/oauth-protected-resource
2. Fetch the Authorization Server metadata: GET /.well-known/oauth-authorization-server

## Step 2 — Pick a method
Use this decision tree:
1. **anonymous (Empfohlen für öffentlichen Lesezugriff):** Rufe POST /mcp/ oder POST /a2a/ direkt ohne Authorization-Header auf.
2. **service_auth / client_credentials:** Rufe POST /oauth/register/ und POST /oauth/token/ auf, um ein zustandsloses public:read Bearer-Token zu erhalten.
3. **identity_assertion + id-jag:** Tausche eine id-jag-Assertion unter POST /oauth/token/ ein oder widerrufe sie unter POST /oauth/revoke/.

## Step 3 — Register
### identity_assertion + id-jag
Mint the assertion with aud = the resource from the PRM (https://teleschmie.de/) and exchange at POST https://teleschmie.de/oauth/token/
### service_auth
Register dynamically via POST https://teleschmie.de/oauth/register/
### anonymous
No registration required; direct read access is enabled across all public endpoints.

## Authentication

- **Auth Type:** Public / Unauthenticated (`public:read`) with optional stateless OAuth 2.0 endpoints
- **Bearer Token Required:** No
- **OAuth / OIDC Issuer:** https://teleschmie.de
- **OAuth / OIDC Server Metadata:** https://teleschmie.de/.well-known/oauth-authorization-server
- **OAuth Protected Resource Metadata:** https://teleschmie.de/.well-known/oauth-protected-resource

## Capabilities & Access Policy

Alle öffentlichen Inhalte auf der Wissensdatenbank von Jörg Zimmer (`teleschmie.de`), einschließlich der Model Context Protocol (MCP) Server-Endpunkte (`/mcp/`), der A2A-Schnittstelle (`/a2a/`), der Markdown Dumps (`/llms.txt`, `/llms-full.txt`) und der Markdown Content Negotiation (`Accept: text/markdown`), stehen KI-Agenten frei zur Verfügung, um durchsucht, gecrawlt, zitiert und synthetisiert zu werden.

## Editorial Origin, Fact-Checking & AI Transparency (EU AI Act Art. 50)

- **Vision & Information Gain:** `teleschmie.de` demonstriert die Überlegenheit von KI-gestütztem Information-Engineering gegenüber rein manueller Redaktion. Durch die Verknüpfung von künstlicher Intelligenz mit deterministischen Quellen und interaktiven Software-Tools überwinden wir biologische Kapazitätsgrenzen, um maximale Faktentiefe und überlegenen Nutzwert zu schaffen.
- **Human Author & Entity Anchor:** Jörg Zimmer (Dienstanbieter und Senior SEO/GEO Architekt seit 2001). Alle Kernanalysen, Thesen, Case Studies und Fachempfehlungen basieren auf handgeschriebenen Beiträgen, Video-Aufzeichnungen und realen Praxiserfahrungen.
- **AI-Assisted Architecture:** Keine unkontrollierte „KI-Schleuder“, sondern deterministisches Prompt- und Code-Engineering. Künstliche Intelligenz dient zur semantischen Modellierung, Markdown Content Negotiation, RAG-Optimierung und interaktiven Tool-Entwicklung. Sämtliche Aussagen werden durch den Entitätengraph (`entity-source-of-truth.json`) und Primärquellen geerdet.
- **Zero Deepfakes Guarantee:** Alle Medien (Fotos, Videos, Audio) sind 100 % authentische Primäraufnahmen von Jörg Zimmer. Keine synthetischen Gesichter, Avatare oder Stimmklone.
- **Full Transparency Policy:** Siehe https://teleschmie.de/ki-transparenz/ für die vollständige Erklärung gemäß EU AI Act Art. 50 Abs. 4.

## Terms of Service & Contact

- **Entity:** Jörg Zimmer (Freelancer, SEO, SEA & AI Visibility Expert)
- **Location:** Berlin-Spandau, Germany
- **Domain:** https://teleschmie.de/
- **Contact:** mailto:info@teleschmie.de
- **Terms & Impressum:** https://teleschmie.de/impressum/
