Intégration de PeopleSoft à Email Delivery

Configuration de PeopleSoft pour l'envoi de courriels via Email Delivery

Vous pouvez utiliser PeopleSoft pour envoyer des courriels via Email Delivery. Avant d'utiliser PeopleSoft, vous devez configurer Oracle Cloud Infrastructure Email Delivery dans votre application PeopleSoft.

Pour permettre l'intégration de PeopleSoft à Email Delivery, procédez comme suit :

1. Assurez-vous qu'Email Delivery est configuré pour envoyer des courriels. Reportez-vous à Introduction.
   Remarque
   
   

   Les informations d'identification SMTP sont requises afin de configurer PeopleSoft pour l'utilisation d'Email Delivery. Veillez à noter le nom utilisateur et le mot de passe lorsque vous générez les informations d'identification SMTP.

2. Exécutez la commande suivante pour afficher la chaîne de certificat :

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

   Exemple de sortie :

   [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. Extrayez le certificat qui a signé votre domaine. Dans cet exemple, il s'agit du dernier certificat (2 s:/C=US/O=DigiCert Inc/OU=www.digicert.com/CN=DigiCert Global Root G2). Copiez et collez le certificat dans un fichier DigiCert.pem distinct, y compris les champs BEGIN CERTIFICATE et END CERTIFICATE.
   Par exemple :

   -----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. Ajoutez les certificats à l'application PeopleSoft.

   Connectez-vous à Pure Internet Architecture (PIA) en tant qu'utilisateur "PS" et importez les certificats dans l'environnement cible. Reportez-vous à Installation de certificats numériques basés sur le serveur d'applications et à Ajout d'autorités de certification et installation de certificats racine.

5. Cryptez le mot de passe SMTP dans le fichier de configuration.

   Vous pouvez crypter le mot de passe SMTP à l'aide de PIA ou de l'utilitaire PSCipher.

   Utilisation de PIA

   1. Ouvrez le menu de navigation dans le tableau de bord PeopleSoft. Accédez à PeopleTools, puis sélectionnez Integration Broker.
   2. Sélectionnez Configuration, puis cliquez sur Passerelles. Sélectionnez la passerelle LOCAL par défaut.
   3. Cliquez sur Propriétés config. passerelle. L'ID utilisateur par défaut est administrator et le mot de passe par défaut est celui sélectionné lors de la configuration.
   4. Cliquez sur le lien Page propriétés avancées.
   5. Cliquez sur Chiffrement MdP en bas de la page. C'est là que vous allez crypter votre mot de passe.

   Utilisation de PSCipher

   L'utilitaire PSCipher se trouve dans $PS_CFG_HOME/webserv/<DOMAIN>/piabin, où <DOMAIN> est votre domaine de serveur Web.

   Exécutez la commande suivante :

   ./PSCipher.sh <example-password>

   Remarque
   
   

   Le mot de passe peut comporter des caractères spéciaux, vous devez donc le mettre entre apostrophes. Par exemple : ./PSCipher.sh '#rpassword$){'

6. Mettez à jour les paramètres SMTP sur le serveur d'applications PeopleSoft. Pour plus d'informations, reportez-vous à Paramètres SMTP dans la documentation PeopleSoft.

   Etablissez une connexion SSH à la machine de serveur d'applications PeopleSoft (sous le nom utilisateur "opc") et procédez comme suit :

   1. Basculez l'utilisateur sur psadm2 (par exemple, sudo su - psadm2).
      Remarque
      
      psadm2 est l'utilisateur de domaine PeopleTools qui crée et configure le domaine de serveur d'applications.
       
   2. Accédez au répertoire de configuration Appserver.

      Exécutez la commande suivante :

      $ cd $PS_CFG_HOME/appserv/APPDOM
      

   3. Sauvegardez le fichier psappsrv.cfg d'origine.
   4. Ajoutez les informations suivantes au fichier 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
      

      Remarque
      
      

      N'incluez pas d'espace entre le signe "=" et les valeurs car cet espace peut être prise en compte dans la valeur du mot de passe, et entraîner ainsi un échec d'authentification.

7. Ajoutez l'adresse électronique principale de l'utilisateur de l'application PeopleSoft qui essaie d'envoyer une notification à partir de l'application. Dans cet exemple, l'utilisateur est "PS".

   Connectez-vous en tant qu'utilisateur "PS" et effectuez les opérations suivantes :

   1. Ouvrez le menu de navigation dans le tableau de bord PeopleSoft. Accédez à PeopleTools, puis sélectionnez Sécurité.
   2. Sélectionnez Profils utilisateur, puis cliquez sur Profils utilisateur. Recherchez le profil de "PS".
   3. Dans l'onglet Général, cliquez sur Modifier adresses e-mail.
   4. Indiquez l'adresse électronique de l'expéditeur approuvé comme adresse électronique principale.
8. Déconnectez-vous de l'application PeopleSoft.
9. Réinitialisez le serveur d'applications à l'aide de l'utilitaire PSADMIN. Reportez-vous à Utilisation du menu d'administration de serveur d'applications.
10. Testez la remise des notifications par courriel.

    Connectez-vous à PIA en tant qu'utilisateur "PS", puis sélectionnez Notifier n'importe où dans la console. Vous pouvez par exemple effectuer les opérations suivantes :

    1. Accédez à Peopletools, puis sélectionnez Profil web.
    2. Sélectionnez Configuration profil web.
    3. Cliquez sur Rechercher, puis sur PROD dans les résultats de la recherche.
    4. Cliquez sur Notifier, saisissez les détails de la notification, puis cliquez sur OK.

    Confirmez la réception du courriel de test.

Pour déboguer les erreurs SMTP (facultatif), procédez comme suit :

1. Vous pouvez ajouter le paramètre suivant pour faciliter le débogage SMTP : SMTPTrace=1

   Pour que ce paramètre puisse être utilisé, LogFence doit être défini sur 5. Le système écrit les informations de journal dans le fichier SMTP<DDMM>.log dans %PS_SERVDIR%/LOGS par défaut, ou suit la valeur personnalisée définie pour le répertoire de journalisation.

   Par exemple :

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

2. Une fois ce paramètre défini, vous devez redémarrer le serveur d'applications. Après la définition du paramètre, vous pouvez surveiller le journal SMTP.
3. Entrez ls et recherchez le fichier SMTP correspondant à la date à laquelle vous avez envoyé le courriel.
4. Exécutez la commande suivante :

   tail -f <smtp log file and date>

   Par exemple :

   tail -f SMTP9_17.log

   Recherchez les erreurs dans la sortie.