Este documento descreve como se autenticar no Google Cloud usando tokens pela federação de identidade da carga de trabalho. Com a federação de identidade da carga de trabalho, é possível conceder às cargas de trabalho SAP locais ou em várias nuvens acesso aos recursos do Google Cloud sem usar uma chave de conta de serviço.
A federação de identidade da carga de trabalho segue a especificação de troca de token do OAuth 2.0. Você fornece uma credencial do IdP ao Serviço de token de segurança, que verifica a identidade na credencial e, em seguida, retorna um token de acesso federado em troca. É possível usar esse token de acesso federado diretamente com serviços com suporte ou para imitar uma conta de serviço e receber um token de acesso de curta duração. Com o token de acesso de curta duração, é possível chamar qualquer API Google Cloud a que a conta de serviço tenha acesso.
É possível usar a federação de identidade da carga de trabalho com o servidor de metadados ou o provedor de identidade externo (IdP).
Federação de identidade da carga de trabalho com metadados de VM
Se o sistema SAP estiver hospedado no Google Cloud , mas for gerenciado pela SAP, use a federação de identidade da carga de trabalho para acessar com segurança os recursos em outros projetosGoogle Cloud do sistema SAP. A federação de identidade da carga de trabalho permite que o sistema SAP se autentique em outros projetos Google Cloud usando os metadados da VM. Isso elimina a necessidade de gerenciar chaves de conta de serviço, aumentando a segurança e simplificando a autenticação.
As etapas de configuração de nível alto são as seguintes:
- Em Google Cloud, configure a federação de identidade da carga de trabalho.
- Em Google Cloud, crie uma conta de serviço.
- Em Google Cloud, conceda à conta de serviço acesso ao pool de federação de identidade da carga de trabalho.
- No ABAP SDK for Google Cloud, configure a chave do cliente.
Configurar a federação de identidade da carga de trabalho
Para receber as permissões necessárias para configurar a federação de identidade da carga de trabalho, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto:
- Administrador de pool de Identidade da carga de trabalho
roles/iam.workloadIdentityPoolAdmin
() - Administrador da conta de serviço (
roles/iam.serviceAccountAdmin
)
Para mais informações sobre como conceder papéis, consulte Gerenciar acesso.
Para configurar a federação de identidade da carga de trabalho, siga as etapas:
No console do Google Cloud, acesse a página Novo provedor de carga de trabalho e pool.
Na seção Criar um pool de identidades, insira um valor para os seguintes campos:
- Nome: o nome do pool. O nome também é usado como o ID do pool. Não será possível alterar o ID do pool posteriormente.
- Descrição: texto que descreve a finalidade do pool.
Clique em Continuar.
Em Adicionar um provedor ao pool, adicione o servidor de metadados como um provedor:
- No campo Selecionar um provedor, escolha OpenID Connect (OIDC).
Digite os seguintes detalhes do provedor:
- Em Nome do provedor, digite um nome para o provedor.
- Issuer(URL): insira o URL do token do servidor de metadados,
https://accounts.google.com
. - Público-alvo: selecione Público-alvo permitido e insira o número do projeto do Google Cloud que você precisa acessar. Para saber como conseguir o número do projeto, consulte Reunir detalhes da instância do servidor de metadados do Google.
Clique em Continuar.
Em Configurar atributos do provedor, faça o seguinte:
- No campo Google 1, verifique se o valor é
google.subject
. - No campo OIDC 1, digite
assertion.sub
.
- No campo Google 1, verifique se o valor é
Clique em Salvar.
Anote o seguinte:
- ID do pool
- Código do provedor
Você vai precisar desses IDs ao configurar a chave do cliente.
Coletar detalhes da instância do servidor de metadados do Google
Para conferir os detalhes da instância do servidor de metadados do Google necessários para configurar a federação de identidade da carga de trabalho, siga estas etapas:
-
Na GUI do SAP, execute o código de transação
/GOOG/SDK_IMG
.Como alternativa, execute o código da transação
SPRO
e clique em IMG de referência do SAP. - Clique em ABAP SDK for Google Cloud > Utilities > Acessar valores de metadados específicos para a instância do servidor de metadados do Google.
- Selecione as opções adequadas:
- ID do projeto numérico
- E-mail da conta de serviço padrão
- Clique em Executar para ver os detalhes.
- Anote os detalhes. Você vai precisar deles ao configurar a federação de identidade da carga de trabalho no console do Google Cloud.
Criar uma conta de serviço
No console do Google Cloud, crie uma conta de serviço do IAM. Essa conta de serviço precisa ser a principal no projeto do Google Cloud que contém as APIsGoogle Cloud que você planeja consumir usando o SDK.
No console do Google Cloud, selecione o projeto em que você quer criar a conta de serviço.
Se você criar a conta de serviço no mesmo projeto que contém as APIs Google Cloud , ela será adicionada automaticamente como principal ao projeto.
Se você criar a conta de serviço em um projeto diferente daquele em que as APIsGoogle Cloud estão ativadas, será necessário adicionar a conta de serviço a esse projeto em uma etapa extra. Para mais informações, consulte Adicionar a conta de serviço ao projeto do Google Cloud.
Crie uma conta de serviço para autenticação e autorização a fim de acessar as APIs Google Cloud .
Para mais informações sobre como criar uma conta de serviço, consulte Criar uma conta de serviço.
No Console do Google Cloud, conceda à conta de serviço os papéis do IAM necessários para acessar a funcionalidade da API. Para entender o requisito de função para Google Cloud APIs, consulte a documentação da API individual e siga o princípio do menor privilégio. Para mais informações sobre os papéis predefinidos específicos da API, consulte Referência básica e predefinida dos papéis do IAM.
Se você criou a conta de serviço em um projeto diferente daquele que contém as APIs Google Cloud que pretende consumir usando o SDK, anote o nome da conta de serviço. Você especifica o nome ao adicionar a conta de serviço a esse projeto.
Adicionar a conta de serviço ao projeto do Google Cloud
Se você criou a conta de serviço do ABAP SDK for Google Cloud em um projeto diferente do projeto que contém as APIs Google Cloud que você pretende consumir usando o SDK, será necessário adicionar a conta de serviço ao projeto do Google Cloud que contém as APIs Google Cloud .
Se você criou a conta de serviço no mesmo projeto que contém as APIsGoogle Cloud , pule esta etapa.
Para adicionar uma conta de serviço ao projeto do Google Cloud que contém as APIs Google Cloud , siga estas etapas:
No console do Google Cloud, acesse a página de Permissões do IAM.
Confirme se o nome do projeto que contém as APIsGoogle Cloud de destino é exibido próximo à parte de cima da página. Exemplo:
Permissões do projeto '
PROJECT_NAME
'Caso contrário, mude de projeto.
Na página de Permissõesdo IAM, clique em
Conceder acesso.Na caixa de diálogo Conceder acesso a '
PROJECT_NAME
' que é exibida, siga estas etapas:- No campo Novos principais, especifique o nome da conta de serviço.
No campo Selecionar uma função, especifique uma função relevante. Por exemplo, no Pub/Sub, para modificar tópicos e assinaturas, além de acessar para publicar e consumir mensagens, é possível especificar o papel Editor do Pub/Sub (
roles/pubsub.editor
).Para mais detalhes sobre os papéis predefinidos específicos da API, consulte Referência básica e predefinida dos papéis do IAM.
Adicione papéis conforme necessário para o uso da API. Recomendamos a implementação do princípio de privilégio mínimo.
Clique em Salvar. A conta de serviço aparece na lista de principais do projeto na página IAM.
A conta de serviço agora pode ser usada para acessar as APIs Google Cloud neste projeto.
Conceder à conta de serviço acesso ao pool de federação de identidade da carga de trabalho
Para representar contas de serviço de cargas de trabalho federadas, conceda o
Usuário de identidade da carga de trabalho (roles/iam.workloadIdentityUser
)
na conta de serviço. Para mais informações sobre como conceder papéis, consulte Gerenciar acesso.
Para conceder à conta de serviço acesso ao pool de federação de identidade da carga de trabalho, faça o seguinte:
No Console do Google Cloud, acesse a página Pools de Identidades da carga de trabalho.
Selecione o pool de identidade da carga de trabalho que você criou na seção Configurar a federação de identidade da carga de trabalho.
Para conceder acesso ao pool de identidades da carga de trabalho, clique em
Conceder acesso.Na lista Conta de serviço, selecione a conta que tem acesso às APIs Google Cloud . Se você usa várias contas de serviço, adicione todas elas aqui.
No campo Nome do atributo, selecione Assunto.
No campo Valor do atributo, insira o endereço de e-mail da conta de serviço recuperado do servidor de metadados, entre aspas duplas. Por exemplo,
"svc-acct-compute@example-project-123456.iam.gserviceaccount.com"
.Para saber como recuperar o endereço de e-mail da conta de serviço do servidor de metadados, consulte Coletar detalhes da instância do servidor de metadados do Google.
Na caixa de diálogo Configurar seu aplicativo exibida, clique em Dispensar.
Configurar chave do cliente
-
Na GUI do SAP, execute o código de transação
/GOOG/SDK_IMG
.Como alternativa, execute o código da transação
SPRO
e clique em IMG de referência do SAP. - Clique em ABAP SDK for Google Cloud > Configurações básicas > Configurar chave do cliente.
- Clique em Novas entradas.
Insira valores nos campos a seguir:
Campo Descrição Nome da chave do Google Cloud Especifique um nome da configuração da chave do cliente. Nome da conta de serviço do Google Cloud Especifique o nome da conta de serviço, no formato de endereço de e-mail, que foi criada para acessar as APIs Google Cloud na etapa Criar uma conta de serviço. Por exemplo: sap-example-svc-acct@example-project-123456.iam.gserviceaccount.com
.Escopo do Google Cloud Especifique o escopo de acesso à API, https://www.googleapis.com/auth/cloud-platform
.Identificador de projeto do Google Cloud Especifique o ID do projeto do Google Cloud em que você criou o pool de Identidade da carga de trabalho. Nome do comando Deixe esse campo em branco. Classe de autorização Especifique a classe de autenticação conforme apropriado: /GOOG/CL_AUTH_WIF_META_ACCESS
: gera tokens OAuth assinados pelo Google./GOOG/CL_AUTH_WIF_META_IDTOKEN
: gera tokens de ID assinados pelo Google.
Armazenamento de tokens em cache A flag que determina se os tokens de acesso recuperados de Google Cloud são armazenados em cache.
Recomendamos que você ative o armazenamento em cache do token depois de concluir a configuração e o teste da sua conexão com Google Cloud.
Token de atualização em segundos Deixe esse campo em branco. Parâmetro de autorização 1 Especifique o ID do pool de identidades de cargas de trabalho. Parâmetro de autorização 2 Especifique o ID do provedor de identidade da carga de trabalho. Salve a entrada.
Federação de identidade da carga de trabalho com IdPs externos
É possível usar a federação de identidade da carga de trabalho com IdPs externos, como a Amazon Web Services (AWS), ou com qualquer provedor de identidade (IdP) compatível com o OpenID Connect (OIDC), como o Microsoft Azure ou o SAML 2.0.
Para autenticação com tokens usando a federação de identidade da carga de trabalho, as etapas gerais de configuração são as seguintes:
- Prepare seu IdP externo.
- Em Google Cloud, configure a federação de identidade da carga de trabalho.
- Em Google Cloud, crie uma conta de serviço.
- Em Google Cloud, permita que a carga de trabalho externa represente a conta de serviço.
- No ABAP SDK for Google Cloud, implemente o código ABAP para recuperar tokens de segurança do seu IdP.
- No ABAP SDK for Google Cloud, configure a chave do cliente.
Nem todos os Google Cloud produtos são compatíveis com a federação de identidade da carga de trabalho. Antes de configurar a autenticação usando a federação de identidade da carga de trabalho, consulte a lista de produtos compatíveis e limitações. Para mais informações, consulte Federação de identidade da força de trabalho: produtos e limitações com suporte.
Preparar seu IdP externo
Você precisa preparar seu IdP para que sua carga de trabalho SAP possa receber credenciais que possam ser trocadas por um token de segurança do Google OAuth 2.0.
Para preparar o IdP externo, siga as etapas dependendo do IdP:
- Se você estiver usando a AWS ou o Azure como IdP, siga as instruções para preparar seu IdP externo.
- Se você estiver usando outros IdPs, siga as instruções para preparar seu IdP externo.
Configurar a federação de identidade da carga de trabalho
Em Google Cloud, configure o pool de identidade e os provedores da carga de trabalho.
Você configura um pool de identidades, que é uma entidade que permite gerenciar identidades externas. Você também configura um provedor de pool de identidade da carga de trabalho, que é uma entidade que descreve uma relação entre Google Cloud e seu IdP.
Para configurar a federação de identidade da carga de trabalho, execute as etapas, dependendo do IdP externo:
- Se você estiver usando a AWS ou o Azure como IdP, siga as instruções para criar o pool de identidades e o provedor de identidades de cargas de trabalho.
- Se você estiver usando outros IdPs, siga as instruções para criar o pool de identidade e o provedor da carga de trabalho.
Anote o seguinte:
- Número do projeto: o número do projeto do Google Cloud em que você criou o pool de Identidade da carga de trabalho.
- ID do pool: um ID exclusivo que identifica o pool de identidades da carga de trabalho.
- ID do provedor: um ID que identifica o provedor do pool de identidades da carga de trabalho.
Você precisa delas para a configuração da chave de cliente do SDK ABAP.
Criar uma conta de serviço
No console do Google Cloud, crie uma conta de serviço do IAM dedicada para acessar as APIs Google Cloud . Essa conta de serviço precisa ser a principal no projeto do Google Cloud que contém as APIsGoogle Cloud que você planeja consumir usando o SDK.
No console do Google Cloud, ative a API IAM Service Account Credentials, a API Security Token Service e todas as outras APIs compatíveis que você planeja acessar usando o SDK.
Para informações sobre como ativar Google Cloud APIs, consulte Como ativar APIs.
Crie uma conta de serviço que represente a carga de trabalho.
Conceda à conta de serviço os papéis do IAM necessários para acessar a funcionalidade da API. Para entender o requisito de função para Google Cloud APIs, consulte a documentação da API individual e siga o princípio do menor privilégio. Para mais informações sobre papéis predefinidos específicos da API, consulte Encontrar papéis do IAM para Google Cloud APIs.
Permitir que a carga de trabalho externa represente a conta de serviço
Para permitir que a carga de trabalho externa represente a conta de serviço, execute as etapas dependendo do IdP externo:
- Se você estiver usando a AWS ou o Azure como seu IdP, siga as instruções para permitir que a carga de trabalho externa represente a conta de serviço.
- Se você estiver usando outros IdPs, siga as instruções para permitir que a carga de trabalho externa represente a conta de serviço.
Implemente o código ABAP para recuperar tokens de segurança do seu IdP
O ABAP SDK for Google Cloud disponibiliza uma classe abstrata /GOOG/CL_AUTH_WIF_BASE
,
que tem a lógica para recuperar tokens de segurança OAuth 2.0 do
Security Token Service e tokens de acesso OAuth 2.0 da
API Service Account Credentials do IAM. Como desenvolvedor, você precisa criar uma classe filha no seu namespace que seja herdeira
da classe abstrata /GOOG/CL_AUTH_WIF_BASE
.
Para invocar as funções do Cloud Run do ABAP SDK for Google Cloud usando
a federação de identidade da carga de trabalho,
o SDK disponibiliza outra classe abstrata
/GOOG/CL_AUTH_WIF_ID_TOKEN
. Se você configurar a autenticação usando
a federação de identidade da carga de trabalho, precisará criar mais uma
classe filha no namespace herdada da classe abstrata
/GOOG/CL_AUTH_WIF_ID_TOKEN
. Essa classe filha é especificada no campo Classe de autorização ao configurar a chave do cliente para invocar as funções do Cloud Run.
Implemente o
método GET_EXT_IDP_TOKEN
na classe filha e escreva a lógica para receber o
token de segurança do IdP. Preencha os seguintes campos:
CV_TOKEN
: o token recuperado do IdP no formatostring
.CV_TOKEN_TYPE
: o tipo do token de segurança recuperado do IdP. Os tipos de token compatíveis são:urn:ietf:params:oauth:token-type:jwt
urn:ietf:params:oauth:token-type:id_token
urn:ietf:params:aws:token-type:aws4_request
urn:ietf:params:oauth:token-type:access_token
urn:ietf:params:oauth:token-type:saml2
Os valores preenchidos em CV_TOKEN
e CV_TOKEN_TYPE
são usados por métodos da
classe abstrata /GOOG/CL_AUTH_WIF_BASE
para trocar e recuperar o
token OAuth 2.0 final, que é usado nas chamadas de API.
O exemplo a seguir mostra as implementações de amostra do método
GET_EXT_IDP_TOKEN
para
outros provedores de nuvem, como AWS e Azure.
AWS
Azure
Configurar chave do cliente
-
Na GUI do SAP, execute o código de transação
/GOOG/SDK_IMG
.Como alternativa, execute o código da transação
SPRO
e clique em IMG de referência do SAP. - Clique em ABAP SDK for Google Cloud > Configurações básicas > Configurar chave do cliente.
- Clique em Novas entradas.
Insira valores nos campos a seguir:
Campo Descrição Nome da chave do Google Cloud Especifique um nome da configuração da chave do cliente. Nome da conta de serviço do Google Cloud Especifique o nome da conta de serviço, no formato de endereço de e-mail, que foi criada para acessar as APIs Google Cloud na etapa Criar uma conta de serviço. Por exemplo: sap-example-svc-acct@example-project-123456.iam.gserviceaccount.com
.Escopo do Google Cloud Especifique o escopo de acesso à API, https://www.googleapis.com/auth/cloud-platform
.Identificador de projeto do Google Cloud Especifique o ID do projeto do Google Cloud em que você criou o pool de Identidade da carga de trabalho. Nome do comando Deixe esse campo em branco. Classe de autorização Especifique a classe filha, que contém a implementação da classe /GOOG/CL_AUTH_WIF_BASE
. Para mais informações, consulte Implementar o código ABAP para recuperar tokens de segurança do IdP.Armazenamento de tokens em cache A flag que determina se os tokens de acesso recuperados de Google Cloud são armazenados em cache.
Recomendamos que você ative o armazenamento em cache do token depois de concluir a configuração e o teste da sua conexão com Google Cloud.
Token de atualização em segundos Deixe esse campo em branco. Parâmetro de autorização 1 Especifique o ID do pool de identidades de cargas de trabalho. Parâmetro de autorização 2 Especifique o ID do provedor de identidade da carga de trabalho. Salve a entrada.
Receber suporte
Se você precisar de ajuda para resolver problemas com o ABAP SDK for Google Cloud, faça o seguinte:
Consulte o guia de solução de problemas do ABAP SDK for Google Cloud.
Faça suas perguntas e discuta o ABAP SDK for Google Cloud com a comunidade nos Fóruns do Cloud.
Colete todas as informações de diagnóstico disponíveis e entre em contato com o Cloud Customer Care. Para mais informações sobre como entrar em contato com o atendimento ao cliente, consulte Como receber suporte para o SAP no Google Cloud.