Como conseguir credenciais de cliente

Esta é a documentação do Apigee Edge.
Acesse Documentação da Apigee X.
informações

Este tópico mostra como conseguir credenciais de cliente (também chamadas de chaves de desenvolvedor) para fins de desenvolvimento e teste usando um app e um produto de desenvolvedores prontos para uso. Para situações de produção, as etapas são semelhantes, mas você pode usar seus próprios apps para desenvolvimento, produtos e outras entidades.

O que são credenciais de clientes?

Para participar de qualquer fluxo do OAuth 2.0, todos os apps cliente precisam ser registrados no Apigee Edge (o servidor de autorização). Ao registrar o app, você receberá duas chaves: a Consumer ID e a Consumer Secret. A Consumer ID é uma chave pública. Já a Consumer Secret é particular e não deve ser exposta. Essas chaves de credencial do cliente permitem que o Apigee Edge identifique exclusivamente o app cliente.

Etapas rápidas

Estas etapas rápidas mostram como conseguir chaves de desenvolvedor para um dos apps prontos para uso, configurados quando você criou a organização do Apigee Edge. É possível usar essas chaves principalmente para desenvolvimento e teste:

  1. Acesse a página "Apps do desenvolvedor", conforme descrito abaixo.

    Edge

    Para acessar a página "Apps do desenvolvedor" usando a interface do Edge:

    1. Faça login em apigee.com/edge.
    2. Selecione Publicar > Apps na barra de navegação à esquerda.
    3. Clique em +Proxy.

    Edge clássico (nuvem privada)

    Para acessar a página "Apps do desenvolvedor" usando a interface clássica do Edge:

    1. Faça login em http://ms-ip:9000, em que ms-ip é o endereço IP ou o nome DNS do nó do servidor de gerenciamento.
    2. Selecione Publicar > Apps do desenvolvedor na barra de navegação superior.
  2. Clique em App "Previsão do tempo" para abrir a página de visão geral do app "Previsão do tempo". Observe que o desenvolvedor associado ao app é Nicolai Tesla. Este app e o desenvolvedor foram provisionados por padrão quando a organização foi criada. Todos os apps precisam ser associados a um desenvolvedor.
  3. Na seção Produtos, ao lado do produto "API de clima premium", clique em Mostrar para ver os valores de Consumer ID e de Consumer Secret.
  4. Copie e salve esses dois valores. Você precisará usá-los mais tarde para fazer chamadas de API para receber tokens de acesso.

Como receber credenciais de cliente com as APIs do Edge

Você também pode obter a chave e o segredo do cliente para um aplicativo chamando a API de gerenciamento. Primeiro, consiga a lista de apps na organização fazendo a seguinte chamada de API:

$ curl https://api.enterprise.apigee.com/v1/o/{org_name}/apps \
-u email:password 

Essa chamada retorna uma lista de apps por ID do app.

[ "da496fae-2a04-4a5c-b2d0-709278a6f9db", "50e3e831-175b-4a05-8fb6-05a54701af6e" ]

É possível recuperar o perfil de um app fazendo uma chamada GET simples no ID do app:

$ curl https://api.enterprise.apigee.com/v1/o/{org_name}/apps/{app_id} \
-u email:password 

Exemplo:

$ curl https://api.enterprise.apigee.com/v1/o/{org_name}/apps/da496fae-2a04-4a5c-b2d0-709278a6f9db \
-u email:password 

A chamada de API retorna o perfil do app que você especificou. Por exemplo, um perfil do aplicativo weatherapp tem a seguinte representação JSON:

{
  "accessType" : "read",
  "apiProducts" : [ ],
  "appFamily" : "default",
  "appId" : "da496fae-2a04-4a5c-b2d0-70928a6f9db",
  "attributes" : [ ],
  "callbackUrl" : "http://weatherapp.com",
  "createdAt" : 1380290158713,
  "createdBy" : "noreply_admin@apigee.com",
  "credentials" : [ {
    "apiProducts" : [ {
      "apiproduct" : "PremiumWeatherAPI",
      "status" : "approved"
    } ],
    "attributes" : [ ],
    "consumerKey" : "bBGAQrXgivA9lKu7NMPyYpVKNhGar6K",
    "consumerSecret" : "hAr4Gn0gA9vyvI4",
    "expiresAt" : -1,
    "issuedAt" : 1380290161417,
    "scopes" : [ ],
    "status" : "approved"
  } ],
  "developerId" : "5w95xGkpnjzDBT4",
  "lastModifiedAt" : 1380290158713,
  "lastModifiedBy" : "noreply_admin@apigee.com",
  "name" : "weatherapp",
  "scopes" : [ ],
  "status" : "approved"
}

Observe os valores de consumerKey e consumerSecret.

Explicações detalhadas

Para ver uma discussão mais detalhada sobre o registro e o gerenciamento de chaves do app, consulte Registrar apps e gerenciar chaves de API.