Migrazione del portale Drupal 7 al portale integrato

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

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:

  1. Assicurati di disporre dei ruoli portale appropriati per gestire un portale integrato.
  2. Crea un portale integrato.

Quando crei un portale integrato, ti viene fornito un insieme di pagine di partenza da utilizzare come punto di partenza. Le pagine iniziali contengono contenuti dimostrativi che ti aiutano a ispirare lo sviluppo del tuo portale, sostituendo il testo e le immagini con i tuoi contenuti esclusivi. Per saperne di più, vedi Informazioni sul portale di esempio.

Passaggio 2: crea il portale integrato

Crea il tuo portale integrato, come descritto in Passaggi per creare il portale.

Devi eseguire almeno i passaggi riportati nella seguente tabella.

Passaggio Descrizione
Sviluppare i contenuti del portale ad esempio con informazioni concettuali e introduttive.

Puoi scegliere di creare pagine, quindi copiare e incollare i contenuti delle pagine direttamente dal tuo portale Drupal 7 esistente.

Configurare la navigazione Crea la navigazione necessaria in base alla struttura esistente.
Personalizzare il tema Come minimo, personalizza i seguenti componenti in base ai tuoi requisiti di branding:
Aggiungere script personalizzati Aggiungi codice JavaScript personalizzato al tuo portale, come richiesto.
Configura l'email Configura il server SMTP e i contenuti delle notifiche email.

Nota: la configurazione delle notifiche via email non è al momento disponibile per i portali integrati di Apigee ibridi.

Gestire la visibilità predefinita Gestisci la visibilità predefinita per risorse specifiche.
Configurare un criterio di sicurezza dei contenuti Configura un criterio di sicurezza dei contenuti (CSP) per tutte le pagine del tuo portale per proteggerti da cross-site scripting (XSS) e altri attacchi di code-injection, se vuoi.

Nota: questa funzionalità non è al momento disponibile per i portali integrati Apigee per gli ambienti ibridi.

Passaggio 3: configura il provider di identità

Configura il provider di identità sul 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 sul portale integrato.
Single Sign-On (SSO) tramite SAML Configura il provider di identità SAML (beta) sul portale integrato.

Note:

Dopo che gli sviluppatori hanno eseguito l'accesso al portale, puoi gestire il loro account, come descritto nell'articolo 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, come la documentazione sulle API o la creazione di chiavi API per un prodotto API, puoi ottenere questa stessa funzionalità utilizzando i segmenti di pubblico sul portale integrato.

In particolare, puoi controllare l'accesso alla seguente risorsa sul portale integrato utilizzando i segmenti di pubblico:

  • Pagine del tuo portale
  • Prodotti API pubblicati

Per aggiungere un segmento di pubblico e gestire le assegnazioni di singoli utenti e team di sviluppatori, consulta Gestire i segmenti di pubblico. Quando un nuovo utente crea un account e accede al tuo portale, dovrai 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, puoi prendere in considerazione i seguenti suggerimenti:

  • Assegna un nome ai segmenti di pubblico in base ai ruoli Drupal che verranno sostituiti.
  • Gestire l'appartenenza al segmento di pubblico tramite i team di sviluppatori. Gli sviluppatori creano team per condividere la responsabilità delle loro app e gestire l'appartenenza ai team.

Passaggio 5. Pubblica le API

Per pubblicare le API e generare automaticamente la documentazione di riferimento per le API utilizzando SmartDocs sul portale integrato, devi accedere alla specifica OpenAPI associata all'API.

Anche se hai utilizzato una specifica OpenAPI per generare automaticamente SmartDocumenti in Drupal 7, in ultima analisi 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 nell'archivio delle specifiche Apigee Edge.

Quindi, pubblica un'API sul tuo portale. Preparati a:

  • Specifica la specifica OpenAPI da utilizzare come origine della documentazione, dall'archivio delle specifiche, dalla directory locale o da un URL
  • Configura la visibilità per la documentazione (pubblico, utenti di autenticazione o segmenti di pubblico selezionati)
  • Configura un URL di callback, se necessario
  • Se vuoi, puoi aggiungere un'immagine alla visualizzazione nel catalogo delle API

Passaggio 6: condividi la responsabilità di un'app avvalendoti dei team di sviluppatori

Se i tuoi sviluppatori utilizzano app aziendali in Drupal 7 per condividere la responsabilità di un'app, possono ottenere la stessa funzionalità utilizzando i team di sviluppatori sul portale integrato.

I tuoi sviluppatori creano team di sviluppatori per condividere la responsabilità delle loro app e gestire l'appartenenza ai team, come descritto nella sezione Condividere la responsabilità di un'app usando 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 in modo da usare i team di sviluppatori per condividere la responsabilità e passare all'utilizzo delle nuove chiavi API. Successivamente, potrai 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: 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, valuta la possibilità di eseguire i passaggi definiti nella tabella seguente.

Step Descrizione
Personalizzare il dominio Fornisci un nome di dominio personalizzato per personalizzare il sito.

Nota: questa funzionalità non è al momento disponibile per i portali integrati Apigee per gli ambienti ibridi.

Configurare il monitoraggio di Analytics Configura il monitoraggio delle analisi utilizzando Google Analytics o il tuo servizio di monitoraggio di analisi personalizzato.
Creare una pagina di ricerca personalizzata Crea una pagina di ricerca personalizzata e incorpora un motore di ricerca personalizzato Google.