Registrazione degli sviluppatori di app

Questa pagina si applica ad Apigee e Apigee hybrid.

Visualizza la documentazione di Apigee Edge.

Registra e gestisci gli sviluppatori di app, come descritto nelle sezioni seguenti. La registrazione delle app è un processo distinto, come descritto in Controllo dell'accesso alle API mediante la registrazione delle app.

Introduzione

Apigee offre molti vantaggi che dipendono completamente dalla conoscenza di chi chiama le tue API. Ad esempio, la sicurezza delle API, la gestione del traffico e una buona quantità di dati di analisi dipendono dal sapere chi effettua la chiamata. E come fa Apigee a sapere chi chiama le tue API? Leggendo informazioni univoche in ogni chiamata API, ad esempio un ID utente, una chiave API o un token OAuth. Queste informazioni uniche bloccano o sbloccano le funzionalità integrate nei proxy API, dandoti il pieno controllo sull'accesso e sul comportamento delle API.

Ecco perché gli sviluppatori di app devono registrarsi per utilizzare le tue API. Una volta aggiunti, gli sviluppatori registrano le proprie app, scelgono le API che vogliono utilizzare e ricevono le credenziali API univoche (chiavi consumer e secret) necessarie per accedere alle tue API.

Come registrare gli sviluppatori di app

Registra gli sviluppatori di app utilizzando uno dei seguenti metodi:

Consigli per la gestione degli account utente sui portali per sviluppatori

Apigee consiglia di gestire gli account utente direttamente nel tuo portale per sviluppatori.

Se utilizzi il portale integrato, questo è l'unico modo per assicurarti che gli account utente sul portale integrato e su Apigee rimangano sincronizzati.

Se utilizzi il portale per sviluppatori basato su Drupal, la gestione degli account utente direttamente nel portale per sviluppatori offre i seguenti vantaggi:

  • Quando aggiungi uno sviluppatore tramite l'interfaccia di amministrazione del portale, puoi impostare la password dello sviluppatore per il portale e attivare l'invio di un messaggio email automatico allo sviluppatore.

    Quando aggiungi o modifichi un sviluppatore che utilizza Apigee, non viene inviata alcuna email allo sviluppatore e non puoi impostare la password per lo sviluppatore sul portale. Pertanto, lo sviluppatore deve reimpostare la password sul portale prima di poter accedere.

  • Eventuali modifiche apportate all'account sviluppatore sul portale vengono inviate automaticamente ad Apigee.

Se decidi di gestire gli account utente basati su Drupal utilizzando Apigee, devi sincronizzare gli sviluppatori di app tra il portale e Apigee.

Esplorazione della pagina Sviluppatori

Accedi ed esplora la pagina Sviluppatori utilizzando l'interfaccia utente di Apigee.

Per accedere alla pagina Distribuzione > Sviluppatori:

Vai a Developers

La pagina Sviluppatori ti consente di:

Aggiunta di uno sviluppatore

Per aggiungere uno sviluppatore:

  1. Accedi alla pagina Sviluppatori.
  2. Fai clic su + Crea.
  3. Inserisci i dettagli dello sviluppatore, inclusi nome, cognome, email e nome utente.
  4. Fai clic su Aggiungi.

Vedi anche Gestire gli utenti.

Visualizzazione e modifica dei dettagli dello sviluppatore

Visualizzare e modificare i dettagli dello sviluppatore.

Per visualizzare e modificare i dettagli dello sviluppatore:

  1. Accedi alla pagina Sviluppatori.
  2. Fai clic sulla riga dello sviluppatore che vuoi visualizzare e modificare per aprire i dettagli dello sviluppatore.
  3. Nella sezione Dettagli vengono visualizzate le seguenti informazioni. Fai clic su Modifica per modificare i dettagli dello sviluppatore, se necessario.
    Dettagli Descrizione
    Dettagli Nome, cognome, nome utente e indirizzo email dello sviluppatore; stato e durata della registrazione; ID sviluppatore.
    Attributi personalizzati Attributi personalizzati definiti per lo sviluppatore. Configura gli attributi personalizzati, se necessario. Per ulteriori informazioni, vedi Gestire gli attributi personalizzati per uno sviluppatore
    App App registrate dallo sviluppatore. Consulta Controllo dell'accesso alle API mediante la registrazione delle app.
  4. Attiva o disattiva lo sviluppatore nel campo Stato.
    Per ulteriori informazioni, consulta Attivare e disattivare uno sviluppatore.

Apigee mantiene memorizzate nella cache le seguenti entità per un minimo di 180 secondi dopo che sono state accese.

  • Token di accesso OAuth. Ciò significa che l'elemento ExpiresIn nel criterio OAuth v2 non potrà far scadere un token di accesso in meno di 180 secondi.
  • Entità Key Management Service (KMS) (app, sviluppatori, prodotti API).
  • Attributi personalizzati sui token OAuth e sulle entità KMS.

Gestione degli attributi personalizzati per uno sviluppatore

