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 dell'app è un processo separato, come descritto in Controllo dell'accesso alle API mediante la registrazione delle app.

Introduzione

Apigee offre molti vantaggi che dipendono completamente dal sapere chi chiama le tue API. Ad esempio, la sicurezza delle API, la gestione del traffico e una buona quantità di dati analitici dipendono dalla conoscenza di chi sta chiamando. 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 la funzionalità che integri nei tuoi proxy API, offrendoti il pieno controllo sull'accesso e sul comportamento delle API.

Per questo motivo, gli sviluppatori di app devono registrarsi per utilizzare le tue API. Una volta aggiunte, gli sviluppatori registrano le loro app, scelgono le API che vogliono utilizzare e ricevono le credenziali API uniche (chiavi e secret consumer) necessarie per accedere alle tue API.

Avviso:la sicurezza delle API, la gestione del traffico e l'analisi di sviluppatori/app dipendono dalla corretta configurazione del proxy API. Ad esempio, devi aggiungere i criteri giusti ai tuoi proxy, come la convalida della chiave API o la verifica del token di accesso OAuth, l'applicazione della quota limitazione di frequenzaza. Questi criteri identificano lo sviluppatore e l'app specifici che effettuano la chiamata, il che a sua volta consente l'applicazione della sicurezza delle API, la gestione del traffico specifica per sviluppatori o app, l'acquisizione di analisi delle API e altre funzionalità. Tecnicamente, potresti sviluppare API aperte che non controllano le chiavi API o i token di accesso, il che significa che non dovresti registrare gli sviluppatori. Tuttavia, lo sconsigliamo vivamente perché perdi la sicurezza dell'API, il controllo sulle prestazioni (tramite una buona gestione del traffico), i dati di analisi e altri importanti vantaggi offerti da Apigee.

Come registrare gli sviluppatori di app

Registra gli sviluppatori di app utilizzando uno dei seguenti metodi:

• Se hai un account Apigee a pagamento, gli sviluppatori possono registrarsi autonomamente tramite un portale per sviluppatori. Per maggiori informazioni, consulta una delle seguenti sezioni in base al tipo di portale per sviluppatori:
  • Portale integrato: creazione di un account utente sul portale integrato
  • Drupal 10: registra uno sviluppatore di app
• Gli amministratori possono registrare gli sviluppatori di app utilizzando l'API.
• In qualità di amministratore del portale per sviluppatori, gestisci gli sviluppatori direttamente sul tuo portale, come descritto nelle sezioni seguenti:
  • Portale integrato: Gestione utenti per gestire gli account utente.
    Nota:dopo che un utente ha creato un'app sul portale integrato, come descritto in questa sezione, le informazioni dell'account utente vengono sincronizzate e rese disponibili su Apigee nella pagina Sviluppatori. Il record dello sviluppatore dell'app è associato all'account utilizzando l'indirizzo email dell'utente. Per ulteriori informazioni su dove vengono memorizzati l'account e le informazioni associate all'app, consulta l'articolo Dove vengono memorizzati i dati dell'account sviluppatore di app.
  • Drupal 10: scopri come gli sviluppatori di app interagiscono con il modulo Apigee
• In qualità di amministratore dell'organizzazione, gestisci gli sviluppatori utilizzando l'interfaccia utente o l'API di Apigee, come descritto nelle sezioni seguenti.

Nota:quando gli utenti del portale creano un team nel portale integrato, le informazioni sul team di sviluppatori vengono memorizzate su Apigee e viene generato un indirizzo email univoco e generato automaticamente che funge da chiave primaria utilizzata da Apigee per identificare il team di sviluppatori. Per ulteriori informazioni, vedi Dove vengono archiviate le informazioni del team di sviluppo (beta).

Consigli per la gestione degli account utente sui portali per sviluppatori

Apigee consiglia di gestire gli account utente direttamente sul 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 sul portale per sviluppatori offre i seguenti vantaggi:

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

  Quando aggiungi o modifichi uno sviluppatore utilizzando 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.

• Tutte le 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.

Esplorare la pagina Sviluppatori

