Validation des clients OAuth

Les clients Google OAuth qui demandent certains champs d'application OAuth sensibles sont soumis à la validation de Google.

Si vous ne validez pas le client OAuth de votre projet de script, les utilisateurs extérieurs à votre domaine voient un écran Application non validée lorsqu'ils tentent d'autoriser votre script. Un flux d'autorisation non validée permet à ces utilisateurs d'autoriser des applications non validées et de les utiliser, mais uniquement après avoir confirmé qu'ils comprennent les risques. Le nombre total d'utilisateurs de l'application non validés est également plafonné.

Pour en savoir plus, consultez les articles suivants :

 

Écran "Application non validée"
Figure 1: Écran de l'application non validée
Flux d'autorisation d'application non validée
Figure 2: Flux d'autorisation d'application non validée

 

Cette modification s'applique aux clients Web Google OAuth, y compris ceux utilisés par tous les projets Apps Script. En validant votre application auprès de Google, vous pouvez supprimer l'écran de l'application non validée de votre flux d'autorisation et rassurer les utilisateurs que votre application n'est pas malveillante.

Applications non validées

Les modules complémentaires, les applications Web et autres déploiements (tels que les applications utilisant l'API Apps Script) peuvent nécessiter une vérification.

Applicabilité

Si l'application utilise des champs d'application OAuth sensibles, l'écran "Application non validée" peut s'afficher dans le flux d'autorisation. Sa présence (et le flux d'autorisation d'application non validé qui en résulte) dépend du compte à partir duquel l'application est publiée et du compte qui tente de l'utiliser. Par exemple, les applications publiées dans une organisation Google Workspace spécifique n'entraînent pas le flux d'autorisation d'application non validée pour les comptes de ce domaine, même si l'application n'a pas été validée.

Le tableau suivant illustre les situations qui entraînent le flux d'autorisation d'application non validée:

Client validé L'éditeur est un compte Google Workspace du client A Le script se trouve dans un Drive partagé du client A L'éditeur est un compte Gmail
L'utilisateur est un compte Google Workspace du client A Flux d'authentification normal Flux d'authentification normal Flux d'authentification normal Parcours d'authentification non validé
L'utilisateur est un compte Google Workspace pas du client A Flux d'authentification normal Parcours d'authentification non validé Parcours d'authentification non validé Parcours d'authentification non validé
L'utilisateur est un compte Gmail1 Flux d'authentification normal Parcours d'authentification non validé Parcours d'authentification non validé Parcours d'authentification non validé

1 Tout compte Gmail, y compris celui utilisé pour publier l'application

Limite d'utilisateurs

Le nombre d'utilisateurs pouvant autoriser une application via le parcours d'application non validé est limité afin de limiter les éventuels abus. Pour en savoir plus, consultez la section Limites utilisateur des applications OAuth.

Demande de validation...

Vous pouvez demander la validation du client OAuth utilisé par votre application et du projet Cloud Platform (GCP) associé. Une fois votre application validée, vos utilisateurs ne verront plus l'écran "Application non validée". En outre, votre application ne sera plus soumise à la limite d'utilisateurs.

Conditions requises

Pour envoyer votre client OAuth pour validation, vous devez remplir les conditions suivantes:

  1. Vous devez être propriétaire d'un site Web sur un domaine. Le site doit héberger des pages accessibles au public qui décrivent votre application et ses règles de confidentialité. Vous devez également confirmer que vous êtes le propriétaire du site auprès de Google.

  2. Le projet Google Cloud utilisé par votre projet de script doit être un projet Google Cloud standard pour lequel vous disposez d'un accès en écriture. Si votre script utilise son projet Google Cloud par défaut, vous devez passer à un projet Google Cloud standard.

En outre, vous devez disposer des assets obligatoires suivants:

  • Nom de l'application : Nom de l'application, qui s'affiche sur l'écran de consentement. Il doit correspondre au nom utilisé pour l'application à d'autres emplacements, tels que la fiche Google Workspace Marketplace pour les applications publiées.
  • Logo de l'application : Un logo d'application JPEG, PNG ou BMP à utiliser sur l'écran de consentement. La taille du fichier ne doit pas dépasser 1 Mo.
  • Adresse e-mail d'assistance. Il s'agit d'un e-mail affiché sur l'écran de consentement que les utilisateurs peuvent contacter s'ils ont besoin d'aide pour l'application. Il peut s'agir de votre adresse e-mail ou d'un groupe Google que vous possédez ou gérez.
  • Champs d'application : Liste de tous les champs d'application utilisés par votre application. Vous pouvez afficher vos champs d'application dans l'éditeur Apps Script.
  • Domaines autorisés : Il s'agit d'une liste de domaines contenant des informations sur votre application. Tous les liens associés à votre application (comme la page des règles de confidentialité requises) doivent être hébergés sur des domaines autorisés.
  • URL de la page d'accueil de l'application : Emplacement d'une page d'accueil décrivant votre application. Cet emplacement doit être hébergé sur un domaine autorisé.
  • URL des règles de confidentialité de l'application. Emplacement d'une page décrivant les règles de confidentialité de votre application. Cet emplacement doit être hébergé sur un domaine autorisé.

En plus des éléments obligatoires ci-dessus, vous pouvez éventuellement fournir une URL des conditions d'utilisation de l'application qui redirige vers une page décrivant les conditions d'utilisation de votre application. S'il est fourni, cet emplacement doit faire partie d'un domaine autorisé.

Étapes

  1. Si vous ne l'avez pas déjà fait, validez la propriété de tous les domaines autorisés que vous utilisez pour héberger les règles de confidentialité et d'autres informations de votre projet de script. Les propriétaires confirmés des domaines doivent être des éditeurs ou le propriétaire du projet de script.
  2. Dans le projet Apps Script, cliquez sur Overview (Aperçu) . Sous Champs d'application OAuth du projet, copiez les champs d'application utilisés par votre projet de script.
  3. Complétez l'écran de consentement OAuth pour le projet Google Cloud de votre application en utilisant les éléments de texte et d'URL que vous avez collectés.

    1. Répertoriez les domaines autorisés sur lesquels les informations de votre application (telles que ses règles de confidentialité) sont hébergées.
    2. Pour ajouter des habilitations d'application, cliquez sur Ajouter ou supprimer des habilitations. La boîte de dialogue qui s'affiche tente de détecter automatiquement les champs d'application des API que vous avez activées dans la console Google Cloud (telles que les services avancés). Vous pouvez sélectionner des niveaux d'accès dans cette liste en cochant les cases correspondantes.

      Cette liste détectée automatiquement n'inclut pas toujours les champs d'application utilisés par les services intégrés Apps Script. Vous devez les saisir sous Ajouter manuellement des champs d'application.

      Lorsque vous avez terminé, cliquez sur Mettre à jour.

  4. Après avoir saisi toutes les informations requises, cliquez sur Enregistrer.

  5. Cliquez sur Envoyer pour validation pour lancer une demande de validation.

La plupart des demandes de validation reçoivent une réponse sous 24 à 72 heures. Vous pouvez vérifier l'état de validation en haut du formulaire de l'écran de consentement OAuth. Une fois la validation de votre client OAuth confirmée, votre application est validée.