Verificación del cliente de OAuth

Los clientes de OAuth de Google que soliciten ciertos permisos de OAuth sensibles están sujetos a la verificación de Google.

Si no verificas el cliente de OAuth de tu proyecto de secuencia de comandos, los usuarios ajenos a tu dominio verán una pantalla de app no verificada cuando intenten autorizar la secuencia de comandos. Un flujo de autorización no verificado permite que estos usuarios autoricen apps no verificadas y las usen, pero solo después de confirmar que comprenden los riesgos. También se limita la cantidad total de usuarios de apps no verificados.

Para obtener más información, consulta los siguientes artículos:

 

Pantalla de app sin verificar
Figura 1: Pantalla de app sin verificar
Flujo de autorización de apps no verificado
Figura 2: Flujo de autorización de app no verificado

 

Este cambio se aplica a los clientes web de OAuth de Google, incluidos los que se usan en todos los proyectos de Apps Script. Si verificas tu app con Google, puedes quitar la pantalla de app no verificada de tu flujo de autorización y darles a los usuarios la confianza de que tu app no es maliciosa.

Apps sin verificar

Es posible que los complementos, las apps web y otras implementaciones (como las apps que usan la API de Apps Script) deban verificarse.

Aplicabilidad

Si la app usa permisos de OAuth sensibles, es posible que la pantalla de la app sin verificar aparezca como parte del flujo de autorización. Su presencia (y el flujo de autorización de apps no verificadas que se genera) depende de la cuenta desde la que se publica la app y de la cuenta que intenta usarla. Por ejemplo, las apps publicadas en una organización de Google Workspace específica no generan el flujo de autorización de apps no verificadas para las cuentas de ese dominio, incluso si la app no se verificó.

En la siguiente tabla, se ilustran las situaciones que generan el flujo de autorización de apps no verificadas:

Se verificó el cliente El publicador es una cuenta de Google Workspace del cliente A. La secuencia de comandos está en una unidad compartida del cliente A El publicador es una cuenta de Gmail
El usuario es una cuenta de Google Workspace del cliente A Flujo de autenticación normal Flujo de autenticación normal Flujo de autenticación normal Flujo de autenticación sin verificar
El usuario es una cuenta de Google Workspace no del cliente A Flujo de autenticación normal Flujo de autenticación no verificado Flujo de autenticación no verificado Flujo de autenticación sin verificar
El usuario es una cuenta de Gmail1 Flujo de autenticación normal Flujo de autenticación no verificado Flujo de autenticación no verificado Flujo de autenticación sin verificar

1Cualquier cuenta de Gmail, incluida la cuenta que se use para publicar la app

Límite de usuarios

La cantidad de usuarios que pueden autorizar una app a través del flujo de apps sin verificar está limitada para evitar posibles abusos. Para obtener más información, consulta Límites de usuarios de la aplicación de OAuth.

Cómo solicitar la verificación

Puedes solicitar una verificación del cliente de OAuth que usa tu app y el proyecto de Cloud Platform (GCP) asociado. Una vez que se verifique tu app, los usuarios ya no verán la pantalla de la app sin verificar. Además, tu app ya no estará sujeta al límite de usuarios.

Requisitos

Para enviar tu cliente de OAuth para su verificación, debes cumplir con los siguientes requisitos:

  1. Debes ser propietario de un sitio web en un dominio. El sitio debe alojar páginas con acceso público que describan tu app y su política de privacidad. También debes verificar la propiedad del sitio con Google.

  2. El proyecto de Google Cloud que usa tu proyecto de secuencia de comandos debe ser un proyecto de Google Cloud estándar al que tengas acceso de edición. Si tu secuencia de comandos usa su proyecto de Google Cloud predeterminado, debes cambiar a un proyecto de Google Cloud estándar.

Además, debes contar con los siguientes elementos obligatorios:

  • Nombre de la aplicación. Es el nombre de la app, que se muestra en la pantalla de consentimiento. Debe coincidir con el nombre que se usa para la app en otras ubicaciones, como la ficha de Google Workspace Marketplace para apps publicadas.
  • Logotipo de la aplicación. Una imagen del logotipo de la app en formato JPEG, PNG o BMP para usar en la pantalla de consentimiento Su tamaño debe ser de 1 MB o menos.
  • Correo electrónico de asistencia. Este es un correo electrónico que se muestra en la pantalla de consentimiento para que los usuarios se comuniquen si necesitan asistencia para la app. Puede ser tu dirección de correo electrónico o un grupo de Google que te pertenezca o administres.
  • Alcances. Es la lista de todos los alcances que usa tu app. Puedes ver tus alcances en el editor de Apps Script.
  • Dominios autorizados. Esta es una lista de dominios que contienen información sobre tu app. Todos los vínculos de tu aplicación (como la página de la política de privacidad obligatoria) deben estar alojados en dominios autorizados.
  • URL de la página principal de la aplicación: Es la ubicación de una página principal que describe tu app. Esta ubicación debe estar alojada en un dominio autorizado.
  • URL de la política de privacidad de la aplicación. Es la ubicación de una página que describe la política de privacidad de tu app. Esta ubicación debe estar alojada en un dominio autorizado.

Además de los recursos obligatorios mencionados anteriormente, puedes proporcionar de manera opcional una URL de las Condiciones del Servicio de la aplicación que dirija a una página en la que se describan las Condiciones del Servicio de la app. Si se proporciona, esta ubicación debe estar en un dominio autorizado.

Pasos

  1. Si aún no lo hiciste, verifica la propiedad de todos los dominios autorizados que usas para alojar la política de privacidad de tu proyecto de secuencia de comandos y otra información. Los propietarios verificados de los dominios deben ser editores o el propietario del proyecto de secuencia de comandos.
  2. En el proyecto Apps Script, haz clic en Descripción general . En Permisos de OAuth del proyecto, copia los permisos que usa tu proyecto de secuencia de comandos.
  3. Completa la pantalla de consentimiento de OAuth para el proyecto de Google Cloud de tu aplicación con los recursos de texto y URL que recopilaste.

    1. Enumera los dominios autorizados en los que se aloja la información de tu app (como su política de privacidad).
    2. Para agregar los alcances de tu aplicación, haz clic en Agregar o quitar alcances. El diálogo resultante intenta detectar automáticamente los permisos de las APIs que habilitaste en la consola de Google Cloud (como los servicios avanzados). Para seleccionar permisos de esta lista, marca las casillas correspondientes.

      Esta lista detectada automáticamente no siempre incluye los permisos que usan los servicios integrados de Apps Script. Debes ingresar estos permisos en Agregar permisos de forma manual.

      Cuando hayas terminado, haz clic en Actualizar.

  4. Cuando hayas ingresado toda la información requerida, haz clic en Guardar.

  5. Haz clic en Enviar para verificación para iniciar una solicitud de verificación.

La mayoría de las solicitudes de verificación reciben una respuesta en un plazo de 24 a 72 horas. Puedes consultar el Estado de verificación en la parte superior del formulario de la pantalla de consentimiento de OAuth. Cuando se confirma la verificación de tu cliente de OAuth, se verifica tu app.