W Ustawieniach › Dostęp do API możesz tworzyć osobiste tokeny dostępu, dzięki którym skrypt lub klient MCP może korzystać z Dvina w Twoim imieniu. Administratorzy mogą też dodawać tam webhooki, aby wysyłać zdarzenia z przestrzeni Livespace do własnych systemów.
Dostęp do API jest dostępny w planie Enterprise. Każdy członek może tworzyć własne tokeny; sekcję Webhooki widzą tylko właściciele i administratorzy.
Utwórz token
- Otwórz Ustawienia i wybierz Dostęp do API.
- W sekcji Osobiste tokeny dostępu wybierz Utwórz token.
- Wpisz Nazwę, aby później wiedzieć, co korzysta z tego tokenu.
- Wybierz Dostęp: Tylko odczyt lub Odczyt i zapis.
- Wybierz, kiedy token Wygasa: Za 30 dni, Za 90 dni, Za 365 dni lub Nigdy nie wygasa.
- Wybierz Utwórz token.
- W sekcji Skopiuj swój token skopiuj token i zachowaj go w bezpiecznym miejscu. Jest wyświetlany tylko ten jeden raz.
Token działa w Twoim imieniu w przestrzeni Livespace, w której został utworzony, zgodnie z Twoją obecną rolą w tej przestrzeni. Token z dostępem Tylko odczyt pozwala odczytywać dane, ale nie pozwala niczego dodawać ani zmieniać.
Aby użyć tokenu z klientem MCP, zobacz Połącz się za pomocą klucza API zamiast OAuth.
Sprawdź, wymień lub unieważnij token
Twoje tokeny są wymienione w sekcji Osobiste tokeny dostępu wraz z zakresem dostępu. Wybierz token, aby sprawdzić, od czego Zaczyna się, jaki ma Dostęp, kiedy był Ostatnio używany i kiedy Wygasa.
- Aby wymienić token, wybierz Wymień…, a następnie Wymień, aby potwierdzić. Nowy token zastąpi dotychczasowy, a stary natychmiast przestanie działać. Skopiuj nowy token w sekcji Skopiuj swój token.
- Aby unieważnić token, wybierz Unieważnij…, a następnie Unieważnij, aby potwierdzić. Wszystko, co z niego korzysta, natychmiast przestanie działać.
Tworzenie, wymiana i unieważnianie tokenów są rejestrowane w dzienniku audytu.
Dodaj webhook
Webhook wysyła zdarzenia z przestrzeni Livespace — te same wpisy co w dzienniku audytu — na wybrany przez Ciebie adres.
- W Ustawieniach › Dostęp do API, w sekcji Webhooki, wybierz Dodaj webhook.
- Wpisz Nazwę i URL. Użyj publicznego adresu URL z protokołem HTTPS.
- Pole Zdarzenia pozostaw puste, aby wysyłać wszystkie zdarzenia, lub podaj działania i obszary, takie jak
member.addedlubsharing.*. - Wybierz Dodaj.
- W sekcji Skopiuj klucz do podpisywania skopiuj klucz. Jest wyświetlany tylko ten jeden raz.
Jeśli Dvina wyświetla komunikat Ten adres jest niedostępny z Dvina, użyj publicznego adresu URL z protokołem HTTPS.
Sprawdzaj podpis każdego żądania
Dvina wysyła zdarzenia partiami w formacie JSON i podpisuje każde żądanie. Użyj klucza do podpisywania, aby sprawdzić, czy żądanie pochodzi z Dvina:
- Każde żądanie zawiera nagłówek
X-Dvina-Signaturew postacit=<timestamp>,v1=<signature>. - Podpis to zapisany szesnastkowo kod HMAC-SHA256 obliczony dla znacznika czasu, kropki i treści żądania przy użyciu Twojego klucza do podpisywania.
- Oblicz podpis samodzielnie i porównaj go z otrzymanym. Odrzuć żądanie, jeśli podpisy się nie zgadzają lub znacznik czasu jest zbyt stary.
Sprawdź lub zmień webhook
Twoje webhooki są widoczne w sekcji Webhooki wraz ze statusem: Włączony, Wstrzymany lub Błąd. Wybierz webhook, aby zobaczyć jego szczegóły.
- Aby go zmienić, edytuj Nazwę, URL lub Zdarzenia, a następnie wybierz Zapisz.
- Aby go wstrzymać, wyłącz opcję Wysyłaj zdarzenia. Włącz ją ponownie, aby wznowić wysyłanie.
- Aby sprawdzić, jak działa, sprawdź jego Status i liczbę zdarzeń oznaczonych jako Wysłane. Webhook ze statusem błędu pokazuje Ostatni błąd. Dvina ponawia próby i zapisuje niepowodzenie w dzienniku audytu.
- Aby zmienić jego sekret, wybierz Nowy sekret podpisywania…, a następnie potwierdź. Żądania są od razu podpisywane nowym sekretem, więc natychmiast zaktualizuj konfigurację odbiorcy.
- Aby go usunąć, wybierz Usuń…, a następnie Usuń, aby potwierdzić. Nic więcej nie będzie do niego wysyłane.