Webhooks, SCIM og paring

v1.1.x · oppdatert 2026-07-05

Denne siden dekker de gjenværende protokolloverflatene: enhetsparing, virksomhet autentiseringsføderasjon (SAML / SCIM / OAuth), valgfritt å delta MCP-server og A2A endepunkter, media overføre, og Koble-RPC tjenester. Flere av disse er som standard slått av og må aktiveres eksplisitt.

Enhetspairing

Mobile- og stasjonære klienter kobler seg til en instans gjennom en kort parringsutveksling (iOS-/macOS-appen bruker kun QR-parring).

Metode og sti	Formål
`POST /v1/pairing/redeem`	Løs inn en paringskode og konfigurer enheten
`POST /v1/pairing/device/validate`	Valider en allerede parkoblet enhet

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

Autentiseringsføderasjon

AiHummer integreres med bedriftsidentitetsleverandører for både pålogging og brukerprovisjonering.

SAML

Metode og sti	Formål
`GET /saml/metadata`	Tjenesteleverandørmetadata for din IdP
`POST /saml/acs`	Tjeneste for påstander (SAML-respons)
`GET /saml/login`	Start SAML-pålogging

SCIM-provisjonering

System for Cross-domain Identity Management (SCIM 2.0) lar din IdP opprette og administrere brukere automatisk.

Metode og sti	Formål
`.../scim/v2/Users`	Liste / opprett brukere
`.../scim/v2/Users/{id}`	Les / oppdater / slett en bruker

SCIM-endepunktene autentiserer med en per-leietaker SCIM-bærer-token, utstedt (og rotert/tilbakekalt) på POST /v1/admin/scim/token; IdP-en sender den i en Authorization: Bearer overskrift. Tokenet vises én gang ved utstedelsestidspunktet.

OAuth-token

Metode og sti	Formål
`POST /v1/oauth/token`	OAuth-tokenendepunkt

MCP-server (publiser utad)

AiHummer kan publisere sine egne verktøy til MCP-klienter ved å opptre som en MCP-server. Dette er meld deg på og deaktivert med mindre du setter AIHUMMER_MCP_PUBLISH=1.

Metode og sti	Formål
`POST /v1/mcp`	MCP-serverendepunkt (krever `AIHUMMER_MCP_PUBLISH=1`)

[!WARNING] AIHUMMER_MCP_PUBLISH=1 alene er ikke nok. Den åpner adressen, men eksportlisten er tom: tools/list returnerer et tomt array og ethvert kall avvises. List opp verktøyene med eksakte navn, kommaseparert, i AIHUMMER_MCP_EXPORT_TOOLS — mønstre og * støttes ikke. Utad kan bare lesende verktøy publiseres: http_request, web_fetch, browser, code_exec og filesystem_read eksporteres aldri, selv om du navngir dem.

Begge innstillingene settes i Administrasjon → Innstillinger eller med aihummer settings set, ikke i gateway.env — miljøet ignoreres for disse nøklene. AIHUMMER_MCP_PUBLISH godtar nøyaktig 1: true eller on lar adressen være stengt. Endringer trer i kraft etter omstart av gatewayen.

Klienten må sende en API-nøkkel med omfanget mcp i Authorization: Bearer … -hodet; uten den er svaret 401.

[!NOTE] Å publisere verktøy utad er annerledes enn å konsumere en MCP-server som en null-kode integrasjon. Dette endepunktet er for å la andre MCP-klienter kalle inn AiHummer.

A2A (Agent-til-Agent)

AiHummer kan eksponere en A2A-overflate slik at andre agenter kan oppdage og sende meldinger til den. Dette er også meld deg på via AIHUMMER_A2A_PUBLISH=1.

Metode og sti	Formål
`GET /.well-known/agent.json`	A2A agentkort / oppdagelsesdokument
`POST /a2a/message`	Motta en A2A-melding (krever `AIHUMMER_A2A_PUBLISH=1`)

Media

Store medier (lyd, bilder, filer) lastes opp og hentes gjennom dedikerte endepunkter i stedet for å være innebygd i JSON-kropper.

Metode og sti	Formål
`PUT /v1/media/{id}/content`	Last opp byte for et medieobjekt
`GET /v1/files/{id}`	Last ned en lagret fil

[!TIP] Sett AIHUMMER_BLOB_DIR for å aktivere media-/fil-tjenesten, og AIHUMMER_MEDIA_TOKEN_SECRET slik at signerte nedlastings-URL-er forblir gyldige på tvers av starter på nytt.

Koble til RPC-tjenester

For skrevne, strømmetjenesteklienter eksponerer AiHummer også Koble-RPC tjenester over HTTP (server-strømming støttes):

Tjeneste	Område
`aihummer.health.v1`	Helsesjekker
`aihummer.event.v1`	Hendelsesstrøm
`aihummer.conversation.v1`	Samtaler
`aihummer.push.v1`	Push-levering
`aihummer.media.v1`	Medi overføring
`aihummer.turn.v1`	Utførelse av tur

Hvor til neste

Push meldinger inn i AiHummer: Innkommende og integrasjonsutløsere.
Bytt disse overflatene og mer: Miljøvariabler.
Betjen instansen: CLI-referanse.