Integrazione di PeopleSoft con il servizio di consegna tramite e-mail

Configurare PeopleSoft per l'invio di e-mail tramite il servizio di consegna tramite posta elettronica

È possibile utilizzare PeopleSoft per inviare e-mail tramite il servizio di consegna tramite e-mail. Prima di utilizzare PeopleSoft, è necessario configurare Oracle Cloud Infrastructure Email Delivery nell'applicazione PeopleSoft.

Per consentire l'integrazione di PeopleSoft con il servizio di consegna tramite e-mail:

1. Assicurarsi che il servizio di consegna tramite e-mail sia configurato per l'invio di e-mail. Vedere Guida introduttiva.
   Nota
   
   

   Le credenziali SMTP sono necessarie per configurare PeopleSoft in modo che utilizzi il servizio di consegna tramite e-mail. Assicurarsi di prendere nota del nome utente e della password quando si generano le credenziali SMTP.

2. Eseguire il comando seguente per visualizzare la catena di certificati:

   echo | openssl s_client -showcerts -starttls smtp -crlf -connect <SMTP-endpoint>:587

   Output di esempio:

   [root@ociuvddatg01 ~]# echo | openssl s_client -showcerts -starttls smtp -crlf -connect smtp.email.us-ashburn-1.oci.oraclecloud.com:587
             CONNECTED(00000003)
             depth=2 C = US, O = DigiCert Inc, OU = www.digicert.com, CN = DigiCert Global Root G2
             verify return:1
             depth=1 C = US, O = DigiCert Inc, CN = DigiCert Global CA G2
             verify return:1
             depth=0 C = US, ST = California, L = Redwood City, O = Oracle Corporation, OU = Oracle OCI-PROD ASHBURN, CN = smtp.email.us-ashburn-1.oci.oraclecloud.com
             verify return:1
              ---
            Certificate chain
    0 s:/C=US/ST=California/L=Redwood City/O=Oracle Corporation/OU=Oracle OCI-PROD ASHBURN/CN=smtp.email.us-ashburn-1.oci.oraclecloud.com
      i:/C=US/O=DigiCert Inc/CN=DigiCert Global CA G2
    1 s:/C=US/O=DigiCert Inc/CN=DigiCert Global CA G2
      i:/C=US/O=DigiCert Inc/OU=www.digicert.com/CN=DigiCert Global Root G2
    2 s:/C=US/O=DigiCert Inc/OU=www.digicert.com/CN=DigiCert Global Root G2
      i:/C=US/O=DigiCert Inc/OU=www.digicert.com/CN=DigiCert Global Root G2
   ---
   Server certificate
   -----BEGIN CERTIFICATE-----
   ......
   -----END CERTIFICATE-----
   ......

3. Estrarre il certificato che ha firmato il dominio. In questo esempio, si tratta dell'ultimo certificato (2 s:/C=US/O=DigiCert Inc/OU=www.digicert.com/CN=DigiCert Global Root G2). Copiare e incollare il certificato in un file DigiCert.pem separato, inclusi i campi BEGIN CERTFICATE e END CERTIFICATE.
   Ad esempio:

   -----BEGIN CERTIFICATE-----
   s:/C=US/O=DigiCert Inc/OU=www.digicert.com/CN=DigiCert Global Root G2
   i:/C=US/O=DigiCert Inc/OU=www.digicert.com/CN=DigiCert Global Root G2
   -----END CERTIFICATE-----

4. Aggiungere i certificati all'applicazione PeopleSoft.

   Eseguire il login a Pure Internet Architecture (PIA) come utente "PS" e importare i certificati nell'ambiente di destinazione. Vedere Installazione di certificati digitali basati su Application Server e fare riferimento alla sezione Aggiunta di autorità CA e installazione di certificati root.

5. Cifrare la password SMTP nel file di configurazione.

   È possibile cifrare la password SMTP utilizzando PIA o la utility PSCipher.

   Utilizzo di PIA

   1. Aprire il menu di navigazione nel dashboard PeopleSoft. Andare a PeopleTools, quindi selezionare Integration Broker.
   2. Selezionare Configurazione, quindi fare clic su Gateway. Selezionare il gateway LOCAL predefinito.
   3. Fare clic su Proprietà impostazione gateway. L'ID utente predefinito è amministratore e la password predefinita è la password selezionata durante l'impostazione.
   4. Fare clic sul collegamento Pagina Proprietà avanzate.
   5. Fare clic su Cifratura password nella parte inferiore della pagina. Qui è dove crittografare la password.

   Uso di PSCipher

   La utility PSCipher si trova in $PS_CFG_HOME/webserv/<DOMAIN>/piabin, dove <DOMAIN> è il dominio del server Web.

   Eseguire il comando riportato di seguito:

   ./PSCipher.sh <example-password>

   Nota
   
   

   La password può contenere caratteri speciali, pertanto sarà necessario racchiuderla tra apici. Ad esempio: ./PSCipher.sh '#rpassword$){'

