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.
  • Integração de monetização. Gerencie assinaturas para grupos de desenvolvedores de apps usando AppGroups para assinar produtos de API com planos de preços. Para mais informações, consulte Usar AppGroups para gerenciar assinaturas de produtos de API.

Permissões e papéis do IAM

Para controlar as permissões necessárias para o gerenciamento de AppGroups, é possível ver e conceder permissões ou 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 as permissões necessárias para criar e gerenciar recursos do AppGroups. É possível conceder as permissões individualmente ou por uma função do Apigee que as inclua. Consulte Usuários e papéis para informações sobre o gerenciamento de usuários e papéis da Apigee.

Descrição Permissões
Gerenciar AppGroups e aplicativos e chaves associados.
  • apigee.appgroups.list
  • apigee.appgroups.get
  • apigee.appgroups.create
  • apigee.appgroups.update
  • apigee.appgroups.delete
Gerenciar apps do AppGroup.
  • apigee.appgroupapps.list
  • apigee.appgroupapps.get
  • apigee.appgroupapps.create
  • apigee.appgroupapps.manage
  • apigee.appgroupapps.delete
Gerenciar chaves de aplicativo para AppGroups:
  • apigee.appkeys.get
  • apigee.appkeys.create
  • apigee.appkeys.manage
  • apigee.appkeys.delete
Gerenciar assinaturas do AppGroup e configurações de monetização.
  • apigee.appgroupbalances.adjust
  • apigee.appgroupbalances.get
  • apigee.appgroupbalances.update
  • apigee.appgroupmonetizationconfigs.get
  • apigee.appgroupmonetizationconfigs.update
  • apigee.appgroupsubscriptions.create
  • apigee.appgroupsubscriptions.get
  • apigee.appgroupsubscriptions.list
  • apigee.appgroupsubscriptions.update

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
Conferir e gerenciar assinaturas de AppGroup para produtos de API https://cloud.google.com/apigee/docs/reference/apis/apigee/rest/v1/organizations.appgroups.subscriptions

Consulte também Gerenciamento de assinaturas do AppGroup.

Conferir e gerenciar configurações e saldos de monetização do AppGroup (se ativado) https://cloud.google.com/apigee/docs/reference/apis/apigee/rest/v1/organizations.appgroups.subscriptions

https://cloud.google.com/apigee/docs/reference/apis/apigee/rest/v1/organizations.appgroups.balance

Consulte também Usar o AppGroups para gerenciar assinaturas de produtos de API e Gerenciar saldos pré-pagos.

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.