Comunicazione tra un portale basato su Drupal ed Edge

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

Il portale Servizi per sviluppatori agisce come client per Apigee Edge. Ciò significa che il portale non funziona come sistema autonomo. Tuttavia, gran parte delle informazioni utilizzate dal portale è effettivamente memorizzata su Edge. Se necessario, il portale invia una richiesta HTTP o HTTPS per recuperare informazioni da Edge o per inviare informazioni a Edge.

Edge non invia richieste al portale, ma risponde solo alle richieste effettuate dal portale. Pertanto, tutte le interazioni tra il portale e Edge vengono avviate dal portale.

Configura la connessione tra il portale e Edge

Il portale deve comunicare con Edge tre informazioni, come indicato di seguito.

• URL dell'endpoint Edge
  
  L'endpoint predefinito per la versione basata su cloud di Edge è https://api.enterprise.apigee.com/v1.
  
  Per l'installazione di Private Cloud, l'URL è nel seguente formato: http://EdgePrivateCloudIp:8080/v1 o https://EdgePrivateCloudIp:TLSport/v1.
  
  Dove EdgePrivateCloudIp è l'indirizzo IP del server Edge Management Server e TLSport è la porta TLS/SSL per l'API di gestione di Edge. Ad esempio, 8443.
• Nome organizzazione Apigee
  
  Si tratta del nome della tua organizzazione su Edge. L'organizzazione viene configurata quando crei il tuo account su Edge.
• Nome utente e password di un amministratore sviluppatore
  
  Le chiamate dal portale a Edge sono autenticate e richiedono un utente con privilegi di amministratore sviluppatore. Quando viene eseguito il provisioning di un Developer Portal per te, il ruolo sviluppatore amministratore viene aggiunto alla tua organizzazione. Questo ruolo, che include un singolo utente denominato devadmin+{org_name}@apigee.com, è esclusivamente finalizzato a collegare lo Developer Portal all'organizzazione Edge. Poiché il portale mostra le tue app per sviluppatori Edge, i prodotti API e così via, deve rimanere sincronizzato con la tua organizzazione Edge effettuando chiamate API di gestione che richiedono l'autenticazione. L'utente "devadmin" dispone delle autorizzazioni necessarie.
  

Per visualizzare i dati di connessione:

1. Nel menu di amministrazione di Drupal, seleziona Configurazione > Dev Portal > Impostazioni applicazione.

Per modificare la configurazione:

La modalità di modifica della configurazione dipende dall'installazione e dalla versione del portale:

• Installazione basata su cloud della versione 15.01.06 e successive del portale: devi rivolgerti all'assistenza Apigee Edge per modificare i dati di connessione. Ad esempio, se vuoi cambiare il nome dell'organizzazione.
• Installazione on-premise e portale basato su cloud precedente alla versione 15.01.06: modifica i dati di connessione come descritto di seguito:

1. Nel menu di amministrazione di Drupal, seleziona Configurazione > Impostazioni Dev Portal.
2. Inserisci il nome della tua organizzazione in Organizzazione API di gestione.
3. Inserisci l'URL dell'endpoint Edge in URL endpoint API di gestione.
4. Inserisci le credenziali dell'amministratore dell'organizzazione in Utente autenticato dall'endpoint e Password dell'utente autenticato.
5. Seleziona Prova connessione per assicurarti che la connessione sia riuscita.
6. Seleziona Salva configurazione.

Garantire l'accesso a Edge dal portale

Poiché molte delle informazioni utilizzate dal portale sono archiviate su Edge, devi assicurarti che il portale possa accedere a Edge. Il portale avvia la comunicazione con Edge inviando richieste REST tramite HTTP e HTTPS. Ad esempio, quando uno sviluppatore registra una nuova app sul portale, il portale invia una richiesta a Edge per inviare informazioni sull'app.

Sia Edge che il portale possono essere implementati nel cloud o on-premise e puoi combinare i tipi di implementazione. Ad esempio, puoi eseguire il deployment di entrambi nel cloud, entrambi on-premise o uno nel cloud e uno on-premise:

• Se sia il portale sia Edge sono di proprietà di Apigee e sono dipiazzati nel cloud, non dovrebbero esserci problemi a inviare richieste dal portale a Edge.
• Se esegui il deployment del portale on-premise, devi assicurarti che il portale possa effettuare richieste a Edge, indipendentemente dal fatto che Edge sia dipiegato nel cloud o on-premise.
• Se esegui il deployment di Edge on prem, devi assicurarti che il portale abbia accesso a Edge. Ciò significa che il server Edge deve accettare le richieste dal portale indipendentemente dal fatto che il portale sia dipiegato nel cloud o on-premise.

