Webhooks, SCIM va Juftlash

v1.0.x · yangilandi 2026-07-05

Ushbu sahifa qolgan protokol yuzalarini qamrab oladi: qurilma juftlashuvi, korxona avtorizatsiya federatsiyasi (SAML / SCIM / OAuth), ixtiyoriy tarzda qo‘shilish MCP server va A2A tugatish nuqtalari, omma vositasi o‘tkazish va RPC-ga ulanish xizmatlar. Bularning bir nechtasi standarti bo‘yicha o‘chirilgan bo‘lib, aniq ravishda yoqilishi kerak.

Qurilmani bog’lash

Mobil va desktop mijozlari qisqa juftlik almashinuvi orqali instantsiyaga qo’shiladi (iOS/macOS ilovasi faqat QR orqali juftlikni ishlatadi).

Usul va yo‘l	Maqsad
`POST /v1/pairing/redeem`	Juftlik kodini oling va qurilmani taqdim eting
`POST /v1/pairing/device/validate`	Allaqachon juftlashtirilgan qurilmani tasdiqlang

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

Avtorizatsiya federatsiyasi

AiHummer korporativ foydalanuvchi identifikatsiya provayderlari bilan kirish va foydalanuvchi ta’minoti uchun integratsiyalashadi.

SAML

Usul va yo‘l	Maqsad
`GET /saml/metadata`	Sizning IdP uchun xizmat ko‘rsatuvchi provayder metadata
`POST /saml/acs`	Da’vo Foydalanuvchi Xizmati (SAML javobi)
`GET /saml/login`	SAML tizimiga kirishni boshlash

SCIM ta’minlash

Kross-domain Shaxsiyatni Boshqarish Tizimi (SCIM 2.0) sizning IdP foydalanuvchilarni avtomatik yaratish va boshqarish imkonini beradi.

Usul va yo‘l	Maqsad
`.../scim/v2/Users`	Foydalanuvchilar ro’yxati / yaratish
`.../scim/v2/Users/{id}`	Foydalanuvchini o‘qish / yangilash / o‘chirish

SCIM tugunlari bilan autentifikatsiya qilinadi har bir ijarachiga SCIM tashuvchi tokeni, berilgan (va aylantirilgan/bekor qilingan) da POST /v1/admin/scim/token; IdP uni bir Authorization: Bearer sarlavha. Token faqat chiqarilgan vaqtda bir marta ko’rsatiladi.

OAuth belgisi

Usul va yo‘l	Maqsad
`POST /v1/oauth/token`	OAuth token nuqtasi

MCP serveri (tashqariga nashr qilish)

AiHummer o’z asboblarini MCP mijozlariga tarqatishi mumkin, quyidagicha harakat qilib MCP server. Bu rozilik berish va o’chiriladi, aks holda siz sozlamasangiz AIHUMMER_MCP_PUBLISH=1.

Usul va yo‘l	Maqsad
`POST /v1/mcp`	MCP serveri tugun nuqtasi (talab qiladi `AIHUMMER_MCP_PUBLISH=1`)

[!WARNING] Yolg’iz AIHUMMER_MCP_PUBLISH=1 yetarli emas. U manzilni ochadi, lekin eksport ro’yxati bo’sh: tools/list bo’sh massiv qaytaradi va har qanday chaqiruv rad etiladi. Kerakli vositalarni AIHUMMER_MCP_EXPORT_TOOLS ichida aniq nomlari bilan, vergul orqali sanang — shablonlar va * qo’llab -quvvatlanmaydi. Tashqariga faqat o’qish vositalari berilishi mumkin: http_request, web_fetch, browser, code_exec va filesystem_read yozsangiz ham hech qachon eksport qilinmaydi.

Ikkala sozlama ham Boshqaruv → Sozlamalar bo’limida yoki aihummer settings set buyrug’i bilan beriladi, gateway.env ichida emas — bu kalitlar uchun muhit e’tiborga olinmaydi. AIHUMMER_MCP_PUBLISH aniq 1 qabul qiladi: true yoki on manzilni yopiq qoldiradi. O’zgarishlar shlyuz qayta ishga tushirilgandan keyin kuchga kiradi.

Mijoz Authorization: Bearer … sarlavhasida mcp qamrovli API kalitini yuborishi shart; usiz javob — 401.

[!NOTE] Nashr qilish vositalarini tashqariga chiqarish MCP serverini iste’mol qilishdan farq qiladi nol-kod integratsiyasi. Ushbu endpoint boshqa MCP mijozlariga murojaat qilish imkonini berish uchun mo‘ljallangan AiHummer.

A2A (Agentdan Agentga)

AiHummer boshqa agentlar uni topib, xabar yuborishi uchun A2A yuzasini ochishi mumkin. Bu ham shunday rozilik berish orqali AIHUMMER_A2A_PUBLISH=1.

Usul va yo‘l	Maqsad
`GET /.well-known/agent.json`	A2A agent kartasi / kashfiyot hujjati
`POST /a2a/message`	A2A xabarini oling (talab qiladi `AIHUMMER_A2A_PUBLISH=1`)

OAV

Katta media (audio, tasvirlar, fayllar) JSON tanalariga qo’shilgan o’rniga maxsus endpointlar orqali yuklanadi va olinadi.

Usul va yo‘l	Maqsad
`PUT /v1/media/{id}/content`	Media obyekti uchun baytlarni yuklang
`GET /v1/files/{id}`	Saqlangan faylni yuklab oling

[!TIP] Oʻrnatish AIHUMMER_BLOB_DIR media/fayl xizmatini yoqish uchun, va AIHUMMER_MEDIA_TOKEN_SECRET shunday qilib, imzolangan yuklab olish URL manzillari butun davomida amal qiladi qayta ishga tushiradi.

Connect-RPC xizmatlari

Typed va streaming mijozlar uchun AiHummer ham ochadi RPC-ga ulanish HTTP orqali xizmatlar (server oqimi qo‘llab-quvvatlanadi):

Xizmat	Hudud
`aihummer.health.v1`	Sog’liqni tekshirish
`aihummer.event.v1`	Tadbir oqimi
`aihummer.conversation.v1`	Suhbatlar
`aihummer.push.v1`	Push yetkazib berish
`aihummer.media.v1`	Media uzatish
`aihummer.turn.v1`	Aylantirishni bajarish

Keyingi qayerga

AiHummer-ga xabarlarni yuboring: Kirish va integratsiya tetiklovchilari.
Ushbu sirtlarni va boshqalarni yoqing/o‘chiring: Atrof-muhit o’zgaruvchilari.
Vaziyatni boshqaring: CLI ma’lumotnomasi.