Registrazione degli sviluppatori di app

Questa pagina si applica a Apigee e Apigee ibrido.

Visualizza la documentazione di Apigee Edge.

Registra e gestisci gli sviluppatori di app, come descritto nelle sezioni seguenti. La registrazione delle app è una procedura separata, 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 discreta quantità di dati di analisi dipendono dalla conoscenza di chi chiama. 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 univoche bloccano o sbloccano le funzionalità integrate nei proxy API, offrendoti il controllo completo sull'accesso e sul comportamento delle API.

Ecco perché gli sviluppatori di app devono registrarsi per utilizzare le tue API. Dopo l'aggiunta, gli sviluppatori registrano le loro app, scelgono le API da utilizzare e ricevono le credenziali API univoche (consumer key e secret) necessarie per accedere alle API.

Avviso:la sicurezza delle API, la gestione del traffico e l'analisi degli sviluppatori/delle app dipendono da una corretta configurazione del proxy API. Ad esempio, devi aggiungere i criteri corretti ai proxy, come la convalida della chiave API o la verifica del token di accesso OAuth, l'applicazione della quota e la 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 specifica per sviluppatore o app, l'acquisizione dell'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 avrai davvero bisogno di registrare gli sviluppatori. Tuttavia, sconsigliamo vivamente di farlo perché perderai la sicurezza delle API, perdi il controllo sulle prestazioni (a causa di una buona gestione del traffico), perdi i dati di analisi e perdi 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 autoregistrarsi tramite un portale per gli 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: 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, gestisci gli sviluppatori direttamente nel 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 sul portale integrato, come descritto in questa sezione, i dati dell'account utente vengono sincronizzati e disponibili su Apigee nella pagina Sviluppatori. Il record dello sviluppatore di app è associato all'account utilizzando l'indirizzo email dell'utente. Per maggiori informazioni su dove vengono archiviate le informazioni sull'account e sulle app associate, vedi Dove vengono memorizzati i dati dell'account sviluppatore di app.
  • Drupal 10: informazioni su come gli sviluppatori di app interagiscono con il modulo Apigee Edge
• In qualità di amministratore dell'organizzazione, puoi gestire gli sviluppatori utilizzando l'interfaccia utente o l'API Apigee, come descritto nelle sezioni seguenti.

Nota: quando gli utenti del portale creano un team nel portale integrato, le relative informazioni vengono archiviate su Apigee e viene generato un indirizzo email univoco generato automaticamente che fungerà da chiave primaria utilizzata da Apigee per identificare il team di sviluppatori. Per maggiori informazioni, consulta Dove vengono archiviate le informazioni del team degli sviluppatori (beta).

Consigli per la gestione degli account utente sui portali per gli 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 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 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 potervi accedere.

• Qualsiasi modifica apportata all'account dello sviluppatore sul portale viene inviata automaticamente ad Apigee.

Se decidi di gestire 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 Developers 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 ha creato 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, a cui è possibile accedere nella pagina Sviluppatori. Il record dello sviluppatore viene associato tramite l'indirizzo email dell'utente.

Per accedere alla pagina Sviluppatori:

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

La pagina Sviluppatori ti consente di:

• Aggiungere uno sviluppatore
• Visualizzare e modificare 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, tra cui 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 dettagli dello sviluppatore.
3. Nella sezione Dettagli vengono visualizzate le informazioni indicate di seguito. Modifica i dettagli sviluppatore, come richiesto.

   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 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, come richiesto. Per scoprire di più, consulta l'articolo Gestire gli attributi personalizzati per uno sviluppatore
   App	App registrate dallo sviluppatore. Consulta Controllo dell'accesso alle API tramite la registrazione delle app.

4. Attiva o disattiva lo sviluppatore nel campo Stato.
   Per maggiori informazioni, consulta Attivare e disattivare uno sviluppatore.

Apigee mantiene 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 di 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 Azioni.

Attivare e disattivare uno sviluppatore

Quando uno sviluppatore di app si registra automaticamente nel tuo 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 mantengono lo stato di approvazione (o altro), così come le chiavi API, anche se non sono valide quando 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 riuscire.

Per attivare o disattivare uno sviluppatore:

1. Accedi alla pagina Sviluppatori.
2. Fai clic sulla riga dello sviluppatore per cui vuoi attivare o disattivare lo sviluppatore per aprire i dettagli dello sviluppatore.
3. Nella sezione Dettagli, imposta il campo Stato su Attivo o Non attivo, a seconda delle esigenze.
4. Ripeti la procedura se lo sviluppatore si trova in più organizzazioni.

Esportazione dei dati di pubblicazione

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

• Dettagli sviluppatore
• Dettagli su sviluppatore, applicazione e 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 in corso...

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 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 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 utilizzando Apigee non vengono propagate al portale. Per visualizzare le modifiche sul portale, devi accedere come amministratore del portale e sincronizzarlo con Apigee.

Nota: se usi 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 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 mediante l'API

Gestisci gli sviluppatori utilizzando le API per sviluppatori.