Aggiungi fino a 18 attributi personalizzati per ogni sviluppatore.

Per gestire gli attributi personalizzati:

  1. Accedi alla pagina Sviluppatori.
  2. Fai clic sulla riga dello sviluppatore per cui vuoi gestire gli attributi personalizzati per aprire i dettagli dello sviluppatore.
  3. Fai clic su Modifica.
  4. Fai clic su + Aggiungi attributo nella sezione Attributi personalizzati.
  5. Inserisci il nome e il valore dell'attributo.
  6. Fai clic su Salva.
  7. Per eliminare un attributo personalizzato, fai clic su Modifica, poi su Elimina e poi su Salva.

Attivazione e disattivazione di uno sviluppatore

Quando uno sviluppatore di app si registra autonomamente nel tuo portale, puoi configurare se deve essere attivo o meno per impostazione predefinita.

Quando uno sviluppatore è inattivo, può comunque accedere al portale per gli sviluppatori e creare app, ma nessuna delle chiavi API corrispondenti funzionerà. Le app dello sviluppatore mantengono il loro stato approvato (o altro), così come le chiavi API, anche se non sono valide mentre lo sviluppatore è inattivo.

Per attivare o disattivare uno sviluppatore:

  1. Accedi alla pagina Sviluppatori.
  2. Fai clic sulla riga dello sviluppatore che vuoi attivare o disattivare per aprire i dettagli dello sviluppatore.
  3. Fai clic su Modifica.
  4. Nella sezione Dettagli, imposta il campo Stato su Attivo o Non attivo, a seconda dei casi.
  5. Fai clic su Salva.
  6. Ripeti i passaggi se lo sviluppatore fa parte di più organizzazioni.

Esportazione dei dati di pubblicazione

Questa sezione descrive come esportare i dati di pubblicazione per sviluppatori, app o prodotti API come file CSV (valori separati da virgole) o JSON.

Prerequisiti:

  • Bucket Cloud Storage
  • Accesso in lettura ai dati che stai esportando
  • Accesso in lettura e scrittura al bucket Cloud Storage

Per ulteriori informazioni sui bucket, consulta quanto segue:

Per esportare i dati di pubblicazione:

  1. Crea il bucket Cloud Storage o recupera il nome di un bucket esistente.
  2. Accedi a una delle seguenti pagine:

    • Nella Google Cloud console, vai alla pagina Distribuzione > Sviluppatori.

      Vai a Developers

    • Nella Google Cloud console, vai alla pagina Distribuzione > App.

      Vai ad App

    • Nella Google Cloud console, vai alla pagina Distribuzione > Prodotti API.

      Vai a Prodotti

  3. Fai clic su Esporta.
  4. Viene visualizzata la finestra di dialogo Salva tabella come. Digita il nome del bucket Cloud Storage e specifica il formato di esportazione: JSON o CSV.
  5. Fai clic su Salva. Viene avviata un'operazione a lunga esecuzione (LRO). Lo stato LRO viene visualizzato nell'icona Notifica.
  6. Al termine dell'esportazione, fai clic su Scarica nella notifica. Si apre la pagina del bucket Cloud Storage per il file.
  7. Fai clic su Scarica. Il file viene scaricato sulla tua macchina locale.
Note sui dati esportati:
  • La struttura dei dati esportati segue esattamente le definizioni di proto, pertanto la documentazione di proto può essere utilizzata come riferimento per le strutture dei dati esportati. Consulta:
  • A differenza dell'interfaccia utente Apigee Classic, ogni risorsa ha un pulsante di esportazione indipendente e dedicato.
  • Le esportazioni in formato CSV non elencano i campi ripetuti o nidificati del proto poiché non possono essere rappresentati correttamente in una struttura di dati di tabella. Per ottenere queste informazioni, è necessario utilizzare l'esportazione in formato JSON.
  • I file esportati vengono denominati ExportFinal_{hash}.

Eliminazione di uno sviluppatore

Per eliminare uno sviluppatore:

  1. Accedi alla pagina Sviluppatori.
  2. Posiziona il cursore sulla riga dello sviluppatore che vuoi eliminare.
  3. Fai clic su Altro, quindi su Elimina.
  4. Fai clic su Elimina per confermare l'eliminazione.

Sincronizzazione degli sviluppatori di app tra il portale e Apigee

Se utilizzi un portale per sviluppatori basato su Drupal per pubblicare le tue API, le modifiche apportate agli sviluppatori di app che utilizzano Apigee non vengono propagate al portale. Per visualizzare le modifiche nel portale, devi accedere al portale come amministratore e sincronizzarlo con Apigee.

.

Per sincronizzare il tuo portale per sviluppatori con gli sviluppatori di app definiti su Apigee, consulta la sezione seguente:

Drupal 10: sincronizzare gli sviluppatori con Apigee

Gestione degli sviluppatori che utilizzano l'API

Gestisci gli sviluppatori utilizzando le API per sviluppatori.