Gestione di app e chiavi API dal portale

Quando lo sviluppatore completa la procedura di registrazione dell'app sul portale, il portale invia informazioni sull'app a Edge, tra cui il nome dell'app e i prodotti API associati all'app.

Se Edge registra correttamente l'app, restituisce una singola chiave API al portale. Lo sviluppatore poi utilizza la chiave API per accedere ai prodotti API associati all'app.

Nessuna informazione su app e chiavi API viene effettivamente archiviata nel portale. ma tutte queste informazioni vengono memorizzate su Edge. Pertanto, ogni volta che uno sviluppatore utilizza il portale per visualizzare informazioni su un'app, il portale invia una richiesta a Edge per accedere a queste informazioni. Ogni volta che lo sviluppatore modifica un'app, il portale invia automaticamente le modifiche a Edge.

Ad esempio, uno sviluppatore accede al portale e si reca alla pagina Le mie app. Per compilare la pagina Le mie app, il portale invia una richiesta a Edge per recuperare informazioni sulle app e sulle chiavi API dello sviluppatore. Queste informazioni vengono poi visualizzate nella pagina Le mie app dello sviluppatore nel portale:

Se lo sviluppatore aggiunge, rimuove o modifica un'app, il portale invia le modifiche a Edge.

Poiché tutte le informazioni su app e chiavi API sono archiviate su Edge, un amministratore di Edge può manipolarle utilizzando l'interfaccia utente di Edge. Ad esempio, un amministratore può:

• Aggiungere, rimuovere o modificare l'app di uno sviluppatore
• Revocare o approvare una chiave API per un'app

Di seguito è riportata la stessa app, "La mia app meteo", così come appare a un amministratore nell'interfaccia utente di Edge:

Gestione degli sviluppatori dal portale

Quando uno sviluppatore si registra come nuovo utente del portale, viene creato su Edge e sul portale. Pertanto, a differenza delle app e delle chiavi API, le informazioni sugli sviluppatori vengono effettivamente archiviate sia su Edge sia sul portale.

Le informazioni dello sviluppatore archiviate su Edge includono:

• Nome
• Cognome
• Indirizzo email
• Informazioni aggiuntive facoltative inviate dal portale

Il portale memorizza le stesse informazioni di Edge, ma anche informazioni aggiuntive, tra cui:

• Password del portale
• Stato dell'account del portale: attivo o bloccato
• Ruolo del portale: utente autenticato, amministratore, altro
• Autorizzazioni basate sui ruoli: determinano le azioni che lo sviluppatore può eseguire sul portale

Quando uno sviluppatore accede al portale, è il portale stesso a essere responsabile dell'autenticazione dello sviluppatore e dell'applicazione delle autorizzazioni basate sui ruoli.

Poiché il portale memorizza tutte le informazioni su uno sviluppatore, consideralo come il sistema di riferimento per le informazioni sugli sviluppatori, non Edge. Quando lo sviluppatore modifica le sue informazioni sul portale, queste vengono memorizzate sul portale e, se applicabili, inviate a Edge. Ad esempio, se lo sviluppatore modifica il proprio nome, queste informazioni vengono inviate a Edge. Tuttavia, se lo sviluppatore cambia la password, queste informazioni vengono memorizzate solo localmente sul portale.

Per ulteriori informazioni, vedi Aggiungere e gestire gli account utente.

Sincronizzazione degli sviluppatori di app tra il portale e Edge

Edge non avvia la comunicazione con il portale. Se, in qualità di amministratore di Edge, manipuli le informazioni su uno sviluppatore nell'interfaccia utente di Edge, non è garantito quando queste informazioni verranno inviate al portale. Pertanto, utilizza le funzionalità di amministrazione del portale per creare, modificare ed eliminare gli sviluppatori, non Edge.

Un amministratore del portale può forzare una sincronizzazione tra il portale e Edge per scaricare informazioni sul portale da Edge. Tuttavia, se modifichi gli sviluppatori solo sul portale e non su Edge, non dovresti mai dover eseguire questa sincronizzazione. Inoltre, poiché Edge non ti consente di impostare una password quando crei uno sviluppatore, la password del portale di ogni sviluppatore creato su Edge è impostata su un valore casuale. Pertanto, lo sviluppatore deve seguire la procedura di recupero della password prima di poter accedere al portale.

Per sincronizzare il portale con gli sviluppatori di app su Edge

:

• Accedi al tuo portale come utente con privilegi amministrativi o di creazione di contenuti.
• Seleziona Persone nel menu di amministrazione di Drupal.
• Seleziona il pulsante Sincronizzazione sviluppatori del portale per sviluppatori nella parte superiore della pagina per sincronizzarti con gli sviluppatori di app su Edge.