Met de HTTP Request-connector kunt u opdrachten in een keten gebruiken om HTTP-verzoeken (hypertext transfer protocol) GET, POST, PUT en DELETE naar een bepaalde URL uit te voeren. U kunt deze connector bijvoorbeeld in een keten gebruiken om andere oplossingen via hun respectieve connectors te verbinden en te automatiseren.
Om te zien hoe een HTTP Request is opgebouwd, kunt u onze HTTP Connector voorbeeldlijst bekijken.
Opmerking: Hoewel dit gelabeld is als HTTP Request, wordt HTTPS (Secure HTTP) ondersteund (en aanbevolen).
Vereisten
- Hoewel de verbinding geen OData-specifieke functies heeft, kunt u alle noodzakelijke componenten van het verzoek toevoegen via de parameters Headers of Query string.
- Om de connector beschikbaar te maken voor gebruik in de ketens van uw organisatie, moet een beveiligingsbeheerder van org deze eerst inschakelen.
De HTTP Request-connector instellen
- Ga naar Chain Builder, klik op Connections, en vervolgens op Create rechtsboven.
- Selecteer onder Connector Connection HTTP Request en de standaard CloudRunner.
- Voer onder Basisinfo een unieke naam en beschrijving in om de connector te helpen identificeren.
- Selecteer de omgevingen om de verbinding te gebruiken en klik op Opslaan.
- Om de verbinding te testen, maakt een ketting aan en voert deze uit met de GET opdracht van de connector, en controleert of deze een geldige uitvoer retourneert.
Beheer referenties voor beveiligde HTTP-aanvragen
Om de HTTP-verzoeken van de connector te beveiligen, kunt u de commando's instellen met:
- Basisverificatie met gebruikersnaam en wachtwoord
-
PEM-gecodeerde certificaten (Privacy-Enhanced Mail), zoals voor wederzijdse verificatie via Transport Layer Security (mTLS)
Opmerking: Workiva genereert geen certificaten voor HTTP-verzoeken. Om PEM-gecodeerde certificaten te gebruiken, geeft u het publieke/private sleutelpaar op dat u met de aanvragen meestuurt en een optioneel certificaat van de certificeringsinstantie (CA).
Om een opdracht met referenties in te stellen:
- In Chain Builder, uploadt u de certificaten als werkruimtebronnen.
- Wanneer u de opdracht van de connector instelt, selecteert u de certificaten als eigenschappen:
- Voor basisverificatie voert u de referenties in Gebruikersnaam en Wachtwoord in of selecteert u deze.
- Voor het openbare/privésleutelpaar selecteert u hun bronnen in respectievelijk Certificaat en Certificaat privésleutel.
- Voor een optioneel CA-certificaat selecteert u de bron ervan in CA-certificaat.
Probleemoplossing
- Als er een fout wordt geretourneerd, controleer dan uw bron-URL en de structuur van uw aanvraag. In ons artikel HTTP connector voorbeelden vindt u details over elk vereist onderdeel.
- Controleer of uw querystring gecodeerd is.