Configurazione dell'email

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

Per impostazione predefinita, il portale Servizi per gli sviluppatori invia email in risposta a determinati eventi. Ad esempio, quando un nuovo sviluppatore si registra sul portale, quest'ultimo invia automaticamente un'email di benvenuto allo sviluppatore. Oppure, se lo sviluppatore perde la password, può richiedere un'email con una password temporanea.

In qualità di provider di API, puoi controllare tutti gli aspetti delle email generate dal portale, tra cui:

  • Formattazione delle email automatiche inviate dal portale
  • Specifica del server SMTP utilizzato dal portale
  • Aggiunta di regole per generare email in risposta a eventi sul portale

Invio di email da un portale basato su cloud

La configurazione email predefinita per un portale basato su cloud di cui è stato eseguito il deployment in Pantheon o Acquia deve essere utilizzata solo in ambienti non di produzione. Le email inviate da un cloud server anonimo potrebbero essere bloccate o contrassegnate come spam.

Per i portali di produzione, utilizza una delle seguenti opzioni per l'invio di email:

Invio di email da un portale on-premise

Per impostazione predefinita, la posta viene inviata utilizzando la funzione PHP mail(). PHP tenta di inviare email utilizzando sendmail sul sistema locale, che può essere configurato nel file php.ini di PHP.

Per i portali di produzione, puoi utilizzare il modulo SMTP descritto di seguito per inviare email tramite un server SMTP o un server aziendale.

Configurazione di un server SMTP

Il portale per gli sviluppatori richiede la configurazione di un server SMTP per l'invio di messaggi email. Per configurare il server SMTP, devi prima abilitare il modulo di supporto per l'autenticazione SMTP di Drupal sul portale per gli sviluppatori.

Dopo aver configurato il server SMTP, tutte le email inviate dal portale per gli sviluppatori utilizzano il server SMTP. Queste email includono email inviate ai nuovi sviluppatori, email inviate agli sviluppatori che perdono la password e email inviate agli sviluppatori con account bloccati.

Per configurare il server SMTP:

  1. Accedi al portale come utente con privilegi di amministratore o per la creazione di contenuti.
  2. Seleziona Modules (Moduli) nel menu di amministrazione di Drupal.
    Si apre la pagina Moduli.
  3. Attiva il modulo Supporto autenticazione SMTP.
  4. Salva la configurazione.
  5. Dopo aver abilitato il modulo, seleziona Configura nella voce Supporto autenticazione SMTP nella pagina Moduli.
    Viene visualizzata la pagina di configurazione Supporto autenticazione SMTP.
  6. In Turn this form on or of f, seleziona On.
  7. Nell'area delle impostazioni del server SMTP inserisci le seguenti informazioni:
    • Indirizzo del server SMTP. Ad esempio, per il server SMTP in uscita di Gmail, utilizza smtp.gmail.com.
    • Facoltativamente, inserisci l'indirizzo del server SMTP di backup. Questo valore non è obbligatorio.
    • Inserisci la porta SMTP. Il valore di questa porta può essere diverso in base al protocollo di crittografia selezionato. Ad esempio, per Gmail, la porta è 465 quando si utilizza SSL e 587 per TLS.
    • Seleziona il protocollo di crittografia come Nessuno, SSL o TLS.
  8. Nell'area Autenticazione SMTP, specifica il nome utente e la password utilizzati per l'autenticazione SMTP. Il nome utente e la password devono essere validi sul server SMTP.
  9. In Opzioni email, inserisci l'indirizzo email e il nome dell'utente che ha generato il messaggio email. Questi valori corrispondono all'indirizzo indicato nel campo "Da" dell'email.
  10. Facoltativamente, in Invia messaggio email di prova, inserisci un indirizzo email a cui il portale invia un messaggio di test.
  11. Salva la configurazione.
    Il salvataggio della configurazione genera il messaggio email di prova e visualizza eventuali errori di configurazione. Controlla la posta in arrivo dell'indirizzo email del messaggio di prova per assicurarti che arrivi.
  12. Seleziona Configuration > System > Site Information (Configurazione > Sistema > Informazioni sul sito) nel menu di amministrazione di Drupal.
  13. In Dettagli del sito, imposta l'indirizzo email sullo stesso indirizzo specificato al passaggio 9.
    Alcuni moduli Drupal che generano email utilizzano questo campo per determinare l'indirizzo "Da" dell'email e non il valore nella pagina Supporto autenticazione SMTP.
  14. Salva la configurazione.

Configurazione e formattazione delle notifiche email

Puoi configurare diverse notifiche email che vengono inviate in risposta ad attività specifiche, come la registrazione, l'eliminazione, il blocco e lo sblocco degli account sviluppatore.

Puoi anche controllare l'indirizzo nel campo "Da" delle email.

