Dostęp do konektora ma trzy oddzielne warstwy: połączenie członka, autoryzację agenta oraz nazwane uprawnienia przyznane temu agentowi. Połączenie usługi nie przyznaje automatycznie każdemu agentowi wszystkich akcji.
Połączenie, autoryzacja i uprawnienie
| Warstwa | Co kontroluje |
|---|---|
| Połączenie | Które konto członka lub poświadczenie może być użyte do usługi. |
| Autoryzacja agenta | Który agent może korzystać z połączonej usługi. |
| Przyznanie uprawnienia | Jakie nazwane akcje agent może żądać i na jak długo. |
Dla usług z poświadczeniami przypisanymi do członka, każdy członek łączy własne konto. Współdzielony agent nadal działa przez połączone konto i przyznane uprawnienia członka uruchamiającego; nie dziedziczy skrzynki odbiorczej, tokena ani prywatnej historii czatu współpracownika.
Przyznawanie dostępu
Gdy agent potrzebuje uprawnienia do konektora, którego nie posiada, Okou wyświetla żądanie uprawnienia. Przed wyborem Zezwól lub Odmów przejrzyj konektor, agenta, nazwę uprawnienia i powód.
Dozwolone uprawnienie można przyznać na jeden z czasów dostępnych w produkcie:
- Zezwól na 1h
- Zezwól na 24h
- Zezwól na 7d
- Zezwól zawsze
Po wygaśnięciu czasowego przyznania agent musi ponownie o nie poprosić. Odmowa jednego uprawnienia nie odłącza konta ani nie usuwa niepowiązanych uprawnień.
Zarządzaj bieżącym dostępem agenta do konektora w jego ustawieniach autoryzacji. Widok dostępu do konektora pokazuje, którzy agenci są autoryzowani i czy ich stan uprawnień to dozwolone, odrzucone czy mieszane.
Obsługa poświadczeń
Tokeny OAuth i ręcznie wprowadzane sekrety są przechowywane na platformie. Dla żądań konektora firewall wstrzykuje poświadczenie na granicy sieci; sekret nie jest udostępniany kodowi agenta jako zmienna środowiskowa.
Nie wklejaj kluczy API, tokenów OAuth, haseł ani sekretów klienta do czatu, instrukcji agenta, instrukcji workflow ani załączonego pliku. Zamiast tego użyj procesu połączenia konektora.
Odłączenie konektora członka usuwa to połączenie z przyszłych uruchomień. Usunięcie autoryzacji agenta uniemożliwia temu agentowi korzystanie z konektora, pozostawiając innych autoryzowanych agentów bez zmian.
Granice zatwierdzeń
Wymuszalną granicą jest nazwane przyznanie uprawnienia konektora. Nie polegaj na ogólnej kategorii akcji, by zagwarantować, że każdy e-mail, post, płatność, zmiana infrastruktury czy usunięcie zawsze zostanie wstrzymane w ten sam sposób.
Dla pracy wymagającej recenzji człowieka:
- Przyznaj tylko uprawnienie do odczytu lub wersji roboczej i odmów ostatecznego zapisu lub wysyłki, jeśli konektor udostępnia je osobno.
- Określ wymóg recenzji w instrukcji agenta lub workflow.
- Zachowaj ostateczną akcję po stronie człowieka, np. przez utworzenie wersji roboczej Gmail lub proponowanej zmiany zamiast wysyłania lub zastosowania jej.
Korzystaj także z kontroli usług źródłowych: ograniczonych kluczy API, minimalnych zakresów OAuth, uprawnień repozytorium i oddzielnych poświadczeń produkcyjnych.
Czaty, logi i widoczność administracyjna
Członkowie mają dostęp do własnych wątków czatu. Opublikowanie agenta lub workflow nie udostępnia prywatnej historii czatu członka ani poświadczenia konektora. Udostępniaj rozmowę lub artefakt wyłącznie przez wyraźną funkcję udostępniania.
Administratorzy workspace mogą zobaczyć zagregowane dane użycia na poziomie członka, wykorzystywane do rozliczeń i zarządzania pojemnością. Nie daje to automatycznego wglądu w prywatne treści czatów innych członków.
W ramach własnego czatu członka widok aktywności rejestruje widoczną sekwencję uruchomień, aktywność konektora, artefakty, statusy i błędy. Użyj go, by sprawdzić, czy żądana akcja konektora została wykonana i czy zakończyła się sukcesem.
Lista kontrolna do przeglądu
- Czy konektor jest powiązany z zamierzonym kontem członka?
- Czy zamierzony agent jest autoryzowany?
- Czy dozwolone są tylko uprawnienia potrzebne do tego zadania?
- Czy przyznanie może wygasnąć po 1 godzinie, 24 godzinach lub 7 dniach zamiast pozostać na stałe?
- Czy workflow utrzymuje nieodwracalne lub zewnętrzne akcje w kroku recenzji człowieka?
- Czy poświadczenie źródłowe można jeszcze bardziej zawęzić?
Co dalej
- Zobacz Czat, aby dowiedzieć się, co dzieje się w granicach czatu.
- Zobacz Konektory po katalog i możliwości każdego z nich.
- Zobacz Dla zespołów w celu konfiguracji uprawnień na poziomie organizacji.
