Webhooks, SCIM ve Eşleştirme

v1.0.x · güncellendi 2026-07-05

Bu sayfa kalan protokol yüzeylerini kapsar: cihaz eşleştirme, işletme kimlik federasyonu (SAML / SCIM / OAuth), isteğe bağlı MCP sunucusu ve A2A uç noktalar, medya transfer ve RPC’ye Bağlan Hizmetler. Bunların birkaç tanesi varsayılan olarak devre dışıdır ve açıkça etkinleştirilmelidir.

Cihaz eşleştirme

Mobil ve masaüstü istemciler, kısa bir eşleştirme değişimi yoluyla bir örneğe katılır (iOS/macOS uygulaması yalnızca QR ile eşleştirme kullanır).

Yöntem & yol	Amaç
`POST /v1/pairing/redeem`	Bir eşleştirme kodunu kullan ve cihazı sağla
`POST /v1/pairing/device/validate`	Zaten eşleştirilmiş bir cihazı doğrulayın

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

Kimlik doğrulama federasyonu

AiHummer, giriş ve kullanıcı sağlama için kurumsal kimlik sağlayıcılarıyla entegre olur.

SAML

Yöntem & yol	Amaç
`GET /saml/metadata`	IdP’niz için hizmet sağlayıcı meta verileri
`POST /saml/acs`	Doğrulama Tüketici Servisi (SAML yanıtı)
`GET /saml/login`	SAML girişini başlat

SCIM sağlama

Çapraz Alan Kimlik Yönetimi Sistemi (SCIM 2.0), IdP’nizin kullanıcıları otomatik olarak oluşturmasına ve yönetmesine olanak tanır.

Yöntem & yol	Amaç
`.../scim/v2/Users`	Kullanıcıları listele / oluştur
`.../scim/v2/Users/{id}`	Bir kullanıcıyı oku / güncelle / sil

SCIM uç noktaları ile doğrulama yapar her kiracı için SCIM taşıyıcı belirteci, verilmiş (ve döndürülmüş/iptal edilmiş) itibariyle POST /v1/admin/scim/token; IdP bunu bir Authorization: Bearer başlık. Jeton, verildiği anda bir kez gösterilir.

OAuth belirteci

Yöntem & yol	Amaç
`POST /v1/oauth/token`	OAuth belirteç uç noktası

MCP sunucusu (dışa yayınla)

AiHummer, bir … olarak hareket ederek kendi araçlarını MCP müşterilerine yayınlayabilir MCP sunucusu. Bu katılmak ve etkinleştirilmez, ayarlamazsanız AIHUMMER_MCP_PUBLISH=1.

Yöntem & yol	Amaç
`POST /v1/mcp`	MCP sunucu uç noktası (gerektirir `AIHUMMER_MCP_PUBLISH=1`)

[!WARNING] Tek başına AIHUMMER_MCP_PUBLISH=1 yetmez. Adresi açar, ama dışa aktarma listesi boştur: tools/list boş dizi döndürür ve her çağrı reddedilir. İstediğiniz araçları AIHUMMER_MCP_EXPORT_TOOLS içinde tam adlarıyla, virgülle ayırarak yazın — desenler ve * desteklenmez. Dışarıya yalnızca okuma araçları verilebilir: http_request, web_fetch, browser, code_exec ve filesystem_read adlarını yazsanız bile hiçbir zaman dışa aktarılmaz.

Her iki ayar da Yönetim → Ayarlar ekranından veya aihummer settings set komutuyla verilir, gateway.env içinden değil — bu anahtarlarda ortam değişkenleri yok sayılır. AIHUMMER_MCP_PUBLISH tam olarak 1 kabul eder: true ya da on adresi kapalı bırakır. Değişiklikler ağ geçidi yeniden başlatıldıktan sonra geçerli olur.

İstemci, Authorization: Bearer … başlığında mcp kapsamlı bir API anahtarı göndermek zorundadır; anahtar yoksa yanıt 401 olur.

[!NOTE] Yayın araçlarını dışa aktarmak, bir MCP sunucusunu tüketmekten farklıdır sıfır-kod entegrasyonu. Bu uç nokta, diğer MCP istemcilerinin çağrı yapmasına izin vermek içindir AiHummer.

A2A (Ajan’dan Ajan’a)

AiHummer, diğer ajanların keşfedip mesaj gönderebileceği bir A2A yüzeyi açığa çıkarabilir. Bu aynı zamanda katılmak aracılığıyla AIHUMMER_A2A_PUBLISH=1.

Yöntem & yol	Amaç
`GET /.well-known/agent.json`	A2A ajan kartı / keşif belgesi
`POST /a2a/message`	Bir A2A mesajı alın (gerektirir `AIHUMMER_A2A_PUBLISH=1`)

Medya

Büyük medya (ses, görseller, dosyalar), JSON gövdelerine gömülmek yerine özel uç noktalardan yüklenir ve alınır.

Yöntem & yol	Amaç
`PUT /v1/media/{id}/content`	Bir medya nesnesi için baytları yükleyin
`GET /v1/files/{id}`	Depolanan bir dosyayı indir

[!TIP] Set AIHUMMER_BLOB_DIR medya/dosya hizmetini etkinleştirmek ve AIHUMMER_MEDIA_TOKEN_SECRET böylece imzalı indirme URL’leri boyunca geçerli kalır yeniden başlatır.

Connect-RPC hizmetleri

Yazılı, akış müşterileri için AiHummer ayrıca sunar RPC’ye Bağlan HTTP üzerinden hizmetler (sunucu akışı desteklenir):

Hizmet	Alan
`aihummer.health.v1`	Sağlık kontrolleri
`aihummer.event.v1`	Olay akışı
`aihummer.conversation.v1`	Konuşmalar
`aihummer.push.v1`	Anlık bildirim göndermek
`aihummer.media.v1`	Medya transferi
`aihummer.turn.v1`	Hamleyi gerçekleştirme

Sonra nereye?

Mesajları AiHummer’a it: Gelen ve entegrasyon tetikleyicileri.
Bu yüzeyleri ve daha fazlasını değiştir: Ortam değişkenleri.
Örneği çalıştır: CLI referansı.