6. Aggiornare le impostazioni SMTP nel server applicazioni PeopleSoft. Per ulteriori informazioni, vedere Impostazioni SMTP nella documentazione di PeopleSoft.

   Stabilire una connessione ssh al computer Application Server PeopleSoft (come nome utente "opc") ed effettuare le operazioni riportate di seguito.

   1. Passare all'utente psadm2 (ad esempio, sudo su - psadm2).
      Nota
      
      psadm2 è l'utente di dominio PeopleTools che crea e configura il dominio Application Server.
       
   2. Passare alla directory di configurazione di Appserver.

      Eseguire il comando riportato di seguito:

      $ cd $PS_CFG_HOME/appserv/APPDOM
      

   3. Eseguire il backup del file psappsrv.cfg originale.
   4. Aggiungere le seguenti informazioni al file psappsrv.cfg:

      SMTPServer=<SMTP connection endpoint>
      SMTPUserName=<username from SMTP credentials>
      SMTPUserPassword=<encrypted SMTP password>
      SMTPPort=587
      SMTPUseSSL=N
      SMTPSSLPort=587
      SMTPTLSEnable=true
      SMTPTLSRequired=true
      

      Nota
      
      

      Non includere uno spazio tra i valori "=" perché lo spazio può essere conteggiato nel valore della password, causando un errore di autenticazione.

7. Aggiungere l'indirizzo di posta elettronica primario per l'utente dell'applicazione PeopleSoft che sta tentando di inviare la notifica dall'interno dell'applicazione. In questo esempio, l'utente è "PS".

   Eseguire il login come "PS" ed effettuare le operazioni riportate di seguito.

   1. Aprire il menu di navigazione nel dashboard PeopleSoft. Andare a PeopleTools, quindi selezionare Sicurezza.
   2. Selezionare Profili utente, quindi fare clic su Profili utente. Trova il profilo per "PS".
   3. Nella scheda Generale fare clic su Modifica indirizzi e-mail.
   4. Inserire l'indirizzo e-mail del mittente approvato come indirizzo e-mail principale.
8. Eseguire il logout dall'applicazione PeopleSoft.
9. Eseguire il reboot dell'Application Server utilizzando la utility PSADMIN. Vedere Uso del menu Amministrazione di Application Server.
10. Eseguire il test della consegna della notifica e-mail.

    Eseguire il login a PIA come "PS" e selezionare Notifica in qualsiasi punto della console. Ad esempio, è possibile effettuare le seguenti operazioni:

    1. Andare a Peopletools, quindi selezionare Profilo Web.
    2. Selezionare Configurazione profilo Web.
    3. Fare clic su Search, quindi su PROD nei risultati di ricerca.
    4. Fare clic su Notifica, immettere i dettagli della notifica, quindi fare clic su OK.

    Confermare la ricezione dell'e-mail di test.

Per eseguire il debug degli errori SMTP (facoltativo):

1. È possibile aggiungere il seguente parametro per facilitare il debug SMTP: SMTPTrace=1

   Per utilizzare questo parametro, è necessario impostare LogFence su 5. Il sistema scrive le informazioni di log in SMTP<DDMM>.log in %PS_SERVDIR%/LOGS per impostazione predefinita oppure il valore personalizzato impostato per la directory di log.

   Ad esempio:

   $PS_CFG_HOME\APPSERV\domain\LOGS\SMTP6_27.log

2. Dopo aver impostato questo parametro, sarà necessario riavviare l'Application Server. Dopo aver impostato questo parametro, è possibile monitorare il log SMTP.
3. Digitare ls e trovare il file SMTP per la data di invio dell'e-mail.
4. Eseguire il comando riportato di seguito:

   tail -f <smtp log file and date>

   Ad esempio:

   tail -f SMTP9_17.log

   Cercare eventuali errori nell'output.