Med HTTP Request Connector kan du bruke kommandoer i en kjede for å utføre HTTP-forespørsler (Hypertext Transfer Protocol) GET, POST, PUT, og DELETE til en gitt URL. Du kan for eksempel bruke denne konnektoren i en kjede for å koble til og automatisere andre løsninger gjennom deres respektive konnektorer.
Hvis du vil se hvordan en HTTP-forespørsel er strukturert, kan du se eksempel på HTTP Connector.
Merk: Selv om dette er merket som HTTP-forespørsel, støttes (og anbefales) HTTPS (sikker HTTP).
Krav
- Tilkoblingen har ingen OData-spesifikke funksjoner, men du kan legge til alle nødvendige komponenter i forespørselen via Headers eller Query string parametere.
- For å gjøre koblingen tilgjengelig for bruk i organisasjonens kjeder, må en sikkerhetsadministrator på org først aktivere den.
Konfigurer HTTP-forespørselskoblingen
- Fra Chain Builder klikker du på Connections, og deretter Create øverst til høyre.
- Under Connector Connection velger du HTTP Request og standard CloudRunner.
- Under Basic Info angir du et unikt navn og en beskrivelse for å identifisere kontakten.
- Velg miljøene som skal bruke tilkoblingen, og klikk på Lagre.
- For å teste tilkoblingen kan du opprette og kjøre en kjede med -kontaktens GET -kommando, og kontrollere at den returnerer en gyldig utdata.
Administrer legitimasjon for sikre HTTP-forespørsler
For å sikre HTTP-forespørsler fra kontakten kan du konfigurere kommandoene med :
- Enkel autentisering med brukernavn og passord
-
PEM-kodede sertifikater (Privacy-Enhanced Mail), for eksempel for gjensidig Transport Layer Security (mTLS)-autentisering
Merk: Workiva genererer ikke sertifikater for HTTP-forespørsler. Hvis du vil bruke PEM-kodede sertifikater, må du oppgi det offentlige/private nøkkelparet som skal sendes med forespørsler, og et valgfritt sertifikat fra sertifikatutstederen (CA).
Slik konfigurerer du en kommando med legitimasjon:
- I Chain Builder, laster du opp sertifikatene som arbeidsområde-ressurser.
- Når du konfigurerer kommandoen for kontakten, velger du sertifikatene som egenskaper:
- For grunnleggende autentisering skriver du inn eller velger legitimasjon i Brukernavn og Passord.
- For det offentlige/private nøkkelparet velger du ressursene deres i henholdsvis Sertifikat og Sertifikat privat nøkkel.
- For et valgfritt CA-sertifikat velger du ressursen i CA-sertifikat.
Feilsøking
- Hvis du får en feilmelding, må du gå gjennom kildeadressen og strukturen i forespørselen. Artikkelen vår HTTP connector examples beskriver hver enkelt komponent som kreves.
- Kontroller at spørringsstrengen er kodet.