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.
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:
Como gerenciar aplicativos de AppGroup:
Como gerenciar chaves de aplicativo de AppGroups:
|
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.
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.