Əlaqələr (istifadəçi başına OAuth2)
Əlaqələr bir fərdi istifadəçinin AiHummer-ə üçüncü tərəf xidmətinə öz adından daxil olmaq üçün necə icazə verdiyidir. Tək bir paylaşılmış xidmət hesabı əvəzinə hər bir şəxs standart bir hesabı idarə edir OAuth2 icazə-kodu axını, nəticədə yaranan token şifrəli seyfdə saxlanılır və növbə zamanı alətə ehtiyac olduqda icra mühiti o istifadəçinin tokenini həll edir.
Bu, AiHummer-in etimad modeli üçün “şəxsi” hissəsidir. Daha geniş mənzərə üçün — paylaşılan etimadı nə zaman üstün tutmaq və ehtiyat mexanizminin necə işlədiyini görmək üçün — bax Şəxsi vs paylaşılmış giriş məlumatları.
Aşağıdakı şəxsi axın əsas olaraq qalır. İmzalanmış Core 1.4.15 quraşdırıldıqdan sonra konfiqurasiya edilmiş kanal və yerli alətlər ayrıca connection-token açarı ilə açıq şəkildə bağlanmış bir hesabı seçə bilər; tokenləri yalnız məxfi məlumat anbarı yeniləyir. Bu, bütün istifadəçilərin icazələrini paylaşmır və hər əməkdaşın qoşulmasını tələb etmir. Alətlər fəaliyyət göstərən istifadəçinin cari hüquqlarını yoxlayır. Bax: Bitrix24.
Əlaqə nədir
Bir Bağ üç şeyi birləşdirir: bir təchizatçı (siz təsdiq etdiyiniz OAuth2 tətbiqi), bir istifadəçi (razılıq ekranını tamamlayan şəxs) və kameraya giriş (verilən tokenin saxlandığı yer). Quraşdırıldıqdan sonra, həmin istifadəçi adından fəaliyyət göstərən hər hansı bir alət, token heç vaxt model kontekstində, qeydlərdə və ya təlimatlarda görünmədən şəffaf şəkildə istifadə edə bilər.
Əlaqələr admin UI-dan idarə olunur. Siyahı hər istifadəçinin qoşulmuş təminatçılarını, onların vəziyyətini və sonuncu dəfə nə zaman yeniləndiyini göstərir.
Avtorizasiya-kod axını
Kanoonik üçayaqlı OAuth2 avtorizasiya-kodu qrantı ilə bir Əlaqə yaradılır:
- İstifadəçi admin UI-dan bir provayder üçün əlaqəni başlayır — a
POST/GET /v1/admin/connections/oauth/startsorğu. - AiHummer brauzeri təminatçının səhifəsinə yönləndirir səlahiyyət son nöqtə tələb olunan sferalarla.
- İstifadəçi razılıq ekranını təsdiqləyir; təminatçı isə geri yönləndirir və bununla
bir dəfəyə təsdiqləmə kodu ilə
/v1/admin/connections/oauth/callback. - Geri çağırış işləyicisində, AiHummer həmin kodu server tərəfində bir dəyişdirir giriş simvolu (və, təminatçı bunu dəstəklədikdə, bir yeniləmə jetonu) təklifçinin token son nöqtəsində.
- Token kassaya yazılır və Bağlantı aktiv kimi işarələnir.
Kod-token mübadiləsi server tərəfində, çağırış funksiyası daxilində baş verir, buna görə də müştəri gizli açarı və verilmiş token heç vaxt keçid nöqtəsindən çıxmır.
[!NOTE] Bu axını ilə qarışdırmayın
POST /v1/oauth/token: bu AiHummer-ə aiddir öz OAuth2 müştəri-əlaqə nöqtəsi — xidmət hesabları vasitəsilə qeydiyyatdan keçmiş/v1/admin/apikeys/register-clientmübadilə etmək onlarınclient_id/client_secretqısamüddətli oradaah-token. Bunun üçüncü tərəflə heç bir əlaqəsi yoxdur Əlaqələr.
[!NOTE] Avtorizasiya-kodu axını həmişə real brauzer razılıq addımını əhatə edir. A Yalnız API açarı ilə başsız bir əlaqə yaradıla bilməz — hərəkət edən istifadəçi təkcə bir dəfə sahələri təsdiqləməlidir.
Tokenin yaşadığı yer
Verilən token AiHummer-in içində saxlanılır şifrələnmiş etimadnamə anbarı, sadə konfiqurasiyada deyil. Şəffaflıq anbarı zərf şifrələməsindən istifadə edir (müştəriyə aid məlumat açarı altında master açarla AES-256-GCM) və sirləri heç vaxt model kontekstinə, istək və ya loqlara köçürülmür. Ləğv olunmuş və ya müddəti bitmiş Bağlantı sadəcə heç bir istifadə edilə bilən sirr qoymur.
oauth/start ─▶ consent ─▶ code ─▶ oauth/callback (exchange at the provider) ─▶ access/refresh token ─▶ vault (encrypted)
Fəaliyyətdə olan istifadəçi tərəfindən həll edildi
Bir Qoşulmanın müəyyən edən xüsusiyyəti onun olmasıdır fəaliyyət göstərən istifadəçi tərəfindən həll edildi. Bir agent təminatçıya ehtiyacı olan bir aləti işlətdikdə, icra mühiti dönüşün yerinə yetirildiyi istifadəçinin aid olduğu Bağlantını yoxlayır və onların tokenindən istifadə edir. Buna görə də eyni agentlə danışan iki əməkdaş öz səlahiyyətləri ilə hərəkət edir və yalnız öz icazələrinin verdiyi məlumatları görür.
Bu, Connections-i fərdi, istifadəçi başına inteqrasiyalar üçün uyğun edən amildir: hər bir şəxsin girişi izolyasiya olunub, yoxlanıla bilir və fərdi olaraq ləğv edilə bilər.
Mövcud inteqrasiyalar
Aşağıdakı xidmətlər şəxsi bağlantıları dəstəkləyir. OAuth başlatmaq üçün bu serverdə provayder sazlanmalıdır.
| Qrup | Xidmətlər |
|---|---|
| Gmail, Google Təqvim, Google Kontaktlar, Google Tapşırıqlar, Google Drive, YouTube | |
| Microsoft | Outlook Poçtu, Outlook Təqvimi, OneDrive, Microsoft To Do |
| Məhsuldarlıq | Todoist, Asana, Jira Cloud, ClickUp, GitLab, Linear, monday.com |
| Sağlamlıq və həyat tərzi | Fitbit, Oura Ring, Strava, Spotify, Samsung SmartThings |
OAuth bağlantısı əlçatandırsa, provayderin razılıq ekranını tamamlayın. Verilən token şəxsi məxfi məlumatlar anbarınızda saxlanılır və alət həmin xidmətdən istifadə etdikdə seçilir.
OAuth əlçatan olmadıqda şəxsi Gmail
Gmail OAuth əlçatan deyilsə, agentdən şəxsi Gmail üçün quraşdırma keçidini istəyin. Keçidin yaradıldığı AiHummer hesabına daxil olaraq onu açın. Hesab uyğun gəlmirsə, düzgün hesaba daxil olub keçidi yenidən açın. Forma agentin poçt qutusu ilə yanaşı ayrıca məxfi şəxsi bağlantı saxlayır.
Google hesabınız bu imkanı dəstəkləyirsə və iki mərhələli doğrulama aktivdirsə, Google hesabı sazlamalarında tətbiq parolu yaradın. Gmail ünvanınızı və yaradılmış tətbiqə məxsus parolu birbaşa formaya daxil edin. IMAP/SMTP parametrləri avtomatik seçilir. Tətbiq parolu sazlamaları · Google hesabı yardımı.
Saxladıqdan sonra agentdən şəxsi Gmail poçtunuzu oxumağı istəyin. mail alətində account=personal_gmail şəxsi Gmail-i, account=agent isə agentin poçt qutusunu seçir. Hər əməliyyatda cari giriş hüquqları və seçilmiş giriş məlumatları yoxlanılır. Saxlama məlumatların yazıldığını təsdiqləyir. Uğurlu oxuma girişi təsdiqləyir. Göndərmə üçün sizin tapşırığınız lazımdır. Göndərmə təsdiqlənməyibsə, yeni cəhddən əvvəl ilkin əməliyyat qəbzini yoxlayın.
İdarəetmə interfeysində əlaqələrin idarə olunması
İdarəçi UI-dən operator bunu edə bilər:
- Hər istifadəçinin hansı provayderlərə qoşulduğunu və hər tokenin vəziyyətini görün.
- Yeni bir əlaqə başlatmaq (seçilmiş provayder üçün razılıq axınını başlatmaq).
- Əlaqəni ləğv edin, bu, sandıq girişini silir və həll etməni qeyri-aktiv edir.
Əlaqələr ya şəxsi (müəyyən bir istifadəçiyə məxsus, onu ayıra bilən) və ya iş sahəsi ilə paylaşıldı (“İş sahəsi paylaşıldı” kimi etiketlənib; onları şəxsən ayırmaq mümkün deyil). Bir provayder saxlaya bilər çoxlu hesablar: “+ hesab” düyməsi etiket və eyni təminatçının başqa bir şəhadətnaməsini tələb edir — məsələn, bir neçə Google təqvimi və ya poçt qutusu.
Çünki əsas vasitəçilik məlumatları şəxsidir, Bir əlaqə çox vaxt düzgün vasitədir, əgər bir əməliyyat müəyyən bir insanın səlahiyyətinə aid edilməli və ona görə məhdudlaşdırılmalıdırsa, iş sahəsi üzrə hesab əvəzinə.
Növbəti haradır
- Şəxsi vs paylaşılmış giriş məlumatları — tam həcm modeli və hər birini nə zaman seçmək.
- BYOK LLM təminatçıları — öz model açarlarını gətir hər kirayəçi üçün.
- Marketplace icmalı və səviyyələri — harada OAuth ilə dəstəklənən inteqrasiyalar uyğundur.