Resolver problemas de conexões do proxy de autenticação do AlloyDB

Para resolver erros de conexão, autenticação ou rede ao se conectar à instância do AlloyDB para PostgreSQL com o proxy de autenticação do AlloyDB, verifique os seguintes problemas e soluções comuns:

  • Verifique cuidadosamente a saída do proxy de autenticação do AlloyDB e procure erros. Muitas vezes, as mensagens de erro fornecem as informações necessárias para determinar a origem do problema e como resolvê-lo.

  • Se você estiver recebendo um erro 403 Forbidden e estiver usando uma conta de serviço para autenticar o proxy de autenticação do AlloyDB, verifique se a conta de serviço tem as permissões corretas.

    Os papéis predefinidos do Identity and Access Management (IAM) do AlloyDB que fornecem essas permissões são Cliente do AlloyDB (roles/alloydb.client) e Administrador do AlloyDB (roles/alloydb.admin). Além disso, é necessário adicionar o papel de consumidor do Service Usage (roles/serviceusage.serviceUsageConsumer).

  • Ative a API AlloyDB.

    Caso contrário, você verá uma saída como Error 403: Access Not Configured nos registros do proxy de autenticação do AlloyDB.

  • Se você estiver se conectando com soquetes UNIX, confirme se eles foram criados listando o diretório fornecido quando você iniciou o proxy de autenticação do AlloyDB.

  • Se você tiver uma política de firewall para o tráfego de saída, verifique se ela permite conexões com a porta 5433 na instância de destino do AlloyDB.

  • Problemas de cota: se você encontrar erros relacionados a cotas excedidas, identifique a origem do problema de cota (por exemplo, um aplicativo está usando o conector de maneira incorreta e criando novas conexões desnecessariamente) ou entre em contato com o suporte para solicitar um aumento na cota da API AlloyDB.

  • Se você receber uma resposta 400 Bad Request com uma mensagem de erro contendo reauth related error, atualize o Application Default Credentials usando a Google Cloud CLI:

    gcloud auth application-default login

    Para mais informações, consulte Como o Application Default Credentials funciona.