Lorsque vous utilisez OAuth 2.0 pour l'autorisation, Google présente à l'utilisateur un écran de consentement comprenant un résumé de votre projet, de ses règles et des champs d'application d'autorisation demandés. La configuration de l'écran de consentement OAuth de votre application définit ce qui s'affiche pour les utilisateurs et les examinateurs d'applications, et enregistre votre application pour que vous puissiez la publier ultérieurement.
Pour définir le niveau d'accès accordé à votre application, vous devez identifier et déclarer des champs d'application d'autorisation. Un champ d'application d'autorisation est une chaîne d'URI OAuth 2.0 contenant le nom de l'application Google Workspace, le type de données auquel elle accède et le niveau d'accès. Les champs d'application correspondent aux demandes d'utilisation des données Google Workspace par votre application, y compris les données des comptes Google des utilisateurs.
Lorsque votre application est installée, l'utilisateur est invité à valider les champs d'application utilisés par l'application. En règle générale, vous devez choisir le champ d'application le plus précis possible et éviter de demander des champs d'application dont votre application n'a pas besoin. Les utilisateurs accordent plus facilement l'accès à des champs d'application limités et clairement décrits.
Toutes les applications utilisant OAuth 2.0 nécessitent une configuration d'écran de consentement, mais vous ne devez répertorier que les champs d'application des applications utilisées par des personnes externes à votre organisation Google Workspace.
Conseil:Si vous ne connaissez pas les informations requises sur l'écran de consentement, vous pouvez utiliser les informations d'espace réservé avant la libération.
Configurer le consentement OAuth
- Dans la console Google Cloud, accédez à Menu > API et services > Écran de consentement OAuth.
- Sélectionnez le type d'utilisateur de votre application, puis cliquez sur Créer.
- Remplissez le formulaire d'enregistrement de l'application, puis cliquez sur Enregistrer et continuer.
Si vous créez une application pour une utilisation en dehors de votre organisation Google Workspace, cliquez sur Ajouter ou supprimer des champs d'application. Nous vous recommandons de suivre les bonnes pratiques suivantes lorsque vous sélectionnez des champs d'application:
- Sélectionnez les champs d'application fournissant le niveau d'accès minimal requis par votre application. Pour obtenir la liste des champs d'application disponibles, consultez Champs d'application OAuth 2.0 pour les API Google.
- Examinez les champs d'application répertoriés dans chacune des trois sections: champs d'application non sensibles, champs d'application sensibles et champs d'application restreints. Pour les champs d'application listés dans les sections "Vos champs d'application sensibles" ou "Vos champs d'application restreints", essayez d'identifier d'autres champs d'application non sensibles afin d'éviter des examens supplémentaires inutiles.
- Certaines portées nécessitent un examen supplémentaire de la part de Google. Pour les applications utilisées uniquement en interne par votre organisation Google Workspace, les champs d'application ne figurent pas sur l'écran de consentement. De plus, l'utilisation de champs d'application sensibles ou restreints ne nécessite pas d'examen supplémentaire de la part de Google. Pour en savoir plus, consultez la section Catégories de champs d'application.
- Après avoir sélectionné les champs d'application requis par votre application, cliquez sur Enregistrer et continuer.
- Si vous avez sélectionné le type d'utilisateur Externe, ajoutez des utilisateurs tests :
- Sous Utilisateurs test, cliquez sur Ajouter des utilisateurs.
- Saisissez votre adresse e-mail et tout autre utilisateur de test autorisé, puis cliquez sur Enregistrer et continuer.
- Consultez le récapitulatif d'enregistrement de votre application. Pour apporter des modifications, cliquez sur Modifier. Si l'enregistrement de l'application semble correct, cliquez sur Retour au tableau de bord.
Catégories de portée
Certains champs d'application nécessitent des examens et des exigences supplémentaires en raison du niveau ou du type d'accès qu'ils accordent. Prenons l'exemple des types de champs d'application suivants:
Validation de base des applications requise | Une validation supplémentaire de l'application est requise | Évaluation de sécurité requise | |||
---|---|---|---|---|---|
Champs d'application non sensibles (recommandé) | N'accorder l'accès qu'aux données limitées qui sont immédiatement pertinentes pour une action spécifique | — | — | ||
Champs d'application sensibles | accorder l'accès aux données, ressources ou actions personnelles des utilisateurs ; | — | |||
Champs d'application restreints | accorder l'accès à des données ou à des actions utilisateur très sensibles ou étendues ; |
Étape suivante
Créez des identifiants d'accès pour votre application.