OAuth 2.0 is een autorisatieprotocol dat toepassingen in staat stelt om gebruikersgegevens van andere services te benaderen zonder de inloggegevens van de gebruiker te delen. Het stelt gebruikers in staat om veilig beperkte toegang tot hun bronnen op de ene service aan een ander programma te verlenen.

Dit verbindingsprogramma stelt je in staat om statische REST-geverifieerde verbindingen te configureren die je op andere onderdelen van het platform opnieuw kunt gebruiken waar een REST-verbinding met de verbonden REST API-service vereist is.

Wat is OAuth 2.0?

OAuth 2.0, wat staat voor “Open Authorization”, is een standaard die ontworpen is om een website of toepassing in staat te stellen om bronnen te benaderen die door andere web-apps worden gehost namens een gebruiker. Het verving OAuth 1.0 in 2012 en is nu de de facto industriestandaard voor onlineautorisatie. OAuth 2.0 biedt toegestane toegang en beperkt de acties van de client-app op bronnen namens de gebruiker zonder ooit de inloggegevens van de gebruiker te delen.

Waarom is een verbinding vereist?

Een verbinding is vereist om TaskForm in staat te stellen om met je OAuth 2.0-account te communiceren voordat je formulierverbindingsprogramma’s kunt toevoegen om gegevens te pushen of gegevens met gegevensbronverbindingsprogramma’s van andere platforms te pullen.

• Rest-veld
• Rest-formulierverbinding
• Rest-gegevensbronverbinding
• REST externe gebruikersverbinding

Een REST-verbinding toevoegen

Het Data Hub-gedeelte van het platform is waar je verbindingen voor verbindingsprogramma’s kunt toevoegen. Navigeer het bijmenulabel naar Data Hub > Verbindingen.

Op de pagina Verbindingen:

• Klik op de knop VERBINDING TOEVOEGEN in de rechterbovenhoek om een lijst met verbindingen weer te geven.
• Klik op de optie REST.

Authenticatie

Zodra je de REST-verbinding hebt toegevoegd, kun je een reguliere Auth Request-verbinding of een OAuth 2.0-verbinding configureren die opnieuw kan worden gebruikt door elk ander formulier dat dezelfde verbinding vereist.

Je kunt selecteren welke verificatiemethode je REST-verbinding zal ondersteunen door de geschikte methode te selecteren, zoals weergegeven in de bovenstaande schermafbeelding.

Een Auth Request-verbinding toevoegen

Met deze optie kun je een REST-verbinding configureren die gebruikmaakt van API-sleutelgebaseerde verificatie, basisverificatie of verificatie op basis van tokens. Je kunt deze verificatiemethoden hier configureren voor hergebruik op andere formulieren of gegevensbronverbindingsprogramma’s die je wilt gebruiken.

Doel-URL

Voer de URL van de aanvraagbestemming in.

Als je een deel van deze URL wilt vervangen door de Global Forms REST URL, kun je de {{GLOBAL}}-placeholder gebruiken. bijvoorbeeld {{GLOBAL}}/api/endpoint

Headers

Geef aangepaste aanvraagheaders op die in alle aanvragen met deze verbinding worden opgenomen.

Body

Geef bij het tot stand brengen van verificatie de aanvraagpayload op die met POST/PUT/PATCH-aanvragen moet worden verzonden.

Je kunt waarden uit het antwoord van de Auth Request-stap ($response) in de body invoegen door formulefuncties zoals JSONVAL(), JSONLIST(), XMLVAL() of XMLLIST() te gebruiken.
bijvoorbeeld {(JSONVAL($response, ‘path.to.property’))}

Het bovenstaande antwoord gebruiken in headers/queryparameters hieronder

Het resultaat van de REST-stap hierboven wordt geretourneerd als $response voor gebruik in de verbindingsheaders en queryparameters.

Benader eigenschappen of lijsten met elementen uit JSON-antwoorden via de formulefuncties JSONVAL() en JSONLIST().

Gebruik op dezelfde manier voor XML-antwoorden XMLVAL() en XMLLIST().

bijvoorbeeld {(JSONVAL($response, ‘path.to.property’))}

Query-parameters

Geef aangepaste queryparameters op die in de URL van alle GET-aanvragen met deze verbinding worden opgenomen.

Een OAuth 2.0-verbinding toevoegen

Zodra je de optie hebt geselecteerd om een OAuth 2.0-verbinding toe te voegen, vul je de vereiste eigenschappen in en slaat je op. Dit zal de interface opnieuw laden met een knop Autoriseren die je moet indrukken om je aan te melden bij de service van derden en de verbinding te autoriseren zodat ons platform gegevens naar of van je account kan pushen of pullen.

Auth Code Request

Voeg alle queryparameters toe die nodig zijn voor een codeverzoek. We voegen automatisch de parameters response_type=code en redirect_uri aan het verzoek toe.

Token URL

Voer de URL in die wordt gebruikt om de autorisatiecode om te wisselen voor een toegangstoken. Voorbeeld: https://some-service.example/oauth2/token

Token Request

Voeg alle queryparameters toe die nodig zijn voor een tokenverzoek. We voegen automatisch de redirect_uri, grant_type=authorization_code en code parameters van het verzoek toe.

Callaback URL

De REST-service roept de URL terug zodra de authenticatie succesvol is.

https://secure.taskform.com/oauth2/restcallback

Het OAuth2.0 toegangstoken wordt automatisch in headers opgenomen

Een ‘Authorization: Bearer *****‘ header wordt opgenomen in alle verzoeken die deze verbinding gebruiken

Als je verbinding succesvol is geverifieerd, verandert het rode blok met Cannot Connect in groen en toont Connected. Op dit moment is je REST-verbinding klaar voor gebruik in je formulieren en gegevensbronnen.