Domande frequenti sul portale per gli sviluppatori Drupal 7

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

Questa sezione fornisce risposte alle domande più frequenti, compilate a partire dalle domande pubblicate nella community di Apigee o nell'assistenza Apigee.

Categoria Domande frequenti
Configurare un portale per gli sviluppatori Drupal
Gestire l'ambiente del portale
Personalizzare l'aspetto del portale
Personalizzare la registrazione di utenti e app
Backup, recupero e alta disponibilità
Proteggere il portale
Controllare l'accesso ai contenuti
Configurare email e notifiche
Risoluzione dei problemi
Accedere al codice

Configurare un portale per gli sviluppatori Drupal

Come faccio a configurare un portale per sviluppatori Drupal?

A partire dal 31 maggio 2020, l'hosting sponsorizzato da Apigee per i portali basati su Drupal è terminato. Per informazioni su come configurare un portale per gli sviluppatori esistente, consulta Creare un portale per gli sviluppatori.

Quali browser e versioni di browser supporta il portale?

Consulta la sezione Software e versioni supportati.

Gestire l'ambiente del portale

Come faccio a gestire il mio ambiente del portale nel cloud pubblico?

Apigee utilizza Pantheon, un servizio di gestione dei siti web, per ospitare le versioni basate su cloud del portale Developer Services. Per saperne di più, consulta Lavorare con Pantheon.

Apigee utilizza Acquia, un servizio di gestione di siti web, per ospitare le versioni basate su cloud del portale per i servizi per sviluppatori nell'Unione europea (UE). Per saperne di più, consulta Lavorare con Acquia.

Sia Pantheon che Acquia forniscono strumenti per sviluppare, testare e pubblicare il tuo portale basato su Drupal in un ambiente sicuro.

Come faccio a gestire il mio ambiente del portale nel cloud privato?

In qualità di cliente Apigee Edge Private Cloud, dovrai gestire autonomamente il tuo ambiente del portale. Per i consigli, consulta le best practice per lo sviluppo e l'ambiente server di Drupal.

Come faccio ad applicare gli aggiornamenti di Apigee al mio portale per gli sviluppatori nel cloud pubblico?

Per applicare gli aggiornamenti di Apigee al portale per gli sviluppatori nel cloud pubblico:

  • Pantheon: quando Apigee pubblica una nuova release del portale, viene visualizzato un messaggio nella dashboard di Pantheon. Devi controllare la presenza di aggiornamenti regolarmente e applicare immediatamente gli aggiornamenti di sicurezza. Per ulteriori informazioni, consulta la sezione Applicare un aggiornamento Apigee al tuo portale.

    Nota: nell'area Stato di un ambiente, accessibile dall'elemento di menu Stato a sinistra della dashboard, potresti notare che sono disponibili aggiornamenti per i moduli Drupal. Ignora questi aggiornamenti. Apigee incorpora automaticamente gli aggiornamenti dei moduli Drupal nella release successiva del portale. Se consenti ad Apigee di aggiornare i moduli Drupal per te, Apigee garantisce che questi aggiornamenti siano stati testati in base al codice del portale più recente. Se aggiorni un modulo Drupal al di fuori del normale ciclo di release del portale Apigee, potresti riscontrare problemi imprevisti.

  • Acquia: periodicamente, Apigee aggiorna automaticamente i moduli e i temi nel tuo portale alla versione più recente. Gli aggiornamenti vengono apportati solo all'ambiente di sviluppo e sono contrassegnati per indicare che è necessario eseguirne la migrazione in altri ambienti del portale. Per ulteriori informazioni, consulta Applicare gli aggiornamenti dei moduli e dei temi al portale.

Come faccio ad applicare gli aggiornamenti di Apigee al mio portale per sviluppatori nel cloud privato?

Per i clienti di Apigee Edge per Private Cloud, quando Apigee pubblica una nuova release del portale, puoi eseguire l'upgrade del tuo portale per gli sviluppatori alla versione più recente, come descritto in Eseguire l'upgrade del portale per i servizi per gli sviluppatori.

