Stai visualizzando la documentazione di Apigee Edge.
Vai alla
documentazione di Apigee X. informazioni
Registra e gestisci gli sviluppatori di app come descritto nelle sezioni seguenti. La registrazione delle app è una procedura separata, come descritto in Registrare app e gestire le chiavi API.
Introduzione
Edge offre molti vantaggi che dipendono completamente dalla conoscenza di chi chiama le API. Ad esempio, la sicurezza delle API, la gestione del traffico e una discreta quantità di dati di analisi dipendono dalla conoscenza di chi sta chiamando. E come fa Edge a sapere chi chiama le tue API? Leggendo informazioni univoche in ogni chiamata API, come un ID utente, una chiave API o un token OAuth. Queste informazioni univoche bloccano o sbloccano la funzionalità che crei nei proxy API, offrendoti un controllo completo sull'accesso e sul comportamento dell'API.
Per questo motivo, gli sviluppatori di app devono registrarsi per utilizzare le API. Una volta aggiunte, gli sviluppatori registrano le proprie app, scelgono le API che vogliono utilizzare e ricevono le credenziali API univoche (chiavi e secret del consumatore) necessarie per accedere alle API.
Come registrare gli sviluppatori di app
Registra gli sviluppatori di app utilizzando uno dei seguenti metodi:
- Se hai un account Edge a pagamento, gli sviluppatori possono registrarsi autonomamente tramite un portale per gli sviluppatori. Per ulteriori informazioni, consulta una delle seguenti sezioni in base al tipo di portale per gli sviluppatori:
- Portale integrato: creare un account sviluppatore nel portale integrato
- Drupal 9: Registrare un account sviluppatore di app
- Drupal 7: Aggiungere e gestire gli account utente
- 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: gestisci gli account sviluppatore per gestire gli account sviluppatore.
- Drupal 9: Come gli sviluppatori di app interagiscono con il modulo Apigee Edge
- Drupal 7: Aggiungere e gestire gli account utente
- In qualità di amministratore dell'organizzazione, gestisci gli sviluppatori utilizzando l'UI o l'API Edge, come descritto nelle sezioni seguenti.
Consigli per la gestione degli account sviluppatore sui portali per sviluppatori
Apigee consiglia di gestire gli account sviluppatore direttamente sul tuo portale per gli sviluppatori.
Se utilizzi il portale integrato, questo è l'unico modo per garantire che gli account sviluppatore sul portale integrato e su Edge rimangano sincronizzati.
Se utilizzi il portale per gli sviluppatori basato su Drupal, la gestione degli account sviluppatore direttamente sul portale offre i seguenti vantaggi:
- Quando aggiungi uno sviluppatore tramite l'interfaccia di amministrazione sul portale, puoi impostare la sua password per il portale e attivare un messaggio email automatico inviato allo sviluppatore.
Quando aggiungi o modifichi uno sviluppatore utilizzando Edge, non viene inviata alcuna email allo sviluppatore e non puoi impostare la relativa password sul portale. Di conseguenza, lo sviluppatore deve reimpostare la propria password sul portale prima di poter accedere al portale.
- Tutte le 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 ed Edge.
Esplorazione della pagina per sviluppatori
Accedi alla pagina Sviluppatori ed esplorala utilizzando l'UI di Edge e la UI classica di Edge.
Perimetrale
Per accedere alla pagina Sviluppatori utilizzando l'interfaccia utente Edge:
- Accedi ad apigee.com/edge.
- Seleziona Pubblica > Sviluppatori nella barra di navigazione a sinistra.
Viene visualizzata la pagina Sviluppatori.
Come evidenziato nella figura, la pagina Sviluppatori ti consente di:
Perimetro classico (private cloud)
Per accedere alla pagina Sviluppatori utilizzando l'interfaccia utente classica di Edge:
- Accedi a
http://ms-ip:9000
, dove ms-ip è l'indirizzo IP o il nome DNS del nodo del server di gestione. - Seleziona Pubblica > Sviluppatori nella barra di navigazione in alto.
Viene visualizzata la pagina Sviluppatori.
- Visualizza l'elenco di sviluppatori
- Aggiungere uno sviluppatore
- Visualizzare e modificare i dettagli sviluppatore, inclusi gli attributi personalizzati, e attivare uno sviluppatore
- Esportare i dati di pubblicazione
- Eliminare uno sviluppatore
- Cerca nell'elenco degli sviluppatori
- Visualizza il portale per gli sviluppatori collegato (solo Drupal 7)
Aggiunta di uno sviluppatore
Per aggiungere uno sviluppatore:
- Accedi alla pagina Sviluppatori.
- Fai clic su + Sviluppatore.
- Inserisci i dettagli dello sviluppatore, inclusi nome, cognome, email e nome utente.
- Fai clic su Crea.
Visualizzazione e modifica dei dettagli sviluppatore
Visualizza e modifica i dettagli sviluppatore. Per le organizzazioni abilitate per la monetizzazione, puoi modificare gli attributi personalizzati di monetizzazione definiti in Configurare gli attributi di monetizzazione.
Per visualizzare e modificare i dettagli sviluppatore:
- Accedi alla pagina Sviluppatori.
- Fai clic sulla riga dello sviluppatore che vuoi visualizzare e modificare per aprire i relativi dettagli.
- Nella sezione Dettagli, vengono visualizzate le seguenti informazioni. Modifica i dettagli sviluppatore come richiesto.
Dettaglio 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:- Nome
- Cognome
- Nome utente
Attributi personalizzati Attributi personalizzati definiti per lo sviluppatore. Configura gli attributi personalizzati, come richiesto. Per saperne di più, consulta: App App che sono state registrate dallo sviluppatore. Vedi Registrazione delle app. - Attiva o disattiva lo sviluppatore nel campo Stato.
Per saperne di più, consulta Attivare e disattivare uno sviluppatore.
Con Apigee Edge per il cloud pubblico, Edge conserva le seguenti entità nella cache per almeno 180 secondi dopo l'accesso alle entità.
- Token di accesso OAuth. Ciò significa che un token revocato potrebbe comunque avere esito positivo per un massimo di tre minuti, fino alla scadenza del limite di cache.
- 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, inclusi gli attributi di monetizzazione descritti in Configurare gli attributi di monetizzazione.
Per gestire gli attributi personalizzati:
- Accedi alla pagina Sviluppatori.
- Fai clic sulla riga dello sviluppatore per cui vuoi gestire gli attributi personalizzati per aprire i relativi dettagli.
- Fai clic su + nella sezione Attributi personalizzati.
- Inserisci il nome e il valore dell'attributo.
- Fai clic su
.
- Per eliminare un attributo personalizzato, posiziona il cursore sull'attributo e fai clic su
nel menu Azioni.
Attivare e disattivare uno sviluppatore
Quando uno sviluppatore di app si registra automaticamente al 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 approvato (o di altro tipo) così come le chiavi API, anche se non sono valide mentre lo sviluppatore è inattivo.
Per attivare o disattivare uno sviluppatore:
- Accedi alla pagina Sviluppatori.
- Fai clic sulla riga dello sviluppatore che vuoi attivare o disattivare per aprire i relativi dettagli.
- Nella sezione Dettagli, imposta il campo Stato su Attivo o Non attivo, a seconda delle necessità.
- 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:
- Accedi alla pagina Sviluppatori.
- Fai clic su Esporta CSV....
- 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:
- Accedi alla pagina Sviluppatori.
- Posiziona il cursore sulla riga dello sviluppatore che vuoi eliminare per visualizzare il menu Azioni.
- Fai clic su
.
- Fai clic su Elimina per confermare l'eliminazione.
Sincronizzazione degli sviluppatori di app tra il portale ed 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. Devi accedere al portale come amministratore del portale e sincronizzarlo con Edge per fare in modo che le modifiche vengano visualizzate sul portale.
Per sincronizzare il tuo portale per gli sviluppatori con gli sviluppatori di app definiti su Edge, consulta le sezioni seguenti:
- Drupal 9: Sincronizzare gli sviluppatori con Apigee Edge
- Drupal 7: Sincronizzare gli sviluppatori di app tra il portale ed Edge
Raggruppamento degli sviluppatori in società
Con la monetizzazione, una società è un insieme di sviluppatori gestito come un'unica entità. Un'azienda può essere qualsiasi raggruppamento appropriato per la tua organizzazione, ad esempio unità aziendale, linea di prodotti o divisione. Il raggruppamento degli sviluppatori in società è utile quando hai bisogno di associare più sviluppatori in una singola entità aziendale. Ad esempio, potrebbe essere necessario configurare aziende diverse per la fatturazione. Tuttavia, gli sviluppatori della tua organizzazione non devono essere associati a una società. Tieni presente che uno sviluppatore è sempre una singola entità identificata in modo univoco dall'elemento email. Se uno sviluppatore fa parte di una società, il nome dell'azienda viene visualizzato nella pagina Sviluppatori.
Per ulteriori informazioni sulla gestione di società e sviluppatori per la monetizzazione, consulta la sezione Gestire aziende e sviluppatori.
Configurazione degli attributi di monetizzazione
Quando modifichi uno sviluppatore utilizzando l'UI o lo crei o lo modifichi utilizzando l'API, puoi configurare le proprietà di monetizzazione definite nella tabella seguente. Inizialmente, devi configurare le proprietà di monetizzazione per l'organizzazione quando modifichi il profilo dell'organizzazione.
Nome campo | Nome attributo personalizzato | Descrizione |
---|---|---|
Indirizzo | MINT_DEVELOPER_ADDRESS |
Indirizzo dello sviluppatore, inclusi i seguenti campi: Indirizzo (righe 1 e 2), Città, Provincia, Codice postale e Paese. |
Profilo di fatturazione | MINT_BILLING_PROFILE |
Ciclo di fatturazione per la tua organizzazione. I valori validi includono:
|
Tipo di fatturazione | MINT_BILLING_TYPE |
Modello di pagamento dello sviluppatore utilizzato per la fatturazione. Il valore può essere uno dei seguenti:
Consulta Configurazione dei tipi di fatturazione prepagata e con pagamento posticipato utilizzando l'API. |
Categoria | MINT_DEVELOPER_CATEGORY |
Categoria a cui vuoi aggiungere lo sviluppatore. Una categoria sviluppatore è un raggruppamento di sviluppatori o società con caratteristiche simili. Per maggiori informazioni, consulta la sezione Gestire le categorie sviluppatori. |
ID azienda | MINT_COMPANY_ID |
L'ID azienda, se applicabile. Per ulteriori informazioni, consulta la sezione Raggruppamento degli sviluppatori in aziende. |
Tipo di sviluppatore | MINT_DEVELOPER_TYPE |
Questa proprietà non è utilizzata da Apigee. Tipo di sviluppatore. I valori validi includono: |
Broker | MINT_IS_BROKER |
Flag che specifica se le entrate si basano sul valore netto. |
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 una società e vuole abbonarsi a un piano tariffario pubblicato. |
Autofatturazione | MINT_HAS_SELF_BILLING |
Flag che specifica se sono state attivate le fatture di autofatturazione. Se abilitata
(true ), la monetizzazione genera una fattura di autofatturazione anziché un estratto conto
della quota di condivisione delle entrate. Una fattura di autofatturazione è un documento finanziario che descrive in dettaglio l'importo dovuto allo sviluppatore. Costituisce una fattura inviata al fornitore di API per conto dello sviluppatore. |
N. autentica 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 del decimale e 4 caratteri dopo il decimale. |
Gestione degli sviluppatori tramite 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 Configurare gli attributi di monetizzazione, come richiesto.