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

Introduzione

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

È per questo che gli sviluppatori di app devono registrarsi per utilizzare le tue API. Dopo l'aggiunta, gli sviluppatori registrano le proprie app, scelgono le API che vogliono utilizzare e ricevono le credenziali API univoche (chiavi e secret utente) necessarie per accedere alle API.

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

Come registrare gli sviluppatori di app

Registra gli sviluppatori di app utilizzando uno dei seguenti metodi:

• Se disponi di un account Apigee a pagamento, gli sviluppatori possono autoregistrarsi tramite un portale per sviluppatori. Per saperne di più, consulta una delle seguenti sezioni in base al tipo di portale per gli sviluppatori:
  • Portale integrato: creazione di un account utente nel 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 gli sviluppatori, puoi gestire gli sviluppatori direttamente sul portale, come descritto nelle seguenti sezioni:
  • Portale integrato: consente di gestire gli utenti per gestire gli account utente.
    Nota: dopo che un utente ha creato un'app sul 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 di app viene associato all'account utilizzando l'indirizzo email dell'utente. Per maggiori informazioni su dove vengono memorizzati l'account e le informazioni dell'app associate, vedi Dove vengono memorizzati i dati dell'account sviluppatore di app.
  • Drupal 10: Comprendere 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 archiviate su Apigee e viene generato un indirizzo email univoco generato automaticamente che funga da chiave primaria utilizzata da Apigee per identificare il team di sviluppatori. Per maggiori informazioni, visita la pagina Dove vengono archiviate le informazioni del team di sviluppatori (beta).

Consigli per la gestione degli account utente sui portali per sviluppatori

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

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

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

• Quando aggiungi uno sviluppatore tramite l'interfaccia di amministrazione sul portale, puoi impostarne la password 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 dello 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 alla pagina Sviluppatori ed esplorala utilizzando l'UI di Apigee.

Nota: per i portali integrati, gli account utente vengono gestiti come descritto in Gestire gli utenti. Dopo che uno sviluppatore crea un'app nel portale integrato, come descritto nella sezione Registrazione di app, viene creato un record sviluppatore separato per monitorare le app associate all'account utente ed è possibile accedervi dalla 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 l'interfaccia utente di Apigee classica: seleziona Pubblica > Sviluppatori.

La pagina Sviluppatori ti consente di:

• Aggiungere uno sviluppatore
• Visualizza e modifica i dettagli 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 sviluppatore

Visualizza e modifica i dettagli sviluppatore.

Per visualizzare e modificare i dettagli sviluppatore:

1. Accedi alla pagina Sviluppatori.
2. Fai clic sulla riga dello sviluppatore che vuoi visualizzare e modificare per aprire i relativi dettagli.
3. Nella sezione Dettagli vengono visualizzate le seguenti informazioni. Modifica i dettagli dello sviluppatore, se necessario.

   Dettagli	Descrizione
   Dettagli	Nome e cognome dello sviluppatore, nome utente e indirizzo email, stato e durata della registrazione e ID sviluppatore. Per modificare i dettagli dello sviluppatore, fai clic all'interno di uno dei seguenti campi: First Name 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 saperne di più, consulta: Gestire gli attributi personalizzati per uno sviluppatore
   App	App che sono state registrate dallo sviluppatore. Consulta l'articolo Controllare l'accesso alle API registrando le app.

4. Attiva o disattiva lo sviluppatore nel campo Stato.
   Per ulteriori informazioni, consulta Attivazione e disattivazione di uno sviluppatore.

Apigee conserva le seguenti entità nella cache per almeno 180 secondi dopo l'accesso alle entità.

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

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 relativi dettagli.
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 Azioni.

Attivazione e disattivazione di uno sviluppatore

Quando uno sviluppatore di app si autoregistra nel portale, puoi configurare se è attivo o meno per impostazione predefinita.

Quando uno sviluppatore non è attivo, può comunque accedere al portale per gli sviluppatori e creare app, ma nessuna delle chiavi API corrispondenti funzionerà. Le app dello sviluppatore continuano a mantenere lo stato Approvato (o di altro tipo), così come le chiavi API, anche se non sono valide quando lo sviluppatore non è attivo.

Nota: quando disattivi uno sviluppatore, potrebbero essere necessari alcuni minuti prima che la modifica venga aggiornata in tutti gli elaboratori dei messaggi. Fino ad allora, alcune chiamate da parte dell'app dello sviluppatore potrebbero riuscire.

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 relativi dettagli.
3. Nella sezione Dettagli, imposta il campo Stato su Attivo o Non attivo, a seconda delle necessità.
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 dello sviluppatore, dell'applicazione e del prodotto 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 rimuove completamente gli sviluppatori e i relativi artefatti (come app e chiavi API) dalla tua organizzazione. Per evitare l'eliminazione definitiva degli sviluppatori e dei loro 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 da eliminare per visualizzare il menu 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 API, le modifiche apportate agli sviluppatori di app che utilizzano Apigee non vengono propagate al portale. Devi accedere al portale come amministratore del portale e sincronizzarlo con Apigee per fare in modo che le modifiche vengano visualizzate sul portale.

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

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

Drupal 10: Sincronizzare gli sviluppatori con Apigee

Gestione degli sviluppatori tramite l'API

Gestisci gli sviluppatori utilizzando le API per sviluppatori.