Tra una release di Apigee Edge Private Cloud e l'altra, potresti ricevere una notifica che ti informa della disponibilità di una nuova versione di Drupal. Una nuova versione può indicare una release di funzionalità, una patch, un aggiornamento della sicurezza o un altro tipo di aggiornamento di Drupal. In caso di aggiornamento della sicurezza, devi eseguire l'upgrade dell'installazione di Drupal il prima possibile per garantire la sicurezza del tuo sito. Per saperne di più, consulta Eseguire l'upgrade della versione Drupal di un'installazione Private Cloud.

Personalizzare l'aspetto del portale

Come faccio a personalizzare l'aspetto del portale?

Con Drupal puoi creare un portale altamente personalizzato modificando il tema di Drupal e aggiungendo moduli personalizzati.

Nota: l'implementazione delle personalizzazioni di Drupal più avanzate richiede una curva di apprendimento. Potresti decidere di rivolgerti a una terza parte con esperienza in Drupal per ottenere il look and feel desiderato nei tempi che preferisci.

Di seguito sono riportate alcune risorse che ti aiuteranno a personalizzare il tuo portale utilizzando Drupal:

Come faccio ad aggiungere temi e moduli personalizzati al mio portale nel cloud pubblico?

Puoi espandere la funzionalità del portale aggiungendo i tuoi moduli e temi personalizzati.

Per aggiungere moduli e temi personalizzati al tuo portale basato su cloud, consulta una delle seguenti sezioni in base al fatto che tu utilizzi Patheon o Acquia per gestire il tuo portale:

Nota: modifica solo i contenuti all'interno della directory /sites/all. Se modifichi i contenuti esterni alla directory /sites/all, potresti riscontrare conflitti di unione durante il commit delle modifiche in Git.

Per le best practice e le informazioni su come aggiungere e aggiornare i moduli personalizzati, consulta rispettivamente Aggiunta di moduli e temi e Aggiornare i moduli nella documentazione di Drupal.

Come faccio ad aggiungere temi e moduli personalizzati al mio portale nel cloud privato?

Puoi espandere la funzionalità del portale aggiungendo i tuoi moduli e temi personalizzati. Per le best practice e le informazioni su come aggiungere e aggiornare i moduli personalizzati, consulta rispettivamente Aggiunta di moduli e temi e Aggiornare i moduli nella documentazione di Drupal.

Nota: modifica solo i contenuti all'interno della directory /sites/all. Se modifichi i contenuti esterni alla directory /sites/all, potresti riscontrare conflitti di unione durante il commit delle modifiche in Git.

Personalizzare la registrazione di utenti e app

Come faccio a personalizzare la pagina di registrazione del nuovo utente?

Quando l'utente registra un account sul portale, viene visualizzata la pagina di registrazione predefinita con i campi per Nome, Cognome, Nome utente, Indirizzo email e Password. In qualità di fornitore di API, ti consigliamo di modificare questo modulo per chiedere all'utente di fornire informazioni aggiuntive, come il nome dell'azienda, l'indirizzo postale o altre informazioni. Per saperne di più, consulta:

Come faccio a personalizzare la pagina di registrazione dell'app?

Quando uno sviluppatore di app registra un'app, il portale mostra un modulo predefinito. In qualità di fornitore di API, potresti voler modificare il modulo di registrazione dell'app per chiedere allo sviluppatore di fornire informazioni aggiuntive, come un ID cliente, la piattaforma di destinazione dell'app o altre informazioni. Per ulteriori informazioni, vedi:

Come faccio a utilizzare LDAP per l'autenticazione sul Portale per gli sviluppatori?

Le seguenti risorse descrivono come utilizzare LDAP per l'autenticazione:

Community Apigee

Documentazione di Drupal

Come faccio ad accedere al portale utilizzando le mie credenziali di Twitter, Google o GitHub?

L'accesso federato è il processo in cui utilizzi le credenziali di un sistema di gestione delle identità, chiamato sistema di riferimento, per accedere a un altro sistema. Ad esempio, utilizzi le tue credenziali Google o Twitter per accedere al portale per sviluppatori Apigee. Il portale supporta l'accesso federato utilizzando le credenziali di diversi provider comuni, tra cui GitHub, Google, OpenID e Twitter. Per saperne di più, consulta Utilizzare le credenziali federate sul portale per sviluppatori.

