Récupérer les identifiants client

Vous consultez la documentation Apigee Edge.
Accédez à la documentation**Apigee X**. info

Cette rubrique explique comment obtenir des identifiants client (également appelés clés de développement) à des fins de développement et de test, à l'aide d'une application et d'un produit de développement prêts à l'emploi. En production, les étapes sont similaires, mais vous devez utiliser vos propres applications de développement, produits et autres entités.

Quels sont les identifiants client ?

Pour participer à un flux OAuth 2.0, toutes les applications clientes doivent être enregistrées auprès d'Apigee Edge (le serveur d'autorisation). Lorsque vous enregistrez votre application, deux clés vous sont attribuées : l'ID client et le secret client. L'ID client est une clé publique et le secret client ne doit jamais être divulgué publiquement. Ces clés d'identification client permettent à Apigee Edge d'identifier de manière unique l'application cliente.

Procédure rapide

Cette procédure rapide vous montre comment obtenir des clés de développement pour l'une des applications prêtes à l'emploi configurées lors de la création de votre organisation Apigee Edge. Utilisez principalement ces clés à fin de développement et de tests :

1. Accédez à la page "Applications de développement" comme décrit ci-dessous.

   Edge

   Pour accéder à la page "Applications de développement" à l'aide de l'interface utilisateur Edge :

   1. Connectez-vous à apigee.com/edge.
   2. Sélectionnez Publier > Applications dans la barre de navigation de gauche.
   3. Cliquez sur +Proxy

   Classic Edge (Private Cloud)

   Pour accéder à la page "Applications de développement" à l'aide de l'interface utilisateur Classic Edge :

   1. Connectez-vous à http://ms-ip:9000, où ms-ip est l' adresse IP ou le nom DNS du nœud de serveur de gestion.
   2. Sélectionnez Publier > Applications de développement dans la barre de navigation supérieure.
2. Cliquez sur Weather App pour ouvrir la page de présentation de l'application météo. Notez que le développeur associé à l'application est Nicolai Tesla. Cette application et ce développeur ont été provisionnés par défaut lors de la création de votre organisation. Toutes les applications de développement doivent être associées à un développeur.
3. Dans la section Produits, à côté du produit API Premium Weather, cliquez sur Afficher pour afficher les valeurs de l'ID client et du secret client.
4. Copiez et enregistrez ces deux valeurs. Vous devrez les utiliser ultérieurement pour effectuer des appels d'API afin d'obtenir des jetons d'accès.

Obtenir les identifiants client avec les API Edge

Vous pouvez également obtenir la clé client et le secret pour une application en appelant l'API de gestion. Récupérez d'abord la liste des applications de votre organisation en lançant l'appel d'API suivant :

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

Cet appel renvoie une liste d'applications triée par ID d'application.

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

Vous pouvez récupérer le profil d'une application en effectuant un simple appel GET sur l'ID d'application :

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

Exemple :

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

L'appel d'API renvoie le profil de l'application que vous avez spécifiée. Par exemple, un profil d'application pour weatherapp a la représentation JSON suivante :

{
  "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"
}

Notez les valeurs de consumerKey et consumerSecret.

Explications détaillées

Pour en savoir plus sur l'enregistrement des applications et la gestion des clés, consultez l'article Enregistrer des applications et gérer les clés API.