Za pomocą łącznika żądań HTTP możesz używać poleceń w łańcuchu do wykonywania żądań protokołu transferu hipertekstu (HTTP) GET, POST, PUT i DELETE do danego adresu URL. Możesz na przykład użyć tego konektora w łańcuchu, aby połączyć i zautomatyzować inne rozwiązania za pomocą ich odpowiednich konektorów.
Aby zobaczyć strukturę żądania HTTP, zapoznaj się z naszą przykładową listą konektorów HTTP .
Uwaga: Chociaż jest to oznaczone jako żądanie HTTP, HTTPS (bezpieczny HTTP) jest obsługiwany (i zalecany).
Wymagania
- Chociaż połączenie nie ma funkcji specyficznych dla OData, możesz dodać wszelkie niezbędne komponenty żądania za pomocą parametrów Headers lub Query string.
- Aby udostępnić łącznik do użytku w sieciach Twojej organizacji, administrator bezpieczeństwa org musi go najpierw włączyć.
Skonfiguruj łącznik żądań HTTP
- Na stronie Chain Builder kliknij Connections, a następnie Create w prawym górnym rogu.
- W sekcji Connector Connection wybierz HTTP Request i domyślny CloudRunner.
- W sekcji Basic Info wprowadź unikalną nazwę i opis, które pomogą zidentyfikować złącze.
- Wybierz środowiska, w których ma być używane połączenie i kliknij Zapisz.
- Aby przetestować połączenie, utwórz i uruchom łańcuch z poleceniem GET konektora i sprawdź, czy zwraca prawidłowe dane wyjściowe.
Zarządzaj poświadczeniami dla bezpiecznych żądań HTTP
Aby zabezpieczyć żądania HTTP konektora, możesz skonfigurować jego polecenia za pomocą:
- Podstawowe uwierzytelnianie za pomocą nazwy użytkownika i hasła
-
Certyfikaty zakodowane w standardzie PEM (Privacy-Enhanced Mail), np. do wzajemnego uwierzytelniania Transport Layer Security (mTLS)
Uwaga: Workiva nie generuje certyfikatów dla żądań HTTP. Aby korzystać z certyfikatów zakodowanych w PEM, podaj parę kluczy publicznych/prywatnych do wysłania wraz z żądaniami i opcjonalnym certyfikatem urzędu certyfikacji (CA).
Aby skonfigurować polecenie z poświadczeniami:
- W Chain Builder, prześlij certyfikaty jako zasoby obszaru roboczego.
- Po skonfigurowaniu polecenia konektora wybierz certyfikaty jako właściwości:
- W celu podstawowego uwierzytelnienia wprowadź lub wybierz dane uwierzytelniające w Nazwa użytkownika i Hasło.
- Dla pary kluczy publiczny/prywatny wybierz ich zasoby odpowiednio w Certyfikat i Klucz prywatny certyfikatu.
- W przypadku opcjonalnego certyfikatu CA, wybierz jego zasób na stronie CA certificate.
Rozwiązywanie problemów
- Jeśli zwrócony zostanie błąd, sprawdź źródłowy adres URL i strukturę żądania. Nasz Przykłady konektorów HTTP artykuł szczegółowo opisuje każdy wymagany komponent.
- Sprawdź, czy ciąg zapytania jest zakodowany.