Come faccio ad applicare un flusso di lavoro per l'approvazione manuale delle chiavi API?

Puoi configurare l'approvazione manuale delle chiavi API per la registrazione delle app quando crei un prodotto API. In questo caso, devi approvare manualmente una chiave API quando uno sviluppatore di app registra un'app.

Per consigli sull'applicazione di un flusso di lavoro per l'approvazione manuale delle chiavi API, consulta il seguente articolo della community: Qual è il modo migliore per applicare un flusso di lavoro per l'approvazione manuale delle chiavi API nel portale per sviluppatori?

Backup, recupero e alta disponibilità

Come faccio a eseguire il backup e il ripristino del mio portale nel cloud pubblico?

I passaggi per eseguire il backup di un portale nel cloud pubblico sono diversi a seconda che tu utilizzi Pantheon o Acquia per gestire il tuo portale:

Come faccio a eseguire il backup e il ripristino del mio portale nel cloud privato?

Esegui il backup e il ripristino del portale nel cloud privato utilizzando i comandi pg_dump e pg_restore di Postgres. Per ulteriori informazioni, consulta Eseguire il backup del portale.

Come faccio a garantire un'alta disponibilità per il portale per sviluppatori nel mio cloud pubblico?

Gli strumenti di gestione di Pantheon e Acquia Drupal garantiscono il 99,5% di disponibilità per i portali ospitati. Per ulteriori informazioni, vedi:

Come faccio a garantire un'alta disponibilità per il portale per sviluppatori nel mio cloud privato?

Non esiste un approccio "universale " per garantire un'alta disponibilità per il portale per gli sviluppatori. Ti consigliamo vivamente di richiedere l'assistenza di una persona esperta in:

  • Configurazione di file system e database in una configurazione ad alta disponibilità
  • Sviluppo di portali Drupal 7

Contatta il team di Customer Success di Apigee se hai bisogno di assistenza. Consulta inoltre i seguenti articoli della community:

Proteggere il portale

Come faccio a configurare la sicurezza del portale?

Drupal offre inoltre molte funzionalità di sicurezza che dovresti conoscere durante la creazione del tuo portale. Per saperne di più, consulta la sezione Proteggere il tuo portale.

Come faccio a configurare il portale in modo che utilizzi TLS/HTTPS?

TLS (Transport Layer Security, il cui predecessore è SSL) è la tecnologia di sicurezza standard per stabilire un link criptato tra un server web e un client web, ad esempio un browser o un'app. Un link criptato garantisce che tutti i dati trasmessi tra il server web e il client rimangano privati. Per informazioni sulla configurazione di TLS con il portale, consulta Utilizzare TLS sul portale.

Come faccio ad applicare le patch di sicurezza di Drupal?

Per i clienti di Apigee Edge Public Cloud:

  • Pantheon: quando Apigee pubblica una nuova release del portale, viene visualizzato un messaggio nella dashboard di Pantheon. Ti consigliamo di controllare regolarmente la presenza di aggiornamenti e di applicare immediatamente quelli di sicurezza. Per ulteriori informazioni, consulta la sezione Applicare un aggiornamento Apigee al tuo portale.
  • Acquia: periodicamente, Apigee aggiorna automaticamente i moduli e i temi del tuo portale alla versione più recente. Gli aggiornamenti vengono apportati solo all'ambiente di sviluppo e sono contrassegnati per indicare che è necessaria la migrazione ad altri ambienti del portale. Per ulteriori informazioni, consulta Applicare aggiornamenti di temi e moduli al portale.

I clienti di Apigee Edge for Private Cloud riceveranno una notifica che li informa della disponibilità di una nuova versione di Drupal. Una nuova versione può indicare una release di funzionalità, una patch, un aggiornamento della sicurezza o un altro tipo di aggiornamento di Drupal. In caso di aggiornamento della sicurezza, è consigliabile eseguire l'upgrade dell'installazione di Drupal il prima possibile per garantire la sicurezza del sito. Per saperne di più, consulta Eseguire l'upgrade della versione Drupal di un'installazione Private Cloud.

Come faccio a registrarmi per ricevere gli aggiornamenti della sicurezza?

