Apigee

Credenciais de acesso

Veja nesta página como obter credenciais de acesso para configurar uma conexão com a Apigee:

Criando uma conta de serviço

Para criar uma conta de serviço, siga os passos abaixo:

  1. Acesse o Console do Google Cloud Platform.

  2. No menu lateral, clique em IAM & Admin > Service accounts.

  3. Preencha os campos para criar uma conta de serviço e clique em DONE.

detalhe do formulário de criação de conta de serviço


Adicionando permissões à conta de serviço

Para adicionar permissões à conta de serviço, siga os passos abaixo:

Acesse o Console do Google Cloud Platform e:

  1. No menu lateral, clique em IAM & Admin > IAM.

  2. Clique em GRANT ACCESS.

  3. No campo New principals, selecione a conta de serviço criada.

  4. Em Assign roles, adicione as roles “Apigee API Reader” e “Apigee Read-only Admin” e clique em Save.

passos para adicionar permissões


Criando as credenciais

Para criar as credenciais, siga os passos abaixo:

Acesse o Console do Google Cloud Platform e:

  1. No menu lateral, clique em IAM & Admin > Service accounts.

  2. Na lista de contas de serviço, clique na conta criada.

  3. Na aba Keys:

    • Clique em ADD KEY e

    • Selecione JSON.

  4. Clique em CREATE.
    Um arquivo JSON contendo as credenciais será baixado automaticamente.

passos para criar as credenciais

Importando APIs

Para importar APIs manualmente, siga os passos abaixo:

  1. Entre na tela Connections, clicando no menu lateral esquerdo ou no card na tela inicial.

  2. Encontre a conexão que deseja editar e clique no ícone icon view 2.
    Se precisar, utilize a barra de busca para localizar a conexão desejada.

  3. Na tela API Imports, clique no botão + IMPORT API.
    tela importação de APIs

  4. Selecione as APIs que deseja importar. Se necessário, utilize a busca por nome da API. Em seguida, clique em SAVE.

Sempre que uma API for atualizada, clique em icone de recarregar.
detalhe com o botão de recarregar APIs importadas

Importando contratos OpenAPI/Swagger

As conexões nativas com o Apigee importam arquivos Swagger/OpenAPI apenas para APIs que tenham esse arquivo anexado manualmente.

Esse comportamento decorre de uma limitação do próprio API Manager do Apigee, que não gera arquivos OpenAPI de forma nativa. Portanto, não se trata de uma limitação da nossa solução.

Para que o contrato da sua API seja importado corretamente, antes de importar ou sincronizar a API, siga os passos abaixo:

  1. Anexe o arquivo OpenAPI no API Proxy da Apigee em [Proxi Development > API proxy > Develop].
    Tela da Apigee para anexar recursos

  2. Se a API já existir no catálogo da Sensedia, refaça o Sync da API clicando no botão para sincronizar APIs.
    Destaque para o botão para sincronizar APIs na tela de conexões com Apigee

  3. Caso a API não exista, prossiga com o processo de importação normalmente.
    Tela de importação de APIs

Após a sincronização/importação, verifique se o contrato foi importado corretamente.

  • No Adaptive Governance:

    • Acesse Discovery.

    • Na coluna Actions, clique no ícone para visualizar a API.

    • Entre na aba Documentation.

    • Veja a documentação na aba Preview.

  • No Developer Portal:

    • Acesse API Docs.

    • Na coluna Actions, clique no ícone para visualizar a API.

    • Veja a documentação na aba General Info.

contrato importado

Thanks for your feedback!
EDIT

Share your suggestions with us!
Click here and then [+ Submit idea]