Registra sviluppatori di app

Stai visualizzando la documentazione di Apigee Edge.
Vai alla documentazione di Apigee X. info

Registra e gestisci gli sviluppatori di app, come descritto nelle sezioni seguenti. La registrazione delle app è un processo distinto, come descritto in Registrare le app e gestire le chiavi API.

Introduzione

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

Come registrare gli sviluppatori di app

Registra gli sviluppatori di app utilizzando uno dei seguenti metodi:

Consigli per la gestione degli account sviluppatore sui portali per sviluppatori

Apigee consiglia di gestire gli account sviluppatore direttamente nel tuo portale per sviluppatori.

Se utilizzi il portale integrato, questo è l'unico modo per assicurarti che gli account sviluppatore sul portale integrato e su Edge rimangano sincronizzati.

Se utilizzi il portale per sviluppatori basato su Drupal, la gestione degli account sviluppatore direttamente nel portale 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 utilizzando Edge, 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 a Edge.

Se decidi di gestire gli account sviluppatore basati su Drupal utilizzando Edge, devi sincronizzare gli sviluppatori di app tra il portale e Edge.

Esplorazione della pagina Sviluppatori

Accedi ed esplora la pagina Sviluppatori utilizzando l'interfaccia utente di Edge e l'interfaccia utente classica di Edge.

Edge

Per accedere alla pagina Sviluppatori utilizzando l'interfaccia utente di Edge:

  1. Accedi ad apigee.com/edge.
  2. Seleziona Pubblicazione > Sviluppatori nella barra di navigazione a sinistra.

Viene visualizzata la pagina Sviluppatori.

Come evidenziato nella figura, la pagina Sviluppatori ti consente di:

Edge classico (private cloud)

Per accedere alla pagina Sviluppatori utilizzando l'interfaccia utente classica di Edge:

  1. Accedi a http://ms-ip:9000, dove ms-ip è l'indirizzo IP o il nome DNS del nodo del server di gestione.
  2. Seleziona Pubblica > Sviluppatori nella barra di navigazione in alto.

Viene visualizzata la pagina 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.

Visualizzazione e modifica dei dettagli dello sviluppatore

Visualizzare e modificare i dettagli dello sviluppatore. Per le organizzazioni che hanno attivato la monetizzazione, puoi modificare gli attributi personalizzati per la monetizzazione definiti in Configurare gli attributi di monetizzazione.

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, consulta:
    App App registrate dallo sviluppatore. Consulta Registrare le app.
  4. Attiva o disattiva lo sviluppatore nel campo Stato.
    Per ulteriori informazioni, vedi Attivare e disattivare uno sviluppatore.

Con Apigee Edge for Public Cloud, Edge memorizza nella cache le seguenti entità per un minimo di 180 secondi dopo l'accesso.

  • Token di accesso OAuth. Ciò significa che un token revocato potrebbe comunque essere valido per un massimo di tre minuti, fino alla scadenza del limite della cache.
  • 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, inclusi gli attributi di monetizzazione descritti in Configurare gli attributi di monetizzazione.

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.

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

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 Edge

Se utilizzi un portale per sviluppatori basato su Drupal per pubblicare le tue API, le modifiche apportate agli sviluppatori di app che utilizzano Edge non vengono propagate al portale. Per visualizzare le modifiche sul portale, devi accedere al portale come amministratore e sincronizzarlo con Edge.

.

Per sincronizzare il tuo portale per sviluppatori con gli sviluppatori di app definiti su Edge, consulta le seguenti sezioni:

Raggruppare gli sviluppatori in aziende

Con la monetizzazione, un'azienda è un insieme di sviluppatori gestiti come un'unica entità. Un'azienda può essere qualsiasi raggruppamento appropriato per la tua organizzazione, ad esempio unità commerciale, linea di prodotto o divisione. Raggruppare gli sviluppatori in aziende è utile quando hai bisogno di avere più sviluppatori associati a un'unica entità aziendale. Ad esempio, potresti dover configurare aziende diverse a fini di fatturazione. Tuttavia, gli sviluppatori della tua organizzazione non devono essere associati a un'azienda. Tieni presente che uno sviluppatore è sempre una singola entità, identificata in modo univoco dall'elemento email. Se uno sviluppatore fa parte di un'azienda, vedrai il nome dell'azienda nella pagina Sviluppatori.

