Vanaf sgcWebSockets 4.3.4 wordt OAuth2 ondersteund. Google biedt toegang tot deze API's via OAuth2-authenticatie, dus eerst moet je de OAuth2 Client ID en Client Secret verkrijgen voordat je verbinding kunt maken met Google-diensten.
sgcWebSockets gebruikt een standaard-webbrowser om een nieuwe autorisatiecode aan te vragen. Als er een refresh-token wordt verstrekt, wordt het access-token automatisch bijgewerkt.
OAuth2-credentials verkrijgen
Om de OAuth2 Client Id en Client Secret te krijgen:
- Ga naar https://console.cloud.google.com/apis/dashboard
- Selecteer een bestaand project of maak een nieuw aan.
- Selecteer na het aanmaken Apis and Services / Credentials.
- Druk op de pagina Credentials op Create Credentials / OAuth Client ID.
- Zodra de OAuth2-credentials zijn aangemaakt, verschijnt er een dialoogvenster met Client Id en Client Secret. Deze waarden zijn nodig voor het TsgcHTTP_OAuth2-component.
In het menu OAuth Consent Screen kun je configureren hoe het OAuth-protocol gaat werken. Voor testdoeleinden hoef je de standaardconfiguratie niet aan te passen; houd er wel rekening mee dat je van Google een waarschuwing krijgt dat je toepassing niet is geverifieerd.
Configuratievoorbeeld
Als je toegang wilt tot de GMail-toepassing met ons TsgcHTTP_OAuth2-component, kun je het OAuth2-voorbeeldprogramma in de map Demo/OAuth2 bekijken.
Je hoeft alleen een nieuwe API te maken en de Client Id en Client Secret die door Google worden geretourneerd te gebruiken om een access-token te krijgen dat later kan worden gebruikt om verbinding te maken met de GMail-API
Zodra de Google API-sleutel is uitgegeven, kopieer je de Client Id en Client Secret en plak je ze in ClientId en Secret van het demo-voorbeeldprogramma. Druk daarna op New Access Token en er wordt een nieuwe webbrowser-pagina getoond waarin de gebruiker wordt gevraagd om GMail-toegang goed te keuren. Bij succes wordt een nieuw access-token geretourneerd, zoals te zien is in de volgende screenshot.