Accedi ed esplora la pagina Sviluppatori utilizzando la UI di Apigee.

Nota:per i portali integrati, gli account utente vengono gestiti come descritto in Gestione degli utenti. Dopo che uno sviluppatore crea un'app sul portale integrato, come descritto in Registrazione di app, viene creato un record sviluppatore separato per monitorare le app associate all'account utente e a cui è possibile accedere nella pagina Sviluppatori. Il record dello sviluppatore è associato all'indirizzo email dell'utente.

Per accedere alla pagina Distribuzione > Sviluppatori:

Vai a Sviluppatori

La pagina Sviluppatori ti consente di:

• Aggiungere uno sviluppatore
• Visualizza e modifica i dettagli dello sviluppatore, tra cui:
• Gestire gli attributi utente personalizzati
• Attivare o disattivare uno sviluppatore
• Esportare i dati di pubblicazione
• Eliminare uno sviluppatore
• Cercare nell'elenco degli sviluppatori

Aggiungere uno sviluppatore

Per aggiungere uno sviluppatore:

1. Accedi alla pagina Sviluppatori.
2. Fai clic su + Crea.
3. Inserisci i dati dello sviluppatore, inclusi nome, cognome, indirizzo 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 ed 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, vedi Attivare e disattivare uno sviluppatore.

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

• 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 su token OAuth ed entità KMS.

Gestire gli 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 il quale 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 infine su Salva.

Attivazione e disattivazione di uno sviluppatore

Quando uno sviluppatore di app si registra autonomamente nel tuo portale, puoi configurare se è 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 lo stato approvato (o altro), così come le chiavi API, anche se non sono valide mentre lo sviluppatore è inattivo.

Nota:quando disattivi uno sviluppatore, potrebbero essere necessari alcuni minuti prima che la modifica venga aggiornata su tutti i processori di messaggi. Fino ad allora, alcune chiamate dell'app dello sviluppatore potrebbero andare a buon fine.

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 delle esigenze.
5. Fai clic su Salva.
6. Ripeti i passaggi se lo sviluppatore fa parte di più organizzazioni.

Esportare i 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 saperne di più sui bucket, consulta le seguenti risorse:

• Informazioni sui bucket Cloud Storage
• Crea un bucket
• Elenco dei bucket

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 console Google Cloud , vai alla pagina Distribuzione > Sviluppatori.

     Vai a Sviluppatori

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

     Vai ad App

   • Nella console Google Cloud , 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 della richiesta di eliminazione è 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 proto, quindi la documentazione proto può essere utilizzata come riferimento per le strutture dei dati esportati. Vedi:
  • Sviluppatori
  • App
  • API Products
• A differenza della UI classica di Apigee, ogni risorsa ha un pulsante di esportazione indipendente e dedicato.
• Le esportazioni CSV non elencano campi ripetuti o nidificati dal proto perché non possono essere rappresentati correttamente in una struttura di dati tabellare. Per ottenere queste informazioni, è necessario utilizzare l'esportazione JSON.
• I file esportati vengono denominati ExportFinal_{hash}.

Eliminazione di uno sviluppatore

Avviso:l'eliminazione degli sviluppatori comporta la rimozione completa di questi ultimi e dei relativi artefatti (come app e chiavi API) dalla tua organizzazione. Per evitare di eliminare definitivamente gli sviluppatori e i relativi artefatti, valuta la possibilità di disattivare gli sviluppatori.

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, poi fai clic 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 utilizzando Apigee non vengono propagate al portale. Devi accedere al portale come amministratore del portale e sincronizzare il portale con Apigee affinché le modifiche vengano visualizzate sul portale.

Nota:se utilizzi il portale per sviluppatori basato su Drupal, Apigee consiglia di gestire gli sviluppatori di app direttamente sul portale, non utilizzando Apigee. Consulta Consigli per la gestione degli account utente sui portali per sviluppatori.

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

Drupal 10: Sincronizzare gli sviluppatori con Apigee

Gestione degli sviluppatori utilizzando l'API

Gestisci gli sviluppatori utilizzando le API per sviluppatori.