Récupérer les identifiants client

<ph type="x-smartling-placeholder"></ph> Vous consultez la documentation Apigee Edge.
Accédez à la page Documentation sur Apigee X. En savoir plus

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 pour les développeurs" comme décrit ci-dessous.

   Edge

   Pour accéder à la page des 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 (cloud privé)

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

   1. Connectez-vous à http://ms-ip:9000, où ms-ip est le Adresse IP ou nom DNS du nœud du serveur de gestion.
   2. Sélectionnez Publier > Applications de développeur dans la barre de navigation supérieure.
2. Cliquez sur Application Météo pour ouvrir la page de présentation de l'application Météo. Avertissement que le développeur associé à l'appli est Nicolai Tesla. Cette application et ce développeur ont été provisionnées par défaut lors de la création de votre organisation. Toutes les applications de développement doivent disposer d'un développeur qui leur est associé.
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é et le code secret client d'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é. 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.