Como organizar a propriedade de aplicativos cliente

Esta página descreve as ferramentas e estratégias usadas para organizar a propriedade de aplicativos cliente.

Como usar AppGroups para organizar a propriedade de aplicativo

Esta seção fornece uma visão geral dos AppGroups e como gerenciá-los.

O que são AppGroups?

Um AppGroup representa um relacionamento entre um ou mais aplicativos gerenciados pelo mesmo conjunto de pessoas.

Um AppGroup está associado a outro sistema responsável por gerenciar a lista de pessoas com responsabilidade compartilhada por esses aplicativos, como um portal. Os aplicativos e os desenvolvedores da Apigee estão associados ao AppGroup.

Os AppGroups fornecem:

  • Um método para organizar e conferir associações e propriedades de aplicativos.
  • A capacidade de criar uma lista de usuários para um portal ou uma vitrine de API responsáveis por um aplicativo. Por exemplo, é possível configurar diferentes AppGroups para fins de faturamento.
  • Flexibilidade para rastrear a propriedade de aplicativos por parceiro, unidade de negócios, linha de produto, divisão ou outras entidades corporativas.
  • Uma estrutura com vários níveis possíveis para rastrear como os aplicativos estão logicamente relacionados a proprietários e desenvolvedores de aplicativos.

Permissões e papéis do IAM

Para controlar as permissões necessárias para o gerenciamento de AppGroups, é possível ver e conceder papéis usando o painel de permissões na página IAM e administrador > IAM no projeto do Google Cloud.

Acessar IAM e administrador

A tabela a seguir lista o papel e as permissões individuais correspondentes necessárias para criar e gerenciar recursos de AppGroups.

Nome do papel do IAM Escopo do papel Permissões necessárias Descrição
Administrador desenvolvedor da Apigee Administrador desenvolvedor de recursos da apigee

Como gerenciar AppGroups:

  • apigee.appgroups.list
  • apigee.appgroups.get
  • apigee.appgroups.create
  • apigee.appgroups.update
  • apigee.appgroups.delete

Como gerenciar aplicativos de AppGroup:

  • apigee.appgroupapps.list
  • apigee.appgroupapps.get
  • apigee.appgroupapps.create
  • apigee.appgroupapps.manage
  • apigee.appgroupapps.delete

Como gerenciar chaves de aplicativo de AppGroups:

  • apigee.appkeys.get
  • apigee.appkeys.create
  • apigee.appkeys.manage
  • apigee.appkeys.delete
Permite gerenciar AppGroups e aplicativos e chaves associados. Os usuários com esse papel podem gerenciar todos os aspectos dos AppGroups, a menos que as permissões individuais sejam removidas.

Como conferir e gerenciar AppGroups

Nesta seção, mostramos como acessar e gerenciar AppGroups. É possível gerenciar apps AppGroups e AppGroup usando as APIs da Apigee e portais do Drupal.

Configurações de AppGroup

Os AppGroups incluem estas configurações:

Configuração Descrição
Nome Obrigatório. O nome do AppGroup. Os nomes de AppGroup precisam ser exclusivos em uma organização.

Os caracteres permitidos são caracteres alfanuméricos e qualquer um destes caracteres especiais: ._\-$ %.
ID do AppGroup Criado automaticamente e não editável. Criado no formato "NomedaOrganização@@@NomeDoGrupoApp". Por exemplo, com um nome de organização da Apigee XYZDev e nome do AppGroup ABCMarketing, o ID do AppGroup será XYZDev@@@ABCMarketing.
Nome de exibição Opcional. Um nome de exibição fácil para o AppGroup.
channelId Opcional. Identifica o sistema responsável por criar e gerenciar o AppGroup. Pode ser uma vitrine ou um marketplace. Vários AppGroups podem compartilhar o mesmo channelId.
channelUri Opcional. Referência ao grupo de pessoas que compartilham a responsabilidade pelo AppGroup. Muitas vezes, o channelUri se vincula ou refere a um grupo ou equipe em um portal do desenvolvedor ou outro sistema, como o módulo Drupal Teams da Apigee.

Como gerenciar AppGroups usando portais baseados no Drupal

O módulo Team da Apigee para Drupal funciona com o AppGroups na Apigee X e híbrida, sendo a interface principal para gerenciar AppGroups. Para mais informações sobre portais baseados em Drupal, consulte Como criar seu portal usando o Drupal.

Como gerenciar AppGroups usando as APIs Apigee

Use estas APIs para gerenciar AppGroups em organizações:

Atividades Link
Conferir e gerenciar AppGroups https://cloud.google.com/apigee/docs/reference/apis/apigee/rest/v1/organizations.appgroups
Conferir e gerenciar aplicativos que pertencem a AppGroups https://cloud.google.com/apigee/docs/reference/apis/apigee/rest/v1/organizations.appgroups.apps
Conferir e gerenciar chaves de aplicativo associadas a AppGroups https://cloud.google.com/apigee/docs/reference/apis/apigee/rest/v1/organizations.appgroups.apps.keys

Limitações e problemas conhecidos de AppGroups

Na Apigee híbrida, os AppGroups estão disponíveis na 1.10.0 e em versões posteriores.

Além disso, no momento, os AppGroups não são compatíveis com:

  • Aplicação de cota
  • Atualizações no escopo das chaves de API
  • Monetização

Como migrar do Apigee Edge para usuários do Drupal

Migrar um desenvolvedor da empresa e o papel dele envolve criar um AppGroup que representa a empresa e adicionar o desenvolvedor da empresa e os papéis dele como atributos personalizados do AppGroup. A sintaxe esperada para armazenar isso é:

[{
      "developer":"<developer email>",
      "roles":[
        "<role(s)>"
      ]
    },
    ...
]

Como usar a associação entre aplicativo e desenvolvedor para organizar a propriedade de aplicativo

Um método menos abrangente e flexível para rastrear a propriedade de aplicativos do que os AppGroups é o rastreamento de aplicativos por associação de desenvolvedor.

Para informações sobre como gerenciar associações entre desenvolvedores e aplicativos, consulte Como registrar desenvolvedores de aplicativos e saiba como registrar desenvolvedores e aplicativos associados.