Con il connettore HTTP Request, puoi usare i comandi in una catena per eseguire richieste HTTP (Hypertext Transfer Protocol) GET, POST, PUT e DELETE a un determinato URL. Ad esempio, puoi utilizzare questo connettore in una catena per connettere e automatizzare altre soluzioni attraverso i rispettivi connettori.
Per vedere come è strutturata una richiesta HTTP, consulta il nostro elenco di esempi di Connettori HTTP .
Nota: Sebbene questa sia etichettata come richiesta HTTP, l'HTTPS (Secure HTTP) è supportato (e consigliato).
Requisiti
- Sebbene la connessione non abbia caratteristiche specifiche di OData, puoi aggiungere tutti i componenti necessari della richiesta tramite i parametri Headers o Query string.
- Per rendere il connettore disponibile per l'uso nelle catene della tua organizzazione, un amministratore della sicurezza di org deve prima abilitarlo.
Configura il connettore HTTP Request
- Da Chain Builder, clicca su Connections , e poi su Create in alto a destra.
- In Connector Connection, seleziona HTTP Request e il CloudRunner predefinito.
- In Informazioni di base, inserisci un nome e una descrizione unici per identificare il connettore.
- Seleziona gli ambienti da utilizzare per la connessione e clicca su Salva.
- Per testare la connessione, crea ed esegui una catena con il comando GET del connettore e verifica che restituisca un output valido.
Gestisci le credenziali per le richieste HTTP sicure
Per proteggere le richieste HTTP del connettore, puoi impostare i suoi comandi con:
- Autenticazione di base con nome utente e password
-
Certificati codificati Privacy-Enhanced Mail (PEM), come ad esempio per l'autenticazione reciproca Transport Layer Security (mTLS)
Nota: Workiva non genera certificati per le richieste HTTP. Per utilizzare certificati codificati PEM, fornisci la coppia di chiavi pubbliche/private da inviare con le richieste e un certificato opzionale dell'Autorità di Certificazione (CA).
Per impostare un comando con credenziali:
- In Chain Builder, carica i certificati come risorse dell'area di lavoro.
- Quando imposti il comando del connettore, seleziona i certificati come proprietà:
- Per l'autenticazione di base, inserisci o seleziona le credenziali in Nome utente e Password.
- Per la coppia di chiavi pubbliche/private, seleziona le risorse in Certificato e Certificato chiave privata, rispettivamente.
- Per un certificato CA opzionale, seleziona la risorsa in Certificato CA.
Risoluzione dei problemi
- Se viene restituito un errore, rivedi l'URL di origine e la struttura della tua richiesta. Il nostro articolo Esempi di connettore HTTP illustra in dettaglio ogni componente richiesto.
- Controlla che la stringa di query sia codificata.