Registar apps de cliente

Esta página aplica-se ao Apigee e ao Apigee Hybrid.

Veja a documentação do Apigee Edge.

Para participar nos fluxos OAuth 2.0 no Apigee, as apps cliente têm de estar registadas.

O que é o registo?

O registo permite que o Apigee (o servidor de autorizações) identifique exclusivamente a sua app. Quando regista a sua app, recebe duas chaves: um ID de cliente e um segredo do cliente. A app precisa destas chaves quando negoceia tokens de acesso com o servidor de autorização.

Passos rápidos

Para registar uma nova app, na página Apps:

Consola do Apigee Cloud

1. Na Google Cloud consola, aceda à página Distribuição > Apps.

   Aceda a Apps

2. Clique em Criar.
3. Especifique os detalhes da app, conforme descrito na tabela seguinte:

   Campo	Descrição	Obrigatório?
   Nome da aplicação	Nome da app. Não pode alterar o nome depois de criar a app. Este nome é usado em chamadas da API Apigee.	Obrigatória
   Nome a apresentar	Nome a apresentar da app que aparece na IU do Apigee e no portal do programador.	Opcional
   Programador	Selecione um nome de programador no menu pendente. Nota: por motivos de desempenho, nem todos os programadores são apresentados no menu pendente. Comece a escrever o nome ou o email do programador na caixa de pesquisa. Os valores do menu pendente são automaticamente refinados para corresponderem ao texto que está a escrever. Consulte também o artigo Registe programadores de apps.	Obrigatória
   URL de retorno	Normalmente, especifica o URL de uma app designada para receber um código de autorização em nome da app cliente. Este valor não é obrigatório para todos os produtos API.	Opcional
   Notas	Notas descritivas para a app.	Opcional

   Nota: os detalhes da app também incluem um ID da app que só é visível e editável a partir da API e não da IU. Consulte Recurso REST: organizations.developers.apps.
4. Especifique as credenciais, incluindo a data de validade da chave da API, o estado e os produtos API associados. Na secção Credenciais, clique em Adicionar credencial e introduza as seguintes informações:

   Campo	Descrição
   Expira	Selecione uma duração ou uma data de validade, ou defina a chave da API para que nunca expire.
   Produtos	Associe um ou mais produtos API à chave da API: Clique em Adicionar produtos. Selecione um ou mais produtos de API na lista. Nota: tem de selecionar, pelo menos, um produto da API. Clique em OK. Clique em Adicionar.

5. Defina o Estado como Aprovado ou Revogado para cada produto da API. Se adicionou um produto API à credencial que requer aprovação manual, é apresentado Pending approval status. Caso contrário, é apresentado Approved. Neste passo, pode alterar o estado de aprovação.
   1. Na lista de Produtos na secção Credenciais, selecione um ou mais produtos da lista.
   2. Clique em Aprovar ou Revogar.
6. Clique em Criar.
7. Encontre a nova app na lista de apps de programador e selecione-a.
8. Clique em para ver os valores da chave (ID de cliente) e do segredo (segredo do cliente).

IU clássica

1. Aceda à página Apps do programador, conforme descrito abaixo.

   Para aceder à página Apps do programador:

   1. Abra a IU do Apigee.
   2. Selecione Publicar > Apps na barra de navegação do lado esquerdo.
   3. Clique em + App
   4. Preencha o formulário:
      1. Introduza um nome e um nome a apresentar para a app.
      2. Selecione um programador (pode escolher um dos programadores predefinidos ou criar o seu próprio).
      3. (Opcional) Introduza um URL de retorno. Isto é usado para fluxos do tipo de autorização OAuth "trilaterais". É aqui que o Apigee redireciona o utilizador depois de concluir a autenticação (início de sessão) com o servidor de recursos. Tem de ser um URL completo, pelo que pode introduzir algo como https://www.example.com. Para saber mais sobre o OAuth de três partes, consulte o artigo Implementar o tipo de concessão de código de autorização.
      4. Adicione um produto API. Pode selecionar um produto existente ou criar o seu próprio.
      5. Ignore a secção de atributos personalizados por agora.
      6. Clique em Criar.
   5. Encontre a nova app na lista de apps de programador e selecione-a.
   6. Clique em Mostrar para ver os valores do ID do consumidor (ID de cliente) e do segredo do consumidor (segredo do cliente).

Mais informações

Para uma discussão mais detalhada sobre o registo de apps, consulte o artigo Registe apps e faça a gestão das chaves da API. Se quiser saber mais sobre a função dos produtos de API, consulte o artigo O que é um produto de API?.