Verificação do cliente OAuth

Os clientes do Google OAuth que solicitam determinados escopos confidenciais estão sujeitos à verificação do Google.

Se você não verificar o cliente OAuth do projeto de script, os usuários fora do seu domínio verão uma tela de app não verificado quando tentarem autorizar o script. Um fluxo de autorização não verificado permite que esses usuários autorizem e usem apps não verificados, mas somente após confirmarem que entendem os riscos. O número total de usuários não verificados do app também é limitado.

Para mais informações, consulte os seguintes artigos:

 

Tela do app não verificada
Figura 1: tela de app não verificada.
Fluxo de autorização de app não verificado
Figura 2: fluxo de autorização de app não verificado.

 

Essa mudança se aplica aos clientes da Web do Google OAuth, incluindo aqueles usados por todos os projetos do Apps Script. Ao verificar seu aplicativo com o Google, você pode remover a tela do aplicativo não verificado do fluxo de autorização e dar aos usuários a confiança de que seu aplicativo não é malicioso.

Apps não verificados

Complementos, apps da Web e outras implantações (como apps que usam a API Apps Script) podem precisar de verificação.

Aplicabilidade

Se o aplicativo usar escopos OAuth confidenciais, a tela do aplicativo não verificado poderá aparecer como parte do fluxo de autorização. A presença dele (e o fluxo de autorização de app não verificado resultante) depende da conta em que o app foi publicado e da conta que está tentando usá-lo. Por exemplo, os apps publicados em uma organização específica do Google Workspace não resultam no fluxo de autorização de app não verificado para contas nesse domínio, mesmo que o app não tenha sido verificado.

A tabela a seguir ilustra quais situações resultam no fluxo de autorização do app não verificado:

O cliente é verificado O editor é uma conta do Google Workspace do cliente A O script está em um drive compartilhado do cliente A O editor é uma conta do Gmail
O usuário é uma conta do Google Workspace do cliente A Fluxo de autenticação normal Fluxo de autenticação normal Fluxo de autenticação normal Fluxo de autenticação não verificado
O usuário é uma conta do Google Workspace não do cliente A Fluxo de autenticação normal Fluxo de autenticação não verificado Fluxo de autenticação não verificado Fluxo de autenticação não verificado
O usuário tem uma conta do Gmail1 Fluxo de autenticação normal Fluxo de autenticação não verificado Fluxo de autenticação não verificado Fluxo de autenticação não verificado

1Qualquer conta do Gmail, incluindo a conta usada para publicar o app.

Limite de usuários

O número de usuários que podem autorizar um app por meio do fluxo de app não verificado é limitado para limitar possíveis abusos. Consulte os limites de usuários do aplicativo OAuth para mais detalhes.

Solicitando verificação

É possível solicitar uma verificação do cliente OAuth usado pelo app e pelo projeto do Cloud Platform (GCP) associado. Depois que seu app for verificado, os usuários não verão mais a tela do app não verificado. Além disso, o app não estará mais sujeito ao limite de usuários.

Requisitos

Para enviar o cliente OAuth para verificação, você precisa atender aos seguintes requisitos:

  1. Você precisa ter um site em um domínio. O site precisa hospedar páginas acessíveis publicamente que descrevam seu app e a Política de Privacidade dele. Você também precisa confirmar sua propriedade do site com o Google.

  2. O projeto do Google Cloud que seu projeto de script usa precisa ser um projeto padrão do Google Cloud a que você tem acesso para editar. Se o script estiver usando o projeto padrão do Google Cloud, mude para um projeto padrão do Google Cloud.

Além disso, você precisa ter os seguintes recursos obrigatórios:

  • Nome do aplicativo. É o nome do app, que é exibido na tela de consentimento. Ele precisa corresponder ao nome usado para o app em outros locais, como a listagem de apps publicados do Google Workspace Marketplace.
  • Logotipo do aplicativo. Uma imagem do logotipo do app JPEG, PNG ou BMP para usar na tela de consentimento. O tamanho do arquivo deve ser de 1 MB ou menos.
  • E-mail de suporte. Esse é um e-mail exibido na tela de consentimento para que os usuários entrem em contato se precisarem de suporte para apps. Pode ser seu endereço de e-mail ou um Grupo do Google que você possui ou gerencia.
  • Escopos. A lista de todos os escopos usados pelo app. É possível conferir os escopos no editor do Apps Script.
  • Domínios autorizados: Essa é uma lista de domínios que contêm informações sobre seu app. Todos os links do app, como a página necessária da Política de Privacidade, precisam estar hospedados em domínios autorizados.
  • URL da página inicial do aplicativo. O local de uma página inicial que descreve seu app. Esse local precisa estar hospedado em um domínio autorizado.
  • URL da Política de Privacidade do aplicativo. O local da página que descreve a Política de Privacidade do app. Esse local precisa estar hospedado em um domínio autorizado.

Além dos recursos obrigatórios acima, você tem a opção de fornecer um URL dos Termos de Serviço do aplicativo que direcione para uma página com a descrição dos Termos de Serviço do app. Se fornecido, esse local precisa estar em um domínio autorizado.

Passos

  1. Verifique a propriedade de todos os domínios autorizados que você usa para hospedar a Política de Privacidade e outras informações do seu projeto de script, caso ainda não tenha feito isso. Os proprietários verificados dos domínios precisam ser editores ou proprietários do projeto de script.
  2. No projeto do Apps Script, clique em Visão geral . Em Escopos OAuth do projeto, copie os escopos usados pelo projeto de script.
  3. Preencha a tela de permissão OAuth para o projeto do Google Cloud do seu aplicativo usando os recursos de texto e URL coletados.

    1. Liste os domínios autorizados em que as informações do seu app (como a Política de Privacidade) estão hospedadas.
    2. Para adicionar os escopos do aplicativo, clique em Adicionar ou remover escopos. A caixa de diálogo resultante tenta detectar automaticamente os escopos das APIs ativadas no console do Google Cloud (como serviços avançados). Para selecionar escopos na lista, marque as caixas correspondentes.

      Essa lista detectada automaticamente nem sempre inclui escopos usados pelos serviços integrados do Apps Script. Insira esses escopos em Adicionar escopos manualmente.

      Quando terminar, clique em Atualizar.

  4. Depois de inserir todas as informações necessárias, clique em Salvar.

  5. Clique em Enviar para verificação para iniciar uma solicitação de verificação.

A maioria das solicitações de verificação recebe uma resposta dentro de 24 a 72 horas. Você pode conferir o Status da verificação na parte superior do formulário da tela de consentimento do OAuth. Quando a verificação do cliente OAuth for confirmada, seu app será verificado.