Récupérer les identifiants client

Vous consultez la documentation d'Apigee Edge.
Consultez la documentation 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 du développeur", comme décrit ci-dessous.

    Périphérie

    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 correspond à l'adresse IP ou au nom DNS du nœud du serveur de gestion.
    2. Sélectionnez Publish > Developer Apps (Publier > Applications de développement) 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. 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. Un développeur doit être associé à toutes les applications de développement.
  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é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.