Resolver problemas de autenticação do IAM

Para diagnosticar e resolver tentativas de login com falha na autenticação do Identity and Access Management (IAM) para o AlloyDB para PostgreSQL, inspecione os registros de alerta de autenticação na Análise de registros.

Para determinar a causa de uma falha na tentativa de autenticação baseada no IAM, siga estas etapas:

  1. No console do Google Cloud , acesse a página Análise de registros:

    Acessar a Análise de registros

  2. Na lista suspensa Todos os recursos, selecione Instância do AlloyDB.

  3. Em Gravidade, clique em Alerta.

    Se Alerta não for uma opção, não há falhas de autenticação registradas na janela de tempo selecionada. Talvez seja necessário ajustar a janela usando os controles da Análise de Registros.

  4. Em Resultados da consulta, verifique se as entradas de registro têm uma das seguintes mensagens:

    Request had invalid authentication credentials.
    O token de acesso é inválido.
    Caller does not have required permission to use project.
    O principal do IAM não tem os papéis ou as permissões necessários do IAM. A mensagem de erro completa especifica os papéis ou as permissões que estão faltando.
    IAM principal does not match database user.

    O principal do IAM autenticado especificado pelo token de acesso não corresponde ao usuário do banco de dados que você quer usar para se conectar.

    Para ver o principal especificado pelo token, execute o seguinte comando:

    curl -H "Content-Type: application/x-www-form-urlencoded" \
        -d "access_token=ACCESS_TOKEN" \
        https://www.googleapis.com/oauth2/v1/tokeninfo
    

    Substitua ACCESS_TOKEN pelo token de acesso do OAuth 2.0.

    Esse erro também ocorre se o principal encurtado da conta de serviço, que é o endereço de e-mail sem o sufixo .gserviceaccount.com, exceder 63 caracteres.

    O PostgreSQL tem um limite de 63 caracteres para identificadores de papel e usuário. Embora o AlloyDB permita criar o usuário, o PostgreSQL trunca o nome do papel para 63 bytes no catálogo interno. Durante o login, a camada de autenticação do IAM do AlloyDB compara o principal completo e não truncado do token OAuth com o papel de banco de dados truncado, o que resulta em uma incompatibilidade de string.

    Solução alternativa: usar a identidade temporária de conta de serviço

    Se não for possível encurtar o nome da conta de serviço, use a identidade temporária de conta de serviço para contornar essa limitação. Isso separa a identidade que executa a carga de trabalho da identidade usada para fazer login no banco de dados:

    1. Crie uma conta de serviço de proxy com um nome cujo principal abreviado, excluindo o sufixo .gserviceaccount.com, tenha até 63 caracteres, como db-proxy@PROJECT_ID.iam.gserviceaccount.com.
    2. Adicione a conta de serviço de proxy ao cluster do AlloyDB como um usuário do banco de dados IAM_BASED com o nome de usuário db-proxy@PROJECT_ID.iam.
    3. No IAM, conceda à conta de serviço original da carga de trabalho o papel de Criador de Token da Conta de Serviço (roles/iam.serviceAccountTokenCreator) na conta de serviço de proxy.
    4. Configure seu aplicativo, os conectores de linguagem do AlloyDB ou o proxy de autenticação do AlloyDB para se conectar usando a identidade do proxy.

    Por exemplo, é possível se conectar usando o comando gcloud beta alloydb connect com a flag --impersonate-service-account:

    gcloud beta alloydb connect INSTANCE_ID \
        --cluster=CLUSTER_ID \
        --region=REGION_ID \
        --impersonate-service-account=PROXY_SERVICE_ACCOUNT_EMAIL \
        --auto-iam-authn
    

    Substitua:

    • INSTANCE_ID: o ID da instância do AlloyDB.
    • CLUSTER_ID: o ID do cluster que contém a instância.
    • REGION_ID: a região em que o cluster está localizado.
    • PROXY_SERVICE_ACCOUNT_EMAIL: o endereço de e-mail completo da conta de serviço de proxy.

    Observação: a conta de serviço original não precisa de acesso de login direto ao banco de dados, apenas de permissão para personificar a conta de proxy. A conta de serviço de proxy tem os privilégios do banco de dados.

    Request had insufficient scopes.
    O token de acesso não contém o escopo alloydb.login nem o escopo cloud-platform. Pelo menos um desses escopos é obrigatório.