Przejdź do treści
Intum Pomoc

Webhook niezależny od domeny konta (Globalny kod dostępu)

Aktualizacja: 2 min czytania
Na tej stronie

Zwykły adres wywołania konektora (opisany w Uruchamianie i sprawdzanie konektora) leży pod domeną twojego konta. Część usług zewnętrznych (bramki płatności, integracje bankowe) nie umie tego skonfigurować - potrzebują jednego, stałego adresu, niezależnego od tego, na jakim koncie i pod jaką domeną działa Connect. Do tego służy Globalny kod dostępu.

W aplikacji

Gdzie to znajdziesz

Konektory→wybrany konektor→Edytuj

Jak to działa

W opcjach dodatkowych edycji konektora wpisz (albo wygeneruj) wartość w polu Globalny kod dostępu. Usłudze zewnętrznej podajesz wtedy adres w postaci:

https://<domena-systemu>/connect/connector/global/<globalny-kod-dostępu>/<nazwa-akcji>

System znajduje po tym kodzie właściwy konektor niezależnie od tego, z jakiej domeny przyszło żądanie - nie trzeba go kierować pod subdomenę konkretnego konta. To dokładnie ten mechanizm, z którego korzystają gotowe integracje wymagające jednego stałego adresu callback (np. część bramek płatności).

Co widać po drugiej stronie

Żądania przychodzące tym adresem loguje się tak samo, jak przy zwykłym wywołaniu - włącz Loguj żądania i sprawdzaj Requesty na karcie konektora, dokładnie jak opisuje Podgląd żądań przychodzących.

Informacja

Nazwa akcji (<nazwa-akcji> w adresie) musi być jedną z obsługiwanych przez wybrany rodzaj konektora - przy gotowych rodzajach (płatności, integracje bankowe) to gotowa, udokumentowana wartość. Przy własnym konektorze sam adres da się wywołać i zobaczyć w Requestach, ale żeby żądanie faktycznie coś uruchomiło (np. wystartowało flow), potrzebna jest dodatkowa konfiguracja po stronie systemu - w razie wątpliwości skontaktuj się z opiekunem konta.

Bezpieczeństwo

Globalny kod dostępu działa jak hasło do tego adresu - kto go zna, ten może wywołać konektor bez logowania. Traktuj go jak sekret: nie publikuj w miejscach dostępnych publicznie, a przy podejrzeniu wycieku wygeneruj i wpisz nową wartość.

Czy ten wpis był pomocny?

Komentarze