Usar o Application Integration

Esta página contém informações destinadas aos clientes atuais da Apigee que querem usar o Application Integration com o mesmo projeto do Google Cloud.

Visão geral

Todos os usuários com assinaturas da Apigee que ativaram o complemento Apigee Integrations serão redirecionados para o Application Integration. Você pode usar a Application Integration sem custo adicional. O Application Integration é configurado para você e todas as suas integrações atuais na Apigee são sincronizadas automaticamente e ficam disponíveis para uso. Isso significa que você pode continuar usando seu projeto do Google Cloud para a Application Integration sem outras configurações.

Para saber mais sobre o Application Integration, consulte Visão geral do Application Integration.

Observação: as integrações atuais configuradas no local US multi-region(us) não estarão disponíveis no Application Integration. Para mais detalhes, consulte Descontinuação da região dos EUA.

No portal da Apigee, você pode redirecionar para a Application Integration:

Dica: recomendamos que você use a referência de API e as permissões do IAM do Application Integration ao começar a usá-lo.

O que mudará?

Veja na tabela a seguir um resumo das diferenças ou mudanças esperadas no projeto do Google Cloud:

Recurso/atributo da Apigee	Diferença/alteração esperada
Permissões IAM	As integrações usarão os papéis predefinidos do IAM relativos ao Application Integration. Consulte Alterações de permissão do IAM.
Conta de serviço	Uma nova conta de serviço padrão é criada e será usada para todas as integrações. Consulte Alterações na conta de serviço.
APIs REST	As APIs REST da integração da Apigee têm equivalentes no Application Integration. Consulte Alterações na API REST.
Enviar tarefas de e-mail e aprovação	O endereço de e-mail do remetente é alterado para todos os e-mails enviados. Consulte Alterações na tarefa de integração.
Tarefa do conector	Não é possível configurar uma tarefa de conector no portal da Apigee. Consulte Alterações na tarefa do conector.

Alterações nas permissões do IAM

Todas as contas de usuário ou principais com papéis do IAM atribuídos com relação à integração da Apigee recebem permissões do IAM relativas ao Application Integration predefinido equivalentes.

As permissões do IAM relativas ao Application Integration têm o seguinte formato:

Formato

integrations.integrationRESOURCE.ACTION

Exemplo

integrations.integrationVersions.get

Limitações de papéis personalizados do IAM

As limitações a seguir se aplicam no caso de papéis personalizados do IAM definidos no projeto do Google Cloud:

• Os proxies da Apigee que usam uma conta de serviço com papéis personalizados do IAM que contêm permissões da integração da Apigee podem falhar. Recomendamos que você atualize seus papéis personalizados do IAM com as permissões do IAM relativas ao Application Integration.

Para informações sobre papéis e permissões do IAM, consulte Visão geral do controle de acesso.

Alterações na conta de serviço

Uma nova conta de serviço padrão com o papel do IAM de agente de serviço do Application Integration (roles/integrations.serviceAgent) é criada no projeto do Google Cloud.

A nova conta de serviço padrão do Application Integration é usada para as seguintes operações de integração:

• Executar uma integração.
• Invocar uma função do Cloud usando a tarefa da função do Cloud.
• Chamar um Integration Connector usando a tarefa de conector.
• Criar tokens de conta de serviço para perfis de autenticação de Tipo de conta de serviço.
• Criptografar e descriptografar chaves do Cloud KMS para perfis de autenticação.

A conta de serviço padrão do Application Integration tem o seguinte endereço de e-mail:

Formato

  [e-mail]

Exemplo

  [e-mail]

Para informações sobre contas de serviço, consulte Visão geral do controle de acesso.

Observações:

• Se você estiver usando um perfil de autenticação de Tipo de conta de serviço pertencente a um projeto diferente do Google Cloud, atribua o papel do IAM de criador de token da conta de serviço à nova conta de serviço padrão do Application Integration.
• A Apigee continuará usando a conta de serviço padrão atual da Apigee, [e-mail], para outros recursos e operações próprios.

Alterações na API REST

Em geral, a maioria das APIs da integração da Apigee tem equivalentes no Application Integration.

A tabela a seguir descreve a principal alteração nas APIs REST da integração da Apigee em comparação com o Application Integration:

	Integrações da Apigee (incluindo o proxy da Apigee)	Application Integration
Recurso REST	projects/PROJECT_ID/locations/REGION/products/apigee/integration/INTEGRATION_NAME	projects/PROJECT_ID/locations/REGION/integration/INTEGRATION_NAME

Observação: seus caminhos de recursos nas integrações da Apigee continuarão funcionando mesmo depois que você começar a usar o Application Integration.

Para informações sobre as APIs do Application Integration, consulte API REST do Application Integration.

Alterações na tarefa de integração

As tarefas Enviar e-mail e Aprovação usarão [e-mail] para enviar notificações por e-mail. Além disso, todos os e-mails de solicitação de aprovação enviados por meio da tarefa de aprovação serão vinculados ao Application Integration.

Mudanças na tarefa do conector

É possível configurar a tarefa de conectores somente na Application Integration.