Per saperne di più sulla gestione di aziende e sviluppatori per la monetizzazione, consulta Gestire aziende e sviluppatori.

Configurazione degli attributi di monetizzazione

Quando modifichi uno sviluppatore utilizzando la UI o ne crei o ne modifichi uno utilizzando l'API, puoi configurare le proprietà di monetizzazione definite nella tabella seguente. Inizialmente, le proprietà di monetizzazione per l'organizzazione vengono configurate quando modifichi il profilo dell'organizzazione.

Nome campo Nome dell'attributo personalizzato Descrizione
Indirizzo MINT_DEVELOPER_ADDRESS

Indirizzo dello sviluppatore, inclusi i seguenti campi: Indirizzo (righe 1 e 2), Città, Stato, Codice postale e Paese.
Profilo di fatturazione MINT_BILLING_PROFILE

Ciclo di fatturazione per la tua organizzazione. I valori validi includono:

  • PRORATED: la fatturazione si basa sul numero di giorni in cui un prodotto API viene utilizzato in un mese di calendario.
  • CALENDAR_MONTH: la fatturazione avviene mensilmente.
Tipo di fatturazione MINT_BILLING_TYPE

Modello di pagamento dello sviluppatore utilizzato per la fatturazione. Il valore può essere uno dei seguenti:

  • PREPAGATO: lo sviluppatore paga in anticipo per l'utilizzo di un prodotto API. I fondi vengono trattenuti dal saldo dello sviluppatore quando viene utilizzato il prodotto API. Lo sviluppatore deve mantenere un saldo prepagato sufficiente per l'acquisto del prodotto API.
  • POSTPAID: allo Sviluppatore viene addebitata mensilmente (tramite fattura) la tariffa per l'utilizzo dei prodotti API. Lo sviluppatore paga l'utilizzo dei prodotti API in base ai termini di pagamento impostati dai piani inclusi nella fattura.
  • ENTRAMBI: supporta entrambi i tipi di fatturazione. Il valore predefinito è PREPAID.

Consulta Configurare i tipi di fatturazione prepagata e postpaid utilizzando l'API.

Categoria MINT_DEVELOPER_CATEGORY Categoria sviluppatore a cui vuoi aggiungere lo sviluppatore. Una categoria di sviluppatori è un insieme di sviluppatori o aziende con caratteristiche simili. Per saperne di più, consulta Gestire le categorie di sviluppatori.
ID azienda MINT_COMPANY_ID ID azienda, se applicabile. Per ulteriori informazioni, consulta Raggruppare gli sviluppatori in aziende.
Tipo di sviluppatore MINT_DEVELOPER_TYPE Questa proprietà non è utilizzata da Apigee.

Tipo di sviluppatore. I valori validi sono: TRUSTED o UNTRUSTED
È intermediario MINT_IS_BROKER Indica se le entrate sono basate su valori netti.
Nome legale MINT_DEVELOPER_LEGAL_NAME Nome legale dello sviluppatore che verrà utilizzato in tutti i report.
Nota: questo attributo è obbligatorio se lo sviluppatore non è raggruppato con un'azienda e vuole abbonarsi a un piano tariffario pubblicato.
Fatturazione autonoma MINT_HAS_SELF_BILLING Flag che specifica se le fatture con autofatturazione sono attivate. Se attivata (true), la monetizzazione genera una fattura con autofatturazione anziché un prospetto per la condivisione delle entrate. Una fattura con autofatturazione è un documento finanziario che indica l'importo dovuto allo sviluppatore. Funge da fattura al fornitore di API per conto dello sviluppatore.
N. auth esente da imposte MINT_TAX_EXEMPT_AUTH_NO Numero di esenzione fiscale governativa, se applicabile.
Aliquota fiscale MINT_APPROX_TAX_RATE Aliquota fiscale approssimativa per lo sviluppatore. Specifica un valore decimale con un numero massimo di 3 caratteri prima della virgola decimale e 4 caratteri dopo la virgola decimale.

Gestione degli sviluppatori che utilizzano l'API

Gestisci gli sviluppatori utilizzando le API per sviluppatori.

Quando crei e aggiorni uno sviluppatore utilizzando l'API, puoi configurare gli attributi di monetizzazione descritti in Configurazione degli attributi di monetizzazione, se necessario.