PeopleSoft mit Email Delivery integrieren

PeopleSoft so konfigurieren, dass E-Mails über Email Delivery gesendet werden

Sie können PeopleSoft für den Versand von E-Mails über Email Delivery verwenden. Bevor Sie PeopleSoft verwenden, müssen Sie Oracle Cloud Infrastructure Email Delivery in Ihrer PeopleSoft Anwendung konfigurieren.

So ermöglichen Sie die Integration von PeopleSoft mit Email Delivery:

1. Stellen Sie sicher, dass Email Delivery zum Senden von E-Mails konfiguriert ist. Siehe Erste Schritte.
   Hinweis
   
   

   Die SMTP-Zugangsdaten sind erforderlich, um PeopleSoft zur Verwendung von Email Delivery zu konfigurieren. Notieren Sie den Benutzernamen und das Kennwort, wenn Sie die SMTP-Zugangsdaten generieren.

2. Führen Sie den folgenden Befehl aus, um die Zertifikatskette anzuzeigen:

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

   Beispielausgabe:

   [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. Extrahieren Sie das Zertifikat, mit dem Ihre Domain signiert wurde. In diesem Beispiel ist dies das letzte Zertifikat (2 s:/C=US/O=DigiCert Inc/OU=www.digicert.com/CN=DigiCert Global Root G2). Kopieren Sie das Zertifikat, und fügen Sie es in eine separate DigiCert.pem-Datei ein, einschließlich der Felder BEGIN CERTIFICATE und END CERTIFICATE.
   Beispiel:

   -----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. Fügen Sie die Zertifikate zur PeopleSoft Anwendung hinzu.

   Melden Sie sich bei Pure Internet Architecture (PIA) als Benutzer "PS" an, und importieren Sie die Zertifikate in die Zielumgebung. Weitere Informationen finden Sie unter Anwendungsserverbasierte digitale Zertifikate installieren und im Abschnitt Certificate Authoritys hinzufügen und Root-Zertifikate installieren.

5. Verschlüsseln Sie das SMTP-Kennwort in der Konfigurationsdatei.

   Sie können das SMTP-Kennwort mit PIA oder dem PSCipher-Utility verschlüsseln.

   PIA verwenden

   1. Öffnen Sie das Navigationsmenü im PeopleSoft Dashboard. Gehen Sie zu PeopleTools, und wählen Sie Integration Broker aus.
   2. Wählen Sie Konfiguration aus, und klicken Sie dann auf Gateways. Wählen Sie das Standardgateway LOCAL.
   3. Klicken Sie auf Gateway Setup-Eigenschaften. Die Standardbenutzerkennung lautet "administrator", und das Standardkennwort ist das Kennwort, das beim Setup ausgewählt wurde.
   4. Klicken Sie auf den Link Seite "Erweiterte Eigenschaften".
   5. Klicken Sie unten auf der Seite auf Kennwortverschlüsselung. Hier verschlüsseln Sie Ihr Kennwort.

   PSCipher verwenden

   Das PSCipher-Utility finden Sie unter $PS_CFG_HOME/webserv/<DOMAIN>/piabin, wobei <DOMAIN> Ihre Webserverdomain ist.

   Führen Sie den folgenden Befehl aus:

   ./PSCipher.sh <example-password>

   Hinweis
   
   

   Das Kennwort kann Sonderzeichen enthalten, deshalb müssen Sie es in einfache Anführungszeichen setzen. Beispiel: ./PSCipher.sh '#rpassword$){'

6. Aktualisieren Sie die SMTP-Einstellungen auf dem PeopleSoft Anwendungsserver. Weitere Informationen finden Sie in der PeopleSoft Dokumentation unter SMTP-Einstellungen.

   Stellen Sie eine SSH-Verbindung zum PeopleSoft Anwendungsserver her (als Benutzer "opc"), und führen Sie folgende Schritte aus:

   1. Wechseln Sie zum Benutzer psadm2 (Beispiel: sudo su - psadm2).
      Hinweis
      
      psadm2 ist der PeopleTools Domainbenutzer, der die Anwendungsserverdomain erstellt und konfiguriert.
       
   2. Navigieren Sie zum Konfigurationsverzeichnis des Anwendungsservers.

      Führen Sie den folgenden Befehl aus:

      $ cd $PS_CFG_HOME/appserv/APPDOM
      

   3. Sichern Sie die Originaldatei psappsrv.cfg.
   4. Fügen Sie der Datei psappsrv.cfg die folgenden Informationen hinzu:

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

      Hinweis
      
      

      Fügen Sie kein Leerzeichen zwischen "=" und den Werten ein, da das Leerzeichen im Wert für das Kennwort berücksichtigt werden könnte und hierdurch ein Authentifizierungsfehler verursacht würde.

7. Fügen Sie die primäre E-Mail-Adresse für den PeopleSoft Anwendungsbenutzer hinzu, der versucht, eine Benachrichtigung aus der Anwendung zu senden. In diesem Beispiel ist der Benutzer "PS".

   Melden Sie sich als "PS" an, und führen Sie folgende Schritte aus:

   1. Öffnen Sie das Navigationsmenü im PeopleSoft Dashboard. Gehen Sie zu PeopleTools, und wählen Sie Sicherheit aus.
   2. Wählen Sie Benutzerprofile aus, und klicken Sie auf Benutzerprofile. Suchen Sie das Profil für "PS".
   3. Klicken Sie auf der Registerkarte Allgemein auf E-Mail-Adressen bearbeiten.
   4. Geben Sie die E-Mail-Adresse des genehmigten Absenders als primäre E-Mail-Adresse ein.
8. Melden Sie sich bei der PeopleSoft Anwendung ab.
9. Starten Sie den Anwendungsserver mit dem Utility PSADMIN neu. Siehe Administrationsmenü des Anwendungsservers verwenden.
10. Testen Sie die Zustellung von E-Mail-Benachrichtigungen.

    Melden Sie sich bei PIA als "PS" an, und wählen Sie in der Konsole Benachrichtigen aus. Sie können zum Beispiel:

    1. Gehen Sie zu PeopleTools, und wählen Sie Webprofil aus.
    2. Wählen Sie Webprofilkonfiguration aus.
    3. Klicken Sie auf Suchen und in den Suchergebnissen auf PROD.
    4. Klicken Sie auf Benachrichtigen, geben Sie die Benachrichtigungsdetails ein, und klicken Sie auf OK.

    Bestätigen Sie den Eingang der Test-E-Mail.

So debuggen Sie SMTP-Fehler (optional):

1. Sie können den folgenden Parameter zur Hilfe beim SMTP-Debugging hinzufügen: SMTPTrace=1.

   "LogFence" muss auf 5 gesetzt sein, um diesen Parameter zu verwenden. Das System schreibt die Loginformationen standardmäßig in die Datei SMTP<DDMM>.log im Verzeichnis %PS_SERVDIR%/LOGS (oder im benutzerdefinierten Logverzeichnis).

   Beispiel:

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

2. Nachdem Sie diesen Parameter festgelegt haben, müssen Sie den Anwendungsserver neu starten. Ist dieser Parameter festgelegt, können Sie das SMTP-Log überwachen.
3. Geben Sie ls ein, und suchen Sie die SMTP-Datei für das Datum, an dem Sie die E-Mail gesendet haben.
4. Führen Sie den folgenden Befehl aus:

   tail -f <smtp log file and date>

   Beispiel:

   tail -f SMTP9_17.log

   Suchen Sie nach Fehlern in der Ausgabe.