Integración de PeopleSoft con Email Delivery

Configuración de PeopleSoft para enviar correo electrónico a través de Email Delivery

Puede utilizar PeopleSoft para enviar correos electrónicos a través de Email Delivery. Antes de utilizar PeopleSoft, debe configurar Oracle Cloud Infrastructure Email Delivery en la aplicación PeopleSoft.

Para activar la integración de PeopleSoft con Email Delivery:

1. Asegúrese de que Email Delivery está configurado para enviar correo electrónico. Consulte Introducción.
   Nota
   
   

   Se necesitan las credenciales SMTP para configurar PeopleSoft para utilizar Email Delivery. Asegúrese de anotar el nombre de usuario y la contraseña al generar las credenciales SMTP.

2. Ejecute el siguiente comando para ver la cadena de certificados:

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

   Resultado de ejemplo:

   [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. Extraiga el certificado que firmó el dominio. En este ejemplo, este es el último certificado (2 s:/C=US/O=DigiCert Inc/OU=www.digicert.com/CN=DigiCert Global Root G2). Copie y pegue el certificado en un archivo DigiCert.pem independiente, incluidos los campos BEGIN CERTFICATE y END CERTIFICATE.
   Por ejemplo:

   -----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. Agregue los certificados a la aplicación PeopleSoft.

   Conéctese a Pure Internet Architecture (PIA) como usuario "PS" e importe los certificados en el entorno de destino. Consulte Instalación de certificados digitales basados en un servidor de aplicaciones y la sección Agregación de autoridades CA e instalación de certificados raíz.

5. Cifre la contraseña de SMTP en el archivo de configuración.

   Puede cifrar la contraseña de SMTP mediante PIA o la utilidad PSCipher.

   Uso de PIA

   1. Abra el menú de navegación en el panel de control de PeopleSoft. Vaya a PeopleTools y, a continuación, seleccione Integration Broker.
   2. Seleccione Configuración y, a continuación, haga clic en Gateways. Seleccione el gateway LOCAL predeterminado.
   3. Haga clic en Propiedades de configuración de gateway. El ID de usuario por defecto es "administrator", y la contraseña por defecto es la que se seleccionó durante la configuración.
   4. Haga clic en el enlace Página de propiedades avanzadas.
   5. Haga clic en Cifrado de la contraseña en la parte inferior de la página. Aquí se cifrará la contraseña.

   Uso de PSCipher

   La utilidad PSCipher se encuentra en $PS_CFG_HOME/webserv/<DOMAIN>/piabin (<DOMAIN> corresponde al dominio de su servidor web).

   Ejecute el siguiente comando:

   ./PSCipher.sh <example-password>

   Nota
   
   

   La contraseña puede tener caracteres especiales, por lo que tendrá que incluir la contraseña entre comillas simples. Por ejemplo: ./PSCipher.sh '#rpassword$){'

6. Actualice los valores de SMTP en el servidor de aplicaciones de PeopleSoft. Para obtener más información, consulte Configuración SMTP en la documentación de PeopleSoft.

   Establezca una conexión ssh con el servidor de aplicaciones PeopleSoft (con nombre de usuario "opc") y haga lo siguiente:

   1. Cambie el usuario a psadm2 (por ejemplo, sudo su - psadm2).
      Nota
      
      psadm2 es el usuario del dominio de PeopleTools que crea y configura el dominio del servidor de aplicaciones.
       
   2. Navegue al directorio de configuración de Appserver.

      Ejecute el siguiente comando:

      $ cd $PS_CFG_HOME/appserv/APPDOM
      

   3. Realice una copia de seguridad del archivo psappsrv.cfg original.
   4. Agregue la siguiente información al archivo 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
      
      

      No añada ningún espacio entre el signo "=" y los valores, ya que el espacio puede tenerse en cuenta para el valor de la contraseña y dar lugar a fallos de autenticación.

7. Agregue la dirección de correo electrónico principal del usuario de la aplicación PeopleSoft que está intentando enviar notificaciones desde la aplicación. En este ejemplo, el usuario es "PS".

   Inicie sesión como "PS" y haga lo siguiente:

   1. Abra el menú de navegación en el panel de control de PeopleSoft. Vaya a PeopleTools y, a continuación, seleccione Seguridad.
   2. Seleccione Perfiles de usuario y, a continuación, haga clic en Perfiles de usuario. Busque el perfil para "PS".
   3. En el separador General, haga clic en Editar direcciones de correo electrónico.
   4. Introduzca la dirección de correo electrónico del remitente aprobado como dirección de correo electrónico principal.
8. Salga de la aplicación PeopleSoft.
9. Reinicie el servidor de aplicaciones mediante la utilidad PSADMIN. Consulte Uso del menú de administración del servidor de aplicaciones.
10. Pruebe la entrega de la notificación por correo electrónico.

    Conéctese a PIA como "PS" y seleccione Notificar en cualquier lugar de la consola. Por ejemplo, puede realizar lo siguiente:

    1. Vaya a Peopletools y, a continuación, seleccione Perfil web.
    2. Seleccione Configuración de perfil web.
    3. Haga clic en Buscar y, a continuación, haga clic en PROD en los resultados de búsqueda.
    4. Haga clic en Notificar, introduzca los detalles de la notificación y, a continuación, haga clic en Aceptar.

    Confirme la recepción del correo electrónico de prueba.

Para depurar errores SMTP (opcional):

1. Puede agregar el siguiente parámetro para ayudar con la depuración SMTP: SMTPTrace=1

   LogFence debe establecerse en 5 para utilizar este parámetro. El sistema escribe la información del log en SMTP<DDMM>.log en %PS_SERVDIR%/LOGS por defecto, o en el valor personalizado que se haya establecido para el directorio del log.

   Por ejemplo:

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

2. Después de definir este parámetro, deberá reiniciar el servidor de aplicaciones. Una vez definido este parámetro, puede supervisar el log SMTP.
3. Escriba ls y busque el archivo SMTP en la fecha de envío del correo electrónico.
4. Ejecute el siguiente comando:

   tail -f <smtp log file and date>

   Por ejemplo:

   tail -f SMTP9_17.log

   Busque cualquier error en el resultado.