Intégration de PeopleSoft avec le service de transmission de messages

Configurer PeopleSoft pour l'envoi de courriels au moyen du service de transmission de messages

Vous pouvez utiliser PeopleSoft pour envoyer des courriels au moyen du service de transmission de messages. Avant d'utiliser PeopleSoft, vous devez configurer le service de transmission de messages pour Oracle Cloud Infrastructure dans votre application PeopleSoft.

Pour activer PeopleSoft afin d'intégrer la transmission de messages :

1. Assurez-vous que le service de transmission de messages est configuré. Voir Introduction.
   Note
   
   

   Les données d'identification SMTP sont requises pour configurer PeopleSoft afin qu'il puisse utiliser le service de transmission de messages. Veuillez noter le nom d'utilisateur et le mot de passe lorsque vous générez les données d'identification SMTP.

2. Exécutez la commande suivante pour afficher la chaîne du 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 CERTFICATE 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. Voir Installation des certificats numériques basés sur le serveur d'applications et Ajout d'autorités de certification et installation des certificats racines.

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

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

   Utilisation de PIA

   1. Ouvrez le menu de navigation du tableau de bord PeopleSoft. Allez à PeopleTools, puis sélectionnez Gestionnaire intégration.
   2. Sélectionnez Configuration, puis cliquez sur Passerelles. Sélectionnez la passerelle LOCAL par défaut.
   3. Cliquez sur Propriétés passerelle. L'ID utilisateur par défaut correspond à l'administrateur et le mot de passe par défaut est le mot de passe sélectionné lors de la configuration.
   4. Cliquez sur le lien Page Propriétés détaillées.
   5. Cliquez sur Chiffrement mot passe au bas de la page. C'est à cet endroit que vous pourrez chiffrer votre mot de passe.

   Utilisation de PSCipher

   L'utilitaire PSCipher se trouve sous $PS_CFG_HOME/webserv/<DOMAIN>/piabin où <DOMAIN> correspond à votre domaine de serveur Web.

   Exécutez la commande suivante :

   ./PSCipher.sh <example-password>

   Note
   
   

   Le mot de passe peut comporter des caractères spéciaux. De la sorte, vous devez encadrer le mot de passe par des guillemets simples. Par exemple : ./PSCipher.sh '#rpassword$){'

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

   Établissez une connexion SSH à la machine du serveur d'applications PeopleSoft (nom d'utilisateur "opc") et effectuez les opérations suivantes :

   1. Passez à l'utilisateur psadm2 (par exemple, sudo su - psadm2).
      Note
      
      psadm2 est l'utilisateur de domaine PeopleTools qui crée et configure le domaine du serveur d'applications.
       
   2. Naviguez jusqu'au répertoire de configuration du serveur d'applications.

      Exécutez la commande suivante :

      $ cd $PS_CFG_HOME/appserv/APPDOM
      

   3. Sauvegardez le fichier psappsrv.cfg initial.
   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
      

      Note
      
      

      N'incluez pas d'espace entre les valeurs et "=", car il risque d'être inclus dans la valeur du mot de passe, ce qui pourrait entraîner un échec d'authentification.

7. Ajoutez l'adresse de courriel principale de l'utilisateur de l'application PeopleSoft qui tente d'envoyer l'avis depuis l'application. Dans cet exemple, l'utilisateur est "PS".

   Connectez-vous en tant qu'utilisateur "PS" et réalisez les actions suivantes :

   1. Ouvrez le menu de navigation du tableau de bord PeopleSoft. Allez à PeopleTools, puis sélectionnez Sécurité.
   2. Sélectionnez Profils d'utilisateur, puis cliquez sur Profils d'utilisateur. Recherchez le profil de l'utilisateur "PS".
   3. Dans l'onglet Général, cliquez sur Modifier adresses courriel.
   4. Entrez l'adresse de courriel de l'expéditeur approuvé à titre d'adresse de courriel principale.
8. Déconnectez-vous de l'application PeopleSoft.
9. Redémarrez le serveur d'applications au moyen de l'utilitaire PSADMIN. Voir Utilisation du menu Administration du serveur d'applications.
10. Testez la transmission de l'avis par courriel.

    Connectez-vous à PIA en tant que "PS" et sélectionnez Avis n'importe où dans la console. Par exemple, vous pouvez effectuer les opérations suivantes :

    1. Allez à Peopletools, puis sélectionnez Profil Web.
    2. Sélectionnez Configuration profils Web.
    3. Cliquez sur Rechercher, puis sur PROD dans les résultats de la recherche.
    4. Cliquez sur Avis, entrez les détails de l'avis et cliquez sur OK.

    Confirmez la réception du courriel de test.

Pour déboguer les erreurs SMTP (facultatif) :

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

   La valeur de LogFence doit être réglée à 5 pour utiliser ce paramètre. Le système consigne les informations dans SMTP<DDMM>.log dans le répertoire %PS_SERVDIR%/LOGS par défaut ou en fonction du jeu de valeurs personnalisées pour le répertoire de journaux.

   Par exemple :

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

2. Après avoir défini ce paramètre, vous devrez redémarrer le serveur d'applications. Une fois ce paramètre défini, 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 toute erreur dans la sortie.