Organizar a propriedade da app cliente

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

Usar grupos de apps para organizar a propriedade das apps

Esta secção oferece uma vista geral dos grupos de apps e de como os gerir.

O que são AppGroups?

Um AppGroup representa uma relação entre uma ou mais apps geridas pelo mesmo conjunto de pessoas.

Um AppGroup está associado a outro sistema responsável pela gestão da lista de pessoas que partilham a responsabilidade por estas apps, como um portal. As apps do Apigee e os programadores do Apigee estão associados ao AppGroup.

Os grupos de apps oferecem:

  • Um método de organização e visualização da propriedade e das associações de apps.
  • A capacidade de criar uma lista de trabalhadores responsáveis por uma app para uma montra de API ou um portal. Por exemplo, pode configurar diferentes AppGroups para fins de faturação.
  • Flexibilidade para monitorizar a propriedade da app por parceiro, unidade de negócio, linha de produtos, divisão ou outras entidades empresariais.
  • Uma estrutura potencialmente de vários níveis para monitorizar a forma como as apps estão logicamente relacionadas com os proprietários e os programadores das apps.

Funções e autorizações do IAM

Para controlar as autorizações necessárias para a gestão de grupos de apps, pode ver e conceder funções através do painel de autorizações na página IAM e administração > IAM no seu projeto do Google Cloud.

Aceda a IAM e administração

A tabela seguinte lista a função e as autorizações individuais correspondentes necessárias para criar e gerir recursos AppGroups.

Nome da função de IAM Âmbito da função Autorizações necessárias Descrição
Administrador de programadores do Apigee Administrador de programadores de recursos do Apigee

Gerir grupos de apps:

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

Gerir apps do AppGroup:

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

Gerir chaves de apps para grupos de apps:

  • apigee.appkeys.get
  • apigee.appkeys.create
  • apigee.appkeys.manage
  • apigee.appkeys.delete
Permite a gestão de AppGroups e apps e chaves associadas. Os utilizadores com esta função têm a capacidade de gerir todos os aspetos dos grupos de apps, a menos que as autorizações individuais sejam removidas.

Visualizar e gerir grupos de apps

Esta secção mostra como ver e gerir grupos de apps. Pode gerir AppGroups e apps AppGroup através das APIs Apigee e portais Drupal.

Definições do grupo de apps

Os grupos de apps incluem estas definições:

Definição Descrição
Nome Obrigatório. O nome do grupo de apps. Os nomes dos grupos de apps têm de ser exclusivos numa organização.

Os carateres permitidos são carateres alfanuméricos e qualquer um dos seguintes carateres especiais: ._\-$ %.
ID do grupo de apps Criadas automaticamente e não editáveis. Criado no formulário "OrgName@@@AppGroupName". Por exemplo, com um nome da organização da Apigee XYZDev e um nome do grupo de apps ABCMarketing, o ID do grupo de apps é XYZDev@@@ABCMarketing.
Nome a apresentar Opcional. Um nome a apresentar amigável para o AppGroup.
channelId Opcional. Identifica o sistema responsável pela criação e gestão do AppGroup. Pode ser uma montra ou um mercado. Vários grupos de apps podem partilhar o mesmo channelId.
channelUri Opcional. Referência ao grupo de pessoas que partilham a responsabilidade pelo AppGroup. Muitas vezes, o channelUri tem um link ou faz referência a um grupo ou uma equipa num portal do programador ou outro sistema, como o módulo Drupal Teams da Apigee.

Gerir grupos de apps através de portais baseados no Drupal

O módulo Team do Apigee para Drupal funciona com grupos de apps no Apigee X e híbrido, e é a interface principal para gerir grupos de apps. Para ver informações sobre portais baseados no Drupal, consulte o artigo Crie o seu portal com o Drupal.

Gerir AppGroups através das APIs Apigee

Use estas APIs para gerir AppGroups nas suas organizações:

Atividades Link
Veja e faça a gestão de grupos de apps https://cloud.google.com/apigee/docs/reference/apis/apigee/rest/v1/organizations.appgroups
Veja e faça a gestão das apps que pertencem a AppGroups https://cloud.google.com/apigee/docs/reference/apis/apigee/rest/v1/organizations.appgroups.apps
Veja e faça a gestão das chaves de apps associadas a AppGroups https://cloud.google.com/apigee/docs/reference/apis/apigee/rest/v1/organizations.appgroups.apps.keys

Limitações e problemas conhecidos dos AppGroups

No Apigee hybrid, os AppGroups estão disponíveis nas versões 1.10.0 e posteriores.

Neste momento, os AppGroups não suportam a rentabilização.

Migração do Apigee Edge para utilizadores do Drupal

A migração de uma empresa-programador e da respetiva função envolve a criação de um AppGroup que represente a empresa e a adição da empresa-programador e das respetivas funções como atributos personalizados do AppGroup. A sintaxe esperada para armazenar esta informação é:

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

Usar a associação entre a app e o programador para organizar a propriedade da app

Um método de acompanhamento da propriedade da app menos abrangente e flexível do que os grupos de apps é o acompanhamento de apps por associação de programadores.

Para obter informações sobre a gestão de associações entre programadores e apps, consulte o artigo Registar programadores de apps para ver informações sobre o registo de programadores e apps associadas.