Podczas tworzenia integracji z monday.com musisz obsłużyć uwierzytelnianie. Poniżej znajdziesz główne przepływy uwierzytelniania, które musisz zaimplementować:

• Weryfikowanie autentyczności żądań wysyłanych przez monday
• Uwierzytelnianie za pomocą krótkotrwałego tokenu
• Inicjowanie przepływu OAuth

Weryfikowanie autentyczności żądań wysyłanych przez monday.com

Twoja aplikacja powinna weryfikować Authorization JWT dołączony do każdego żądania, aby potwierdzić, że żądania przychodzą z monday.com.

monday.com podpisuje każde wychodzące żądanie tokenem JWT (JSON Web Token) umieszczonym w nagłówku Authorization. Możesz zdekodować ten token, aby wyodrębnić przydatne metadane, i zweryfikować jego podpis, aby potwierdzić autentyczność żądania.

Tokeny JWT są podpisywane różnymi kluczami w zależności od źródła webhooka:

• Webhooki cyklu życia aplikacji: podpisywane przy użyciu Client Secret aplikacji
• Webhooki tablicy: podpisywane przy użyciu Signing Secret aplikacji

Weryfikowanie tokenu JWT

Dekoduj i weryfikuj token JWT za pomocą biblioteki innej firmy, takiej jak jsonwebtoken lub pyjwt. Odwiedź jwt.io, aby zobaczyć listę bibliotek dostępnych w różnych językach.

Zawartość tokenu JWT

Token JWT zawiera obiekt JSON z metadanymi dotyczącymi żądania. Ma następującą strukturę:

{
  "accountId": 1825528, // the ID of the account initiating the request
  "userId": 4012689, // the ID of the user triggering the action
  "aud": "https://www.yourserver.com/endpoint", // the expected audience of the token (your app’s endpoint URL)
  "exp": 1606808758, // expiration timestamp of the JWT
  "shortLivedToken": "SHORT_LIVED_TOKEN_HERE", // the short-lived token to authenticate against the monday API
  "iat": 1606808458 // issued-at timestamp of the JWT
}

Ten token JWT będzie dołączany za każdym razem, gdy serwer integracyjny monday wyśle żądanie POST do aplikacji integracyjnej, na przykład podczas:

• Przekierowywania użytkownika do adresu URL autoryzacji aplikacji
• Subskrybowania niestandardowego wyzwalacza
• Anulowania subskrypcji niestandardowego wyzwalacza
• Wywoływania adresu URL uruchomienia niestandardowej akcji
• Pobierania zdalnych opcji pola listy rozwijanej
• Pobierania zdalnych definicji pól dla pól obiektów i niestandardowych encji

Uwierzytelnianie za pomocą krótkotrwałego tokenu API

Podczas działania integracji monday wyśle do aplikacji krótkotrwały token API. Token znajduje się w nagłówku Authorization i jest ważny przez pięć minut.

Możesz użyć tego tokenu do uwierzytelnienia w monday API. Będzie miał te same zakresy uprawnień co Twoja aplikacja. Pamiętaj, że monday.com wyda krótkotrwały token tylko wtedy, gdy punkty końcowe aplikacji są zabezpieczone protokołem HTTPS.

Szczegółowe informacje o uwierzytelnianiu za pomocą tego tokenu znajdziesz w dokumentacji Uwierzytelnianie monday API.

Inicjowanie przepływu OAuth

Jeśli integracja musi uwierzytelniać się w systemie innej firmy, na przykład w celu wysyłania danych lub przechowywania tokenów OAuth, możesz wybrać jedną z dwóch opcji:

• Pole poświadczeń (zalecane): użyj tej opcji, jeśli chcesz współdzielić ten sam kod w przepływach pracy i kreatorze zdań (sentence builder). Więcej informacji znajdziesz w dokumentacji pola poświadczeń.
• Adres URL autoryzacji: użyj tej opcji, jeśli wszyscy przechodzą przez ten sam przepływ albo jeśli korzystasz z kreatora zdań. Więcej informacji znajdziesz w dokumentacji adresu URL autoryzacji.