Obtenção de credenciais de cliente

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

Veja a documentação do Apigee Edge.

Este tópico aborda a obtenção de credenciais de cliente (também denominadas chaves de programador) para utilização no fluxo de autorização OAuth 2.0.

O que são credenciais do cliente?

Para participar em qualquer fluxo de autorização OAuth 2.0, todas as apps cliente têm de estar registadas no Apigee (o servidor de autorizações). Quando regista a sua app, são-lhe atribuídas duas credenciais: uma chave e um segredo. A chave é uma chave pública e o segredo nunca deve ser tornado público. Estas chaves de credenciais permitem ao Apigee identificar exclusivamente a app cliente.

Nota: terminologia: a especificação OAuth 2.0 da IETF refere-se às credenciais do cliente como o identificador do cliente e o segredo do cliente. A IU do Apigee refere-se a eles como a chave e o segredo das credenciais. Estes termos são sinónimos.

Obter a chave e o segredo na IU do Apigee

Consulte o artigo Ver uma chave da API e um segredo.

Obter a chave e o segredo com as APIs Apigee

Use uma API para obter a lista de apps na sua organização:

curl "https://apigee.googleapis.com/v1/organizations/$ORG/apps" \
  -H "Authorization: Bearer $TOKEN"

Onde $TOKEN está definido como a sua chave de acesso OAuth 2.0, conforme descrito em Obter uma chave de acesso OAuth 2.0. Para informações sobre as opções de curl usadas neste exemplo, consulte a secção Usar o curl. Para uma descrição das variáveis de ambiente que pode usar, consulte o artigo Definir variáveis de ambiente para pedidos de API Apigee.

Esta chamada devolve uma lista de apps por ID da app.

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

Para aceder ao perfil de uma app:

curl "https://apigee.googleapis.com/v1/organizations/$ORG/apps/$APP" \
   -H "Authorization: Bearer $TOKEN"

Onde $TOKEN está definido como a sua chave de acesso OAuth 2.0, conforme descrito em Obter uma chave de acesso OAuth 2.0. Para informações sobre as opções de curl usadas neste exemplo, consulte a secção Usar o curl. Para uma descrição das variáveis de ambiente que pode usar, consulte o artigo Definir variáveis de ambiente para pedidos de API Apigee.

Por exemplo:

$ curl https://apigee.googleapis.com/v1/o/organizations/myorg/apps/da496fae-2a04-4a5c-b2d0-709278a6f9db \
  -H "Authorization: Bearer $TOKEN"

A API devolve o perfil da app que especificou. Por exemplo, um perfil de app para 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" : "[e-mail]",
  "credentials" : [ {
    "apiProducts" : [ {
      "apiproduct" : "PremiumWeatherAPI",
      "status" : "approved"
    } ],
    "attributes" : [ ],
    "consumerKey" : "bBGAQrXgivA9lKu7NMPyYpVKNhGar6K",
    "consumerSecret" : "hAr4Gn0gA9vyvI4",
    "expiresAt" : -1,
    "issuedAt" : 1380290161417,
    "scopes" : [ ],
    "status" : "approved"
  } ],
  "developerId" : "5w95xGkpnjzDBT4",
  "lastModifiedAt" : 1380290158713,
  "lastModifiedBy" : "[e-mail]",
  "name" : "weatherapp",
  "scopes" : [ ],
  "status" : "approved"
}

Tenha em atenção os valores de consumerKey e consumerSecret.