Registrazione degli sviluppatori di app

Questa pagina si applica a Apigee e Apigee ibridi.

Visualizza la documentazione di Apigee Edge.

Registra e gestisci gli sviluppatori di app, come descritto nelle sezioni seguenti. (La registrazione di un'app è 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 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: sicurezza delle API, gestione del traffico e sviluppatore/app e analisi dipendono da una corretta configurazione del proxy API. Ad esempio, devi aggiungere il token ai proxy, ad esempio la convalida delle chiavi API o la verifica dei token di accesso OAuth, dell'applicazione delle norme 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 sul portale integrato, come descritto in questa sezione, i dati dell'account utente sono sincronizzati e disponibili su Apigee nella pagina sviluppatori. Il record dello sviluppatore di app è associato al 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: scopri 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 informazioni del team di sviluppatori vengono archiviate su Apigee e viene generato automaticamente un indirizzo email univoco 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 assicurarti che gli account utente sul portale integrato e su Apigee rimangano sincronizzati.

Se usi il portale per gli sviluppatori basato su Drupal, la gestione degli account utente direttamente sul portale per gli sviluppatori fornisce 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 che utilizza Apigee, non verrà inviata alcuna email allo sviluppatore e non potrai impostare la password per per gli sviluppatori sul portale. Pertanto, lo sviluppatore deve reimpostare la password sul portale prima possono accedere al portale.

• Eventuali modifiche apportate all'account sviluppatore sul portale vengono inviate 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 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 sul portale integrato, come descritto in Registrazione di app, viene creato un record sviluppatore separato per monitorare le app associate all'account utente e sono accessibili dalla pagina Sviluppatori. Il record dello sviluppatore viene associato tramite 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 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, inclusi nome, cognome, email e nome utente.
4. Fai clic su Crea.

Vedi anche Gestire gli utenti.

Visualizzazione e modifica dei dettagli dello 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 seguenti informazioni. Modifica i dettagli sviluppatore, come richiesto.

   Dettagli	Descrizione
   Dettagli	Nome e cognome dello sviluppatore, nome utente e indirizzo email; lo stato e la durata della registrazione; e 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.
   Attributi personalizzati	Attributi personalizzati definiti per lo sviluppatore. Configura gli attributi personalizzati, come richiesto. Per ulteriori informazioni, vedi 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 del criterio OAuth v2 non sarà in grado di 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.

Attivare e disattivare 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 le app approvate (o di altro tipo) 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 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 delle esigenze.
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 in corso...

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

Nota: se usi il portale per gli sviluppatori basato su Drupal, Apigee ti consiglia di gestire gli sviluppatori di app direttamente sul tuo portale, non di 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.