W ramach migracji do monday workflows funkcja Adres URL autoryzacji (Authorization URL) nie jest obsługiwana. Zastąp ją funkcją aplikacji Dane uwierzytelniające (Credentials) lub wbudowanymi mechanizmami uwierzytelniania.

Dane uwierzytelniające zapewniają:

• Bezpieczne przechowywanie danych uwierzytelniających zarządzane przez monday.com
• Spójne środowisko użytkownika
• Obsługę wielu produktów (Automation Builder, Workflow Builder, AI Sidekick)
• Wbudowane zarządzanie danymi uwierzytelniającymi (wyświetlanie, tworzenie i usuwanie)

Lista kontrolna migracji

• Sprawdź, z jakiego wzorca uwierzytelniania korzysta Twoja aplikacja
• Wybierz odpowiednią ścieżkę migracji
• Utwórz nową funkcję danych uwierzytelniających, jeśli jest wymagana
• Zaktualizuj implementacje bloków, aby korzystały z nowej metody uwierzytelniania
• Przetestuj cały proces uwierzytelniania

Ścieżki migracji

Ścieżka 1: Uwierzytelnianie za pomocą API monday.com

Zastosowanie

Korzystasz z funkcji Adres URL autoryzacji, aby uwierzytelniać żądania do interfejsu GraphQL API monday.com.

Sposób migracji

Użyj shortLivedToken zawartego w nagłówku JWT Authorization, który jest wysyłany do punktów końcowych Twoich bloków. Nie musisz tworzyć funkcji danych uwierzytelniających ani procesu łączenia konta przez użytkownika. Token automatycznie zawiera zakresy uprawnień OAuth zatwierdzone dla Twojej aplikacji, więc nie musisz osobno wdrażać OAuth, aby uzyskać dostęp do API monday.com.

Jak to działa

• monday.com wysyła żądania do punktów końcowych Twoich bloków z nagłówkiem Authorization
• Zweryfikuj i zdekoduj JWT za pomocą tajnego klucza podpisującego aplikacji (Signing Secret)
• Pobierz shortLivedToken z danych JWT
• Użyj tokenu do uwierzytelniania wywołań API monday.com

Struktura danych JWT

{
  "accountId": 1825529,
  "userId": 4012689,
  "aud": "https://www.yourserver.com/endpoint",
  "exp": 1606808758,
  "shortLivedToken": "eyJhbGciOiJIUzI1NiJ9...",
  "iat": 1606808458
}

Przykład

import jwt from 'jsonwebtoken';

router.post('/your-block-endpoint', async (req, res) => {
  const token = req.headers.authorization?.replace('Bearer ', '');
  const payload = jwt.verify(token, process.env.MONDAY_SIGNING_SECRET);

  const mondayToken = payload.shortLivedToken;

  const response = await fetch('https://api.monday.com/v2', {
    method: 'POST',
    headers: {
      Authorization: mondayToken,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      query: 'query { me { id name } }'
    })
  });

  // ...handle response
});

Ścieżka 2: OAuth z usługami zewnętrznymi

Zastosowanie

Korzystasz z funkcji Adres URL autoryzacji do uwierzytelniania OAuth w usługach zewnętrznych, takich jak Google, Slack czy Salesforce.

Sposób migracji

Użyj funkcji aplikacji Dane uwierzytelniające skonfigurowanej z OAuth. monday.com obsługuje proces OAuth i bezpiecznie przechowuje dane uwierzytelniające.

1. Utwórz funkcję danych uwierzytelniających w aplikacji.
2. Wybierz OAuth jako typ uwierzytelniania.
3. Skonfiguruj ustawienia OAuth: * Identyfikator klienta * Tajny klucz klienta * Adres URL autoryzacji (usługa zewnętrzna) * Adres URL tokenu * Zakresy * Obsługa identyfikatora URI przekierowania
4. Dodaj pole danych uwierzytelniających do konfiguracji bloku.
5. Uzyskaj dostęp do tokenu OAuth w czasie działania.

Przykład użycia w czasie działania

{
  "payload": {
    "credentialsValues": {
      "credentials-key": {
        "userCredentialsId": 1231,
        "accessToken": "..." // Used to make API calls to the third-party service
      }
    }
  }
}

Ścieżka 3: Uwierzytelnianie za pomocą klucza API

Zastosowanie

Korzystasz z funkcji Adres URL autoryzacji do zbierania kluczy API usług zewnętrznych.

Sposób migracji

1. Utwórz nową funkcję danych uwierzytelniających w aplikacji.
2. Wybierz Klucz API (API Key) jako typ uwierzytelniania.
3. Dodaj funkcję danych uwierzytelniających do bloków.
4. Odbieraj wartości danych uwierzytelniających w czasie działania.

Ścieżka 4: Uwierzytelnianie niestandardowe lub ręczne

Zastosowanie

Wdrożono niestandardową logikę uwierzytelniania, która nie pasuje do schematu OAuth ani klucza API.

Wymagania wstępne

Zanim wybierzesz tę ścieżkę, upewnij się, że Twoja aplikacja ma istniejącą funkcję Integration for sentence builder z polem typu credentials. Uruchom kreator migracji, aby ją przekształcić. Po migracji aplikacja będzie mieć funkcję danych uwierzytelniających typu niestandardowego.

Sposób migracji

Użyj zmigrowanej funkcji danych uwierzytelniających z niestandardową konfiguracją pól. To rozwiązanie jest przeznaczone do zaawansowanych zastosowań, których nie da się obsłużyć za pomocą uwierzytelniania OAuth ani klucza API.

1. Zmigruj istniejącą funkcję Integration for sentence builder za pomocą kreatora migracji. Spowoduje to utworzenie funkcji danych uwierzytelniających typu niestandardowego.
2. Skonfiguruj niestandardowe pola do wprowadzania danych przez użytkownika.

Adres URL	Zastosowanie
Adres URL danych uwierzytelniających (Credentials URL)	Zwraca listę zapisanych danych uwierzytelniających
Adres URL autoryzacji	Obsługuje tworzenie nowych danych uwierzytelniających
Adres URL usuwania danych uwierzytelniających (Delete Credentials URL)	Usuwa dane uwierzytelniające