Registrati per ricevere gli aggiornamenti sia da Drupal che da Apigee:

I clienti del cloud pubblico possono anche registrarsi con l'host del sito web Drupal:

Come faccio a impedire l'enumerazione dei nomi utente?

L'enumerazione dei nomi utente si riferisce a un metodo utilizzato dagli attaccanti per identificare i nomi utente esistenti utilizzando il modulo di reimpostazione della password, che per impostazione predefinita indica se la password specificata esiste o meno. Gli utenti malintenzionati possono continuare a provare nomi utente finché non trovano un utente valido. Per impedire l'enumerazione dei nomi utente, installa il modulo di prevenzione dell'enumerazione dei nomi utente.

Come faccio ad attivare l'autenticazione a due fattori?

Non attivare l'autenticazione a due fattori su Apigee Edge se pubblichi le tue API utilizzando un portale per sviluppatori Apigee. In caso contrario, il portale per gli sviluppatori non potrà comunicare con Edge.

Come vengono archiviate e criptate le credenziali di Edge nel portale Drupal?

Le seguenti fonti forniscono dettagli su come le credenziali Edge vengono archiviate e criptate nel portale Drupal:

Community Apigee:

Controllare l'accesso ai contenuti

Come faccio a controllare l'accesso ai contenuti nel portale?

Le seguenti risorse descrivono come controllare l'accesso ai contenuti del portale:

Community Apigee:

Documentazione di Drupal:

Come faccio a controllare l'accesso ai prodotti API in base al ruolo?

Le seguenti risorse descrivono come controllare l'accesso ai prodotti API in base al ruolo:

Configurare email e notifiche

Come faccio a specificare un server di posta SMTP per il portale?

Il portale per sviluppatori richiede la configurazione di un server SMTP per l'invio di messaggi email. Dopo aver configurato il server SMTP, tutte le email inviate dal portale per gli sviluppatori utilizzeranno il server SMTP. Queste email includono email inviate a nuovi sviluppatori, email inviate a sviluppatori che hanno perso la password e email inviate a sviluppatori con account bloccati. Per informazioni, vedi Configurare l'email.

Come faccio a inviare un'email quando uno sviluppatore registra un'app (o si verifica un altro evento)?

Le regole Drupal ti consentono di definire le azioni del portale in risposta a determinati eventi. Un uso comune delle regole è generare email in risposta a un evento. Il portale supporta la generazione di email per eventi predefiniti, ad esempio quando un nuovo sviluppatore registra un account. Tuttavia, puoi aggiungere le tue regole per generare email. Ad esempio, puoi generare un'email quando lo sviluppatore aggiunge, rimuove o modifica un'app. Per informazioni, vedi Generare un'email quando si verifica un evento.

Come faccio a personalizzare i messaggi email inviati dal portale?

Puoi configurare varie notifiche via email che vengono inviate in risposta a determinate attività, come registrazione, eliminazione, blocco e sblocco degli account sviluppatore. Per informazioni, consulta Configurare e formattare le notifiche via email.

Come faccio a impedire lo SPAM sul portale?

Un modo per impedire lo SPAM sul portale è aggiungere CAPTCHA alla pagina di accesso e ad altre pagine attivando i moduli CAPTCHA e reCAPTCHA di Drupal. Per informazioni, vedi:

Risoluzione dei problemi

Come faccio a visualizzare i file di log del portale?

Seleziona Report nel menu di Drupal per visualizzare un elenco di log e altri report. Ad esempio, seleziona Report > Messaggi di log recenti per visualizzare una tabella dei messaggi di log recenti.

Video:guarda un breve video per scoprire di più sui report dei log e sulle impostazioni di debug.

Accedere al codice

Come faccio ad accedere al codice sorgente del portale per sviluppatori di Drupal 7?

Per i siti ospitati su Pantheon o Acquia, puoi accedere al codice sorgente del portale per sviluppatori di Drupal 7 tramite la dashboard del tuo sito di hosting, come descritto nelle seguenti sezioni:

Puoi accedere al repository del codice sorgente di Drupal 7 direttamente all'indirizzo https://github.com/apigee/drupal7-drops. I siti Pantheon e Acquia utilizzano questo repository per il codice sorgente upstream.