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 la funzionalità integrata 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.

Avviso: la sicurezza delle API, la gestione del traffico e gli analytics per sviluppatori/app dipendono dalla configurazione corretta del proxy API. Ad esempio, devi aggiungere i criteri giusti ai proxy, come la convalida delle chiavi API o la verifica del token di accesso OAuth, l'applicazione delle quote e limitazione di frequenza. Questi criteri identificano lo sviluppatore e l'app specifici che stanno effettuando la chiamata, il che a sua volta consente l'applicazione della sicurezza delle API, la gestione del traffico specifico per sviluppatori o app, l'acquisizione di dati e analisi delle API e altre funzionalità. Tecnicamente, potresti sviluppare API aperte che non controllano la presenza di chiavi API o token di accesso, il che significa che non dovrai necessariamente registrare gli sviluppatori. Tuttavia, sconsigliamo vivamente questa opzione, perché perderesti la sicurezza delle API, il controllo sul rendimento (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 ulteriori 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: Registrare 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 nel tuo portale, come descritto nelle seguenti sezioni:
  • Portale integrato: Gestione degli utenti per gestire gli account utente.
    Nota: dopo che un utente ha creato un'app nel portale integrato, come descritto in questa sezione, i dati dell'account utente vengono sincronizzati e sono disponibili su Apigee nella pagina Sviluppatori. Il record dello sviluppatore dell'app è associato all'account tramite l'indirizzo email dell'utente. Per ulteriori informazioni su dove vengono archiviate le informazioni dell'account e dell'app associata, consulta Dove vengono archiviate le informazioni dell'account sviluppatore di app.
  • Drupal 10: scopri come gli sviluppatori di app interagiscono con il modulo Apigee Edge
• 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 del team di sviluppatori vengono memorizzate in Apigee e viene generato un indirizzo email univoco generato automaticamente che funge da chiave primaria utilizzata da Apigee per identificare il team di sviluppatori. Per ulteriori informazioni, consulta Dove vengono archiviate le informazioni del team di sviluppatori (beta).

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.

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

Per accedere alla pagina Sviluppatori:

• Se utilizzi l'interfaccia utente di Apigee nella console Cloud: seleziona Distribuzione > Sviluppatori.
• Se utilizzi la UI Apigee classica: seleziona Pubblica > Sviluppatori.

La pagina Sviluppatori ti consente di:

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

Aggiunta di uno sviluppatore

Per aggiungere uno sviluppatore:

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

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. Modifica 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. Per modificare i dettagli dello sviluppatore, fai clic in uno dei seguenti campi: Nome Cognome Email Nome utente Modifica i contenuti e premi Invio per confermare la modifica.
   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 del 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 + nella sezione Attributi personalizzati.
4. Inserisci il nome e il valore dell'attributo.
5. Fai clic su .
6. Per eliminare un attributo personalizzato, posiziona il cursore sopra l'attributo e fai clic su nel menu delle azioni.

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.

Nota: quando disattivi uno sviluppatore, potrebbero essere necessari alcuni minuti prima che la modifica venga aggiornata su tutti i processori dei 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. Nella sezione Dettagli, imposta il campo Stato su Attivo o Non attivo, a seconda dei casi.
4. Ripeti i passaggi se lo sviluppatore fa parte di più organizzazioni.

Esportazione dei dati di pubblicazione

Esporta i seguenti dati di pubblicazione come file con valori separati da virgole (CSV):

• Dettagli sviluppatore
• Dettagli dei prodotti per sviluppatori, applicazioni e API

Per esportare i dati di pubblicazione:

1. Accedi alla pagina Sviluppatori.
2. Fai clic su Esporta CSV….
3. Seleziona Sviluppatori o Sviluppatori, app e prodotti dal menu a discesa.

I dati di pubblicazione selezionati vengono scaricati come file CSV.

Eliminazione di uno sviluppatore

Avviso: l'eliminazione degli sviluppatori comporta la rimozione completa di questi e dei relativi elementi correlati (ad esempio app e chiavi API) dalla tua organizzazione. Per evitare di eliminare definitivamente gli sviluppatori e i relativi elementi, ti consigliamo di disattivare gli sviluppatori.

Per eliminare uno sviluppatore:

1. Accedi alla pagina Sviluppatori.
2. Posiziona il cursore del mouse sulla riga dello sviluppatore che vuoi eliminare per visualizzare il menu delle azioni.
3. Fai clic su .
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.

Nota: se utilizzi il portale per sviluppatori basato su Drupal, Apigee consiglia di gestire gli sviluppatori di app direttamente sul tuo portale, senza utilizzare Apigee. Consulta i consigli per la gestione degli account utente sui portali per sviluppatori

.

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.