OpenAPI Google Cloud | Comptes de service

Pour utiliser les composants OpenAPI Google Cloud et s'authentifier à l'aide de comptes de service, vous devez d'abord obtenir le certificat de clé privée depuis Google Cloud.

 

Retrouvez ci-dessous les étapes pour obtenir le certificat de clé privée Google et comment le configurer dans notre exemple d'application.

 

Commencez par vous connecter à votre compte Google Cloud et utilisez un projet existant ou créez-en un nouveau.

 

 

Sélectionnez CREATE SERVICE ACCOUNT et une nouvelle page s'affichera dans laquelle vous devrez définir le nom et la description du compte de service.

 

 

Sélectionnez ensuite au moins un rôle ; je sélectionne PubSub Admin pour permettre au client de publier et de s'abonner à des topics, mais vous pouvez choisir un autre rôle avec moins de privilèges.

 

 

Appuyez sur CONTINUER et enfin vous pouvez accorder l'accès à d'autres utilisateurs

 

 

Appuyez sur DONE lorsque vous avez terminé et un nouvel enregistrement sera affiché

 

 

L'étape suivante consiste à créer une nouvelle clé, sélectionnez donc l'option Créer une clé dans la colonne des actions. Sélectionnez JSON pour télécharger la configuration au format JSON et une nouvelle clé sera créée

 

 

Il vous suffit enfin de renseigner les données fournies par Google dans le client OpenAPI PubSub. Vous pouvez utiliser LoadSettingsFromFile pour charger le fichier JSON de configuration.

 

 

 

Délégation à l'échelle du domaine

Si vous disposez d'un compte Google Workspace, un administrateur de l'organisation peut autoriser une application à accéder aux données des utilisateurs au nom des utilisateurs du domaine Google Workspace. Par exemple, une application utilisant l'API Google Calendar pour ajouter des événements aux calendriers de tous les utilisateurs d'un domaine Google Workspace utiliserait un compte de service pour accéder à l'API Google Calendar au nom des utilisateurs. L'autorisation d'un compte de service à accéder aux données au nom des utilisateurs d'un domaine est parfois appelée « délégation d'autorité à l'échelle du domaine » à un compte de service.

 

Pour déléguer l'autorité à l'échelle du domaine à un compte de service, un super administrateur du domaine Google Workspace doit effectuer les étapes suivantes :

 

• Depuis la console d'administration de votre domaine Google Workspace, accédez à Menu principal > Sécurité > Accès et Contrôle des données > Contrôles API.
• Dans le volet Délégation à l'échelle du domaine, sélectionnez Gérer la délégation à l'échelle du domaine.
• Cliquez sur Ajouter nouveau.
• Dans le champ Client ID, entrez l'ID client du compte de service. Vous pouvez trouver l'ID client de votre compte de service dans la page Comptes de service.
• Dans le champ Portées OAuth (séparées par des virgules), saisissez la liste des portées auxquelles votre application doit avoir accès. Par exemple, si votre application a besoin d'un accès complet à l'échelle du domaine à l'API Google Drive et à l'API Google Calendar, saisissez : https://www.googleapis.com/auth/drive, https://www.googleapis.com/auth/calendar.
• Cliquez sur Autoriser.

 

Une fois que vous avez lié et autorisé le compte workspace, configurez la propriété GoogleOptions.ServiceAccountOptions depuis le client OpenAPI :

 

• Subject : est le compte e-mail de l'espace de travail lié au compte de service. Exemple : votreemail@domaine.com
• Scopes : liste des scopes. Exemple : https://www.googleapis.com/auth/calendar
• TokenURI : par défaut https://oauth2.googleapis.com/token.