Este guia mostra como garantir que seu aplicativo e as credenciais do usuário estejam seguros.
Concluir a verificação de apps OAuth
O escopo do OAuth 2.0 para a API Google Ads é classificado como um escopo restrito, o que significa que você precisa concluir o processo de verificação do app OAuth antes de colocar seu aplicativo em produção. Consulte a documentação do Google Identity, o artigo da Central de Ajuda sobre apps não verificados e os documentos sobre como configurar a tela de permissão OAuth para saber mais.
Proteger as credenciais do aplicativo
Proteja o ID do cliente OAuth 2.0 e a chave secreta do cliente do seu aplicativo. Essas credenciais ajudam os usuários e o Google a identificar seu aplicativo e, portanto, precisam ser tratadas com cuidado. Trate essas credenciais de aplicativo como senhas. Não as compartilhe usando mecanismos não seguros, como postar em fóruns públicos, enviar arquivos de configuração que contenham essas credenciais em anexos de e-mail, codificar as credenciais ou confirmá-las em um repositório de código. Recomendamos usar um gerenciador de secrets, como o Google Cloud Secret Manager ou o AWS Secrets Manager, quando possível.
Se as chaves secretas do cliente OAuth 2.0 forem comprometidas, você poderá redefini-las.
Proteger as contas de serviço
Se você usa contas de serviço, proteja-as da seguinte maneira:
Trate a chave da conta de serviço e o arquivo JSON como senhas. Proteja-as usando um gerenciador de secrets, como o Google Cloud Secret Manager ou o AWS Secrets Manager, quando possível.
Siga as outras práticas recomendadas do Google Cloud para proteger e gerenciar suas contas de serviço.
Proteger os tokens do usuário
Se o app autorizar vários usuários, siga outras etapas para proteger os tokens de atualização e de acesso dos usuários. Armazene os tokens de forma segura em repouso e nunca os transmita em texto simples. Use um sistema de armazenamento seguro adequado para sua plataforma.
Processar a revogação e a expiração do token de atualização
Se o app solicitar um token de atualização do OAuth 2.0 como parte da autorização, você também precisará processar a invalidação ou expiração dele. Os tokens de atualização podem ser invalidado por vários motivos, e seu aplicativo precisa responder de maneira adequada, autorizando novamente o usuário durante a próxima sessão de login ou limpando os dados dele, conforme apropriado. Os jobs off-line, como os jobs cron, precisam detectar e registrar contas com tokens de atualização expirados, em vez de continuar fazendo solicitações com falha. O Google pode limitar os aplicativos que geram altos níveis de erros por um período prolongado para manter a estabilidade dos servidores de API.
Gerenciar o consentimento para vários escopos
Se o app solicitar autorização para vários escopos do OAuth 2.0, talvez o usuário não conceda todos os escopos solicitados. Seu app precisa lidar com a negação de escopos desativando os recursos relevantes. Você só pode solicitar novamente depois que o usuário indicar claramente a intenção de usar o recurso específico que requer o escopo. Use a autorização incremental para solicitar os escopos do OAuth adequados nesses casos.
Se os recursos básicos do app exigirem vários escopos, explique esse requisito ao usuário antes de solicitar o consentimento.