Zarządzanie webhookami
Szablony webhooków w programie ManageEngine ADManager Plus umożliwiają tworzenie szablonu do konfigurowania punktów końcowych REST API, nagłówków, parametrów, typu akcji i wiadomości, które następnie można dodać do szablonów orkiestracyjnych jako bloki. Historia webhooków pozwala na pobranie szczegółów webhooków, takich jak powiązany szablon orkiestracyjny oraz monitorowanie zmian, co umożliwia wykrywanie anomalii.
Kroki do stworzenia nowego szablonu webhooka
- Zaloguj się do ADManager Plus jako administrator.
- Przejdź do Zakładka Automatyzacja → Konfiguracja → Szablon orkiestracji.
- Kliknij Konfiguruj webhook i wybierz Utwórz nowy szablon.
- Wprowadź odpowiednią nazwę i opis szablonu.
- W polu URL wprowadź wywołanie API. Odwołaj się do
ta notatka, aby dowiedzieć się, jak wykorzystać makra.
- W polu Autoryzacja wybierz dostosowaną aplikację związaną z wymaganą autoryzacją.
Uwaga: Aby dodać nowy typ autoryzacji, uwzględnij dostosowaną aplikację do tego i zastosuj ją w tej sekcji.
Kliknij tutaj, aby dowiedzieć się więcej o dodawaniu dostosowanej aplikacji.
- W polu Metoda wybierz jedną z następujących metod HTTP,
- Get: Aby odczytać
- Put: Aby zaktualizować lub zastąpić
- Post: Aby utworzyć
- Delete: Aby usunąć
- W polu Nagłówki możesz dodać wymagane nagłówki API i przypisać je do odpowiednich wartości nagłówków.
- Podobnie w polu Parametry możesz dodać odpowiednie parametry API i przypisać je do ich wartości parametrów.
- Wybierz odpowiednią opcję Typ wiadomości.
- Wybierz Testuj i Zapisz, aby sprawdzić wdrożenie webhooka w czasie rzeczywistym dla konkretnych użytkowników i grup, lub po prostu kliknij Zapisz.
Uwaga:
- Wykorzystaj makra w polach URL, Parametry, Nagłówki oraz Wiadomość, aby uzyskać dane oparte na obiektach. Dodaj makra z AD (w tym dostosowane atrybuty LDAP), Microsoft 365, zmienne środowiskowe i szczegóły akcji, wpisując % w celu zawężenia wyszukiwania wymaganego atrybutu. Alternatywnie, możesz kliknąć ikonę
i wybrać atrybut. Aby uzyskać dodatkowe informacje na temat tworzenia zmiennej środowiskowej, kliknij tutaj.
- W polach wartości wprowadź %% aby reprezentować symbol %.
- Aby uzyskać dostęp do makr specyficznych dla AD, wprowadź wartość w formacie %ad.attribute_name% (na przykład %ad.SamAccountName%).
- Aby uzyskać dostęp do makr specyficznych dla Microsoft 365, wprowadź wartość w formacie %m365.attribute_name% (na przykład %m365.UserPrincipalName%).
- Aby uzyskać dostęp do zmiennych środowiskowych jako makr, wprowadź wartość w formacie %env.attribute_name% (na przykład %env.ticketingtoolAuthToken%).
- Aby uzyskać dostęp do szczegółów akcji jako makr takich jak Czas znacznikowy lub Nazwisko technika, wprowadź wartość w formacie %act.Timestamp% lub %act.technician% (na przykład %act.timestamp_dd-MM-yy_current time%).