Recupero delle credenziali del client

Stai visualizzando la documentazione di Apigee Edge.
Vai alla documentazione di Apigee X. informazioni

Questo argomento mostra come ottenere le credenziali client (dette anche chiavi sviluppatore) a scopo di sviluppo e test utilizzando un prodotto e un'app per sviluppatori pronti all'uso. Per le situazioni di produzione, i passaggi sono simili, ma dovrai utilizzare le tue app, i tuoi prodotti e altre entità per sviluppatori.

Che cosa sono le credenziali client?

Per partecipare a qualsiasi flusso OAuth 2.0, tutte le app client devono essere registrate con Apigee Edge (il server di autorizzazione). Quando registri la tua app, ti vengono assegnate due chiavi: Consumer ID (ID consumatore) e Consumer Secret (Segreto utente). L'ID consumatore è una chiave pubblica e il secret del consumatore non deve mai essere reso pubblico. Queste chiavi delle credenziali client consentono ad Apigee Edge di identificare in modo univoco l'app client.

Procedura rapida

Questi passaggi rapidi mostrano come ottenere le chiavi sviluppatore per una delle app pronte all'uso configurate al momento della creazione dell'organizzazione Apigee Edge. Puoi utilizzare queste chiavi principalmente per sviluppo e test:

  1. Accedi alla pagina App sviluppatore come descritto di seguito.

    Perimetrale

    Per accedere alla pagina App sviluppatore utilizzando l'interfaccia utente Edge:

    1. Accedi ad apigee.com/edge.
    2. Seleziona Pubblica > App nella barra di navigazione a sinistra.
    3. Fai clic su +Proxy

    Classic Edge (private cloud)

    Per accedere alla pagina App sviluppatore utilizzando l'interfaccia utente della versione classica di Edge:

    1. Accedi a http://ms-ip:9000, dove ms-ip è l'indirizzo IP o il nome DNS del nodo del server di gestione.
    2. Seleziona Pubblica > App sviluppatore nella barra di navigazione in alto.
  2. Fai clic su App Meteo per aprire la pagina di riepilogo dell'app Meteo. Nota che lo sviluppatore associato all'app è Nicolai Tesla. È stato eseguito il provisioning dell'app e dello sviluppatore per impostazione predefinita al momento della creazione dell'organizzazione. A tutte le app per sviluppatori deve essere associato uno sviluppatore.
  3. Nella sezione Prodotti, accanto al prodotto API Premium Weather, fai clic su Mostra per esporre i valori ID consumatore e Segreto consumatore.
  4. Copia e salva questi due valori. Dovrai utilizzarli in un secondo momento per effettuare chiamate API e ottenere i token di accesso.

Recupero delle credenziali client con le API Edge

Puoi anche ottenere la chiave e il segreto utente per un'app chiamando l'API di gestione. Per prima cosa, recupera l'elenco delle app della tua organizzazione effettuando la chiamata API seguente:

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

Questa chiamata restituisce un elenco di app in base all'ID.

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

Puoi recuperare il profilo di un'app effettuando una semplice chiamata GET sull'ID dell'app:

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

Ad esempio:

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

La chiamata API restituisce il profilo dell'app specificata. Ad esempio, un profilo dell'app per weatherapp ha la seguente rappresentazione 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"
}

Prendi nota dei valori di consumerKey e consumerSecret.

Approfondimento

Per una discussione più dettagliata sulla registrazione delle app e sulla gestione delle chiavi, consulta Registrare le app e gestire le chiavi API.