Per configurare le notifiche via email:

  1. Accedi al portale come utente con privilegi di amministratore o per la creazione di contenuti.
  2. Seleziona Configurazione > Persone > Impostazioni account nel menu di amministrazione di Drupal. Viene visualizzata la pagina Impostazioni account.
  3. Seleziona un tipo di notifica via email nella sezione Email della pagina Impostazioni account. Ad esempio, puoi selezionare "Ti diamo il benvenuto (senza approvazione richiesta)", che ti invia un'email quando l'account sviluppatore viene approvato automaticamente durante la procedura di registrazione come sviluppatore.

  4. Modifica l'oggetto e il corpo della notifica via email.
    Posiziona il cursore in un campo, ad esempio Subject, quindi seleziona il link Sfoglia token disponibili nella parte inferiore del modulo per visualizzare l'elenco dei token che puoi utilizzare nel campo. Viene visualizzata una finestra popup che ti consente di selezionare un token da aggiungere, ad esempio [user:name], che corrisponde al nome utente dello sviluppatore.
  5. Fai clic su Salva configurazione.

Puoi anche modificare il nome e l'indirizzo del mittente in una notifica via email.

Per modificare il nome e l'indirizzo nel campo "Da":

  1. Accedi al portale come utente con privilegi di amministratore o per la creazione di contenuti.
  2. Seleziona Configuration > System > SMTP Authentication Support (Configurazione > Sistema > Supporto autenticazione SMTP) nel menu di amministrazione di Drupal. Viene visualizzata la pagina Supporto autenticazione SMTP.
  3. Specifica un indirizzo email "Da" nel campo Indirizzo email del mittente.
  4. Specifica un nome "Da" nel campo Nome email da.
  5. Fai clic su Salva configurazione.
  6. Seleziona Configurazione > Sistema > Informazioni sito nel menu di amministrazione di Drupal.
  7. Specifica nel campo Indirizzo email lo stesso indirizzo email che hai utilizzato nel passaggio 3.
  8. Fai clic su Salva configurazione.

Generazione di un'email al verificarsi di un evento

Un uso comune delle regole è generare email in risposta a un evento. Il portale include il supporto integrato per la generazione di email per eventi predefiniti, ad esempio la registrazione di un account da parte di un nuovo sviluppatore. Tuttavia, puoi aggiungere regole personalizzate per generare email. Ad esempio, puoi generare un'email quando lo sviluppatore aggiunge, rimuove o modifica un'app.

Questa sezione contiene un esempio di come creare una regola per generare un'email quando uno sviluppatore registra un'app. Modifica questa procedura secondo necessità per generare email per altri eventi.

Per generare un'email quando uno sviluppatore crea un'app:

  1. Accedi al portale come utente con privilegi di amministratore o per la creazione di contenuti.
  2. Seleziona Modules (Moduli) nel menu di amministrazione di Drupal.
  3. Assicurati che il modulo Interfaccia utente delle regole sia abilitato.
  4. Seleziona Configurazione > Flusso di lavoro > Regole nel menu di amministrazione di Drupal. Viene visualizzata la pagina Regole.
  5. Seleziona il pulsante Aggiungi una nuova regola.
  6. Nella nuova pagina delle regole, specifica:
    • La regola name, ad esempio "Invia regola email".
    • (Facoltativo) Specifica eventuali tag utilizzati per classificare le regole di ricerca.
    • Nel menu a discesa Reagisci all'evento, seleziona Devconnect > Al momento della creazione di un'app per sviluppatori.
  7. Salva la regola.
    Se salvi la regola, si apre il modulo di modifica delle regole con tre riquadri: Eventi (che hai appena creato), Condizioni e Azioni.
  8. Nella sezione Azioni, seleziona Aggiungi azione.
  9. Nel menu a discesa Seleziona l'azione da aggiungere, scegli Sistema > invia posta.
    Questa selezione apre una pagina in cui puoi formattare l'email. Utilizza questo modulo per specificare i campi "A", "Oggetto", "Messaggio" e altri campi dell'email.

    Espandi il link Pattern di sostituzione sotto ogni campo per visualizzare l'elenco dei pattern che puoi utilizzare nel campo. Ad esempio, se espandi Pattern di sostituzione nel campo A, vedrai un elenco di pattern che include [app:developer]. Se specifichi questo pattern nel campo A, l'email viene inviata all'autore dell'app.
  10. Imposta i campi come mostrato di seguito:
  11. Seleziona Salva per tornare alla pagina di modifica delle regole.
  12. Seleziona Salva modifiche.

Testa la regola aggiungendo una nuova app sul portale. In risposta dovresti ricevere una notifica via email, riportata di seguito:

Subject: App test email app created

App: test email app
API products: PremiumWeatherAPI, weatherapikey-Product
Created at: Mon, 01/27/2014 - 10:16