Stai visualizzando la documentazione di Apigee Edge.
Vai alla documentazione di Apigee X. info
Questa sezione fornisce indicazioni su come pianificare ed eseguire la migrazione degli asset del portale Drupal 7 al portale integrato.
Passaggio 1: crea un portale integrato
Prima di eseguire la migrazione degli asset del portale Drupal 7, devi creare un portale integrato.
Per creare un portale integrato:
- Assicurati di disporre dei ruoli del portale appropriati per gestire un portale integrato.
- Crea un portale integrato.
Quando crei un portale integrato, ti viene fornito un insieme di pagine iniziali da utilizzare come punto di partenza. Le pagine iniziali contengono contenuti di esempio che possono aiutarti a sviluppare il tuo portale sostituendo il testo e le immagini con i tuoi contenuti unici. Per ulteriori informazioni, consulta Informazioni sul portale di esempio.
Passaggio 2: crea il tuo portale integrato
Crea il tuo portale integrato, come descritto nella sezione Passaggi per la creazione del portale.
Come minimo, dovrai eseguire i passaggi elencati nella tabella seguente.
| Passaggio | Descrizione |
|---|---|
| Sviluppare i contenuti del portale | Ad esempio, informazioni concettuali e di inizio. Puoi scegliere di creare pagine, quindi copiare e incollare i contenuti della pagina direttamente dal tuo portale Drupal 7 esistente. |
| Configurare la navigazione | Crea la navigazione necessaria per adattarla alla struttura esistente. |
| Personalizzare il tema | Personalizza almeno i seguenti componenti in base ai requisiti del tuo branding: |
| Aggiungere script personalizzati | Aggiungi al portale il codice JavaScript personalizzato necessario. |
| Configurare l'email | Configura il server SMTP e i contenuti delle notifiche via email. Nota: al momento, la configurazione delle notifiche via email non è disponibile per i portali integrati di Apigee hybrid. |
| Gestire la visibilità predefinita | Gestisci la visibilità predefinita per risorse specifiche. |
| Configurare un criterio di sicurezza dei contenuti | Se vuoi, configura un criterio di sicurezza dei contenuti (CSP) per tutte le pagine del tuo portale per proteggerti dagli attacchi cross-site scripting (XSS) e da altri attacchi di inserimento di codice.
Nota: al momento questa funzionalità non è disponibile per i portali integrati ibride di Apigee. |
Passaggio 3: configura il provider di identità
Configura il provider di identità nel portale integrato in base al tipo di autenticazione, come descritto nella tabella seguente.
| Autenticazione | Descrizione |
|---|---|
| Provider di identità integrato (nome utente/password) | Configura il provider di identità integrato nel portale integrato. |
| Single Sign-On (SSO) tramite SAML | Configura il provider di identità SAML (beta) nel portale integrato.
Note:
|
Dopo che gli sviluppatori hanno eseguito l'accesso al portale, puoi gestire il loro account, come descritto in Gestire gli account sviluppatore.
Passaggio 4: controlla l'accesso alle risorse utilizzando i segmenti di pubblico
Se utilizzi i ruoli in Drupal 7 per controllare l'accesso a un insieme di risorse, ad esempio la documentazione dell'API o la creazione di chiavi API per un prodotto API, puoi ottenere la stessa funzionalità utilizzando i segmenti di pubblico nel portale integrato.
In particolare, puoi controllare l'accesso alla seguente risorsa nel portale integrato utilizzando i segmenti di pubblico:
- Pagine del tuo portale
- Prodotti API pubblicati
Per aggiungere un segmento di pubblico e gestire le assegnazioni dei singoli utenti e del team di sviluppatori, vedi Gestire i segmenti di pubblico. Quando un nuovo utente crea un account e accede al tuo portale, devi assegnarlo a uno o più segmenti di pubblico, come richiesto, come descritto in Gestire le assegnazioni per un segmento di pubblico.
Per semplificare la migrazione, ti consigliamo di prendere in considerazione i seguenti suggerimenti:
- Assegna un nome ai segmenti di pubblico in base ai ruoli Drupal che sostituiscono.
- Gestisci l'appartenenza al segmento di pubblico utilizzando i team di sviluppatori. Gli sviluppatori creano team per condividere la responsabilità delle proprie app e gestire l'appartenenza al team.
Passaggio 5: pubblica le API
Per pubblicare le API e generare automaticamente la documentazione di riferimento delle API utilizzando SmartDocs nel portale integrato, devi avere accesso alla specifica OpenAPI associata all'API.
Anche se potresti aver utilizzato una specifica OpenAPI per generare automaticamente gli SmartDoc in Drupal 7, alla fine i contenuti vengono archiviati utilizzando un formato interno senza alcuna associazione alla specifica OpenAPI originale. I team API che utilizzano Apigee Edge in genere archiviano le specifiche OpenAPI nello spec store di Apigee Edge.
Quindi, pubblica un'API nel tuo portale. Preparati a:
- Specifica la specifica OpenAPI da utilizzare come origine della documentazione, dallo store delle specifiche, dalla tua directory locale o da un URL
- Configurare la visibilità della documentazione (pubblica, utenti di autenticazione o segmenti di pubblico selezionati)
- Configura un URL di callback, se necessario
- Se vuoi, aggiungi un'immagine alla visualizzazione nel catalogo dell'API
Passaggio 6: condividi la responsabilità di un'app utilizzando i team di sviluppatori
Se gli sviluppatori utilizzano le app aziendali in Drupal 7 per condividere la responsabilità di un'app, possono ottenere la stessa funzionalità utilizzando i team di sviluppatori nel portale integrato.
Gli sviluppatori creano team di sviluppatori per condividere la responsabilità delle loro app e gestire l'appartenenza al team, come descritto in Condividere la responsabilità di un'app utilizzando i team di sviluppatori (beta).
Potresti informare la tua community di sviluppatori sui team di sviluppatori e incoraggiarli a eseguire la migrazione delle loro app per utilizzare i team di sviluppatori per condividere la responsabilità e passare all'utilizzo delle nuove chiavi API. Dopodiché puoi rimuovere tutte le app aziendali e gli elementi correlati utilizzando le API Edge.
In alternativa, puoi eseguire la migrazione delle app aziendali alle app del team di sviluppatori, come descritto nel seguente articolo della community: Eseguire la migrazione delle app di proprietà dell'azienda ai team di sviluppatori.
Passaggio 7: preparati a lanciare il portale integrato
Prima di lanciare il portale integrato in produzione, ti consigliamo di eseguire i passaggi definiti nella tabella seguente.
| Step | Descrizione |
| Personalizzare il dominio | Fornisci il tuo nome di dominio personalizzato per personalizzare il tuo sito. Nota: al momento questa funzionalità non è disponibile per i portali integrati ibride di Apigee. |
| Configurare il monitoraggio delle analisi | Configura il monitoraggio delle analisi utilizzando Google Analytics o il tuo servizio di monitoraggio delle analisi personalizzato. |
| Creare una pagina di ricerca personalizzata | Crea una pagina di ricerca personalizzata e incorpora un motore di ricerca personalizzato di Google. |