Webhooks, SCIM og parring

v1.2.x · opdateret 2026-07-05

Denne side dækker de resterende protokolflader: enhedsparing, virksomhed autentificeringsføderation (SAML / SCIM / OAuth), tilvalg MCP-server og A2A endepunkter, medier overførsel, og Opret forbindelse til RPC tjenester. Flere af disse er som standard slået fra og skal aktiveres eksplicit.

Enhedsparring

Mobile- og desktopklienter tilslutter sig en instans gennem en kort parringsudveksling (iOS/macOS-appen bruger kun QR-parring).

Metode & sti	Formål
`POST /v1/pairing/redeem`	Indløs en parringskode og konfigurer enheden
`POST /v1/pairing/device/validate`	Bekræft en allerede parret enhed

curl https://your-aihummer.example/v1/pairing/redeem \
  -H "Content-Type: application/json" \
  -d '{ "code": "ABCD-EFGH" }'

Auth-føderation

AiHummer integreres med virksomhedens identitetsudbydere for både login og brugeradministration.

SAML

Metode & sti	Formål
`GET /saml/metadata`	Udbydermetadata for din IdP
`POST /saml/acs`	Assertion Consumer Service (SAML-svar)
`GET /saml/login`	Start SAML-login

SCIM-provisionering

System for Cross-domain Identity Management (SCIM 2.0) giver din IdP mulighed for automatisk at oprette og administrere brugere.

Metode & sti	Formål
`.../scim/v2/Users`	Liste / opret brugere
`.../scim/v2/Users/{id}`	Læs / opdater / slet en bruger

SCIM-endpunkterne autentificerer med en per-lejer SCIM-bærer-token, udstedt (og roteret/tilbagekaldt) ved POST /v1/admin/scim/token; IdP’en sender den i en Authorization: Bearer header. Tokenet vises én gang på udstedelsestidspunktet.

OAuth-token

Metode & sti	Formål
`POST /v1/oauth/token`	OAuth-token-endpoint

MCP-server (publicer udad)

AiHummer kan udgive sine egne værktøjer til MCP-klienter ved at fungere som en MCP-server. Dette er tilmelde sig og deaktiveret medmindre du indstiller AIHUMMER_MCP_PUBLISH=1.

Metode & sti	Formål
`POST /v1/mcp`	MCP-serverendepunkt (kræver `AIHUMMER_MCP_PUBLISH=1`)

[!WARNING] AIHUMMER_MCP_PUBLISH=1 alene er ikke nok. Den åbner adressen, men eksportlisten er tom: tools/list returnerer et tomt array, og ethvert kald afvises. Anfør de ønskede værktøjer med præcise navne, adskilt af komma, i AIHUMMER_MCP_EXPORT_TOOLS — mønstre og * understøttes ikke. Udad må kun læsende værktøjer offentliggøres: http_request, web_fetch, browser, code_exec og filesystem_read eksporteres aldrig, selv hvis du nævner dem.

Begge indstillinger sættes i Administration → Indstillinger eller med aihummer settings set, ikke i gateway.env — miljøet ignoreres for disse nøgler. AIHUMMER_MCP_PUBLISH accepterer præcis 1: true eller on lader adressen være lukket. Ændringer træder i kraft efter genstart af gatewayen.

Klienten skal sende en API-nøgle med omfanget mcp i headeren Authorization: Bearer …; uden den er svaret 401.

[!NOTE] At udgive værktøjer udadtil er forskelligt fra at forbruge en MCP-server som en nul-kode integration. Dette endpoint er til at lade andre MCP-klienter kalde ind i AiHummer.

A2A (Agent-til-Agent)

AiHummer kan eksponere en A2A-overflade, så andre agenter kan opdage og sende beskeder til den. Dette er også tilmelde sig via AIHUMMER_A2A_PUBLISH=1.

Metode & sti	Formål
`GET /.well-known/agent.json`	A2A-agentkort / opdagelsesdokument
`POST /a2a/message`	Modtag en A2A-besked (kræver `AIHUMMER_A2A_PUBLISH=1`)

Medier

Store medier (lyd, billeder, filer) uploades og hentes gennem dedikerede endpoints i stedet for at være indlejret i JSON-kroppe.

Metode & sti	Formål
`PUT /v1/media/{id}/content`	Upload byte for et medieobjekt
`GET /v1/files/{id}`	Download en gemt fil

[!TIP] Sæt AIHUMMER_BLOB_DIR for at aktivere medie-/fil tjenesten, og AIHUMMER_MEDIA_TOKEN_SECRET så signerede download-URL’er forbliver gyldige på tværs af genstarter.

Connect-RPC-tjenester

For typede, streaming-klienter eksponerer AiHummer også Opret forbindelse til RPC tjenester over HTTP (server-streaming understøttes):

Service	Område
`aihummer.health.v1`	Sundhedstjek
`aihummer.event.v1`	Begivenhedsstrøm
`aihummer.conversation.v1`	Samtaler
`aihummer.push.v1`	Push-levering
`aihummer.media.v1`	Medieoverførsel
`aihummer.turn.v1`	Udførelse af tur

Hvor til næste

Skub beskeder ind i AiHummer: Indgående & integrationsudløsere.
Skift disse overflader og mere: Miljøvariabler.
Betjen instansen: CLI-reference.