PeopleSoftと電子メール配信の統合

電子メール配信を介した電子メール送信のためのPeopleSoftの構成

PeopleSoftを使用すると、電子メール配信を使用して電子メールを送信できます。PeopleSoftを使用する前に、PeopleSoftアプリケーションでOracle Cloud Infrastructure Email Deliveryを構成する必要があります。

PeopleSoftで電子メール配信との統合を有効にするには:

1. 電子メール配信が電子メールを送信するように構成されていることを確認します。開始を参照してください。
   ノート
   
   

   電子メール配信を使用するようにPeopleSoftを構成するには、SMTP資格証明が必要です。SMTP資格証明の生成時には、ユーザー名とパスワードを書き留めてください。

2. 次のコマンドを実行して、証明書チェーンを表示します:

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

   出力例:

   [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. ドメインに署名した証明書を抽出します。この例では、これが最後の証明書です(2 s:/C=US/O=DigiCert Inc/OU=www.digicert.com/CN=DigiCert Global Root G2)。証明書をコピーして、個別のDigiCert.pemファイルにBEGIN CERTFICATEおよびEND CERTIFICATEフィールドを含めて貼り付けます。
   例:

   -----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. PeopleSoftアプリケーションに証明書を追加します。

   Pure Internet Architecture (PIA)にユーザー"PS"としてログインし、ターゲット環境に証明書をインポートします。詳細は、アプリケーション・サーバーベースのデジタル証明書のインストールおよび認証局(CA)の追加およびルート証明書のインストールを参照してください。

5. 構成ファイル内のSMTPパスワードを暗号化します。

   PIAまたはPSCipherユーティリティを使用して、SMTPパスワードを暗号化できます。

   PIAの使用

   1. PeopleSoftダッシュボードのナビゲーション・メニューを開きます。「PeopleTools」に移動し、「インテグレーション ブローカー」を選択します。
   2. 「設定」を選択し、「ゲートウェイ」をクリックします。デフォルトのLOCALゲートウェイを選択します。
   3. 「ゲートウェイ設定プロパティ」をクリックします。デフォルトのユーザーIDは管理者で、デフォルトのパスワードは設定時に選択したパスワードです。
   4. 「詳細プロパティ ページ」リンクをクリックします。
   5. ページ下部の「パスワード暗号化」をクリックします。これは、パスワードを暗号化する場所です。

   PSCipherの使用

   PSCipherユーティリティは、$PS_CFG_HOME/webserv/<DOMAIN>/piabinの下にあります。<DOMAIN>はWebサーバー・ドメインです。

   次のコマンドを実行します。

   ./PSCipher.sh <example-password>

   ノート
   
   

   パスワードには特殊文字を使用できるため、パスワードを一重引用符で囲む必要があります。例: ./PSCipher.sh '#rpassword$){'

6. PeopleSoftアプリケーション・サーバーのSMTP設定を更新します。詳細は、PeopleSoftドキュメントの「SMTP設定」を参照してください。

   PeopleSoftアプリケーション・サーバーマシンへのssh接続を確立し(ユーザー名「opc」として)、次を実行します:

   1. ユーザーをpsadm2に切り替えます(例: sudo su - psadm2)。
      ノート
      
      psadm2は、アプリケーション・サーバー・ドメインを作成および構成するPeopleToolsドメイン・ユーザーです。
       
   2. アプリケーション・サーバー構成ディレクトリに移動します。

      次のコマンドを実行します。

      $ cd $PS_CFG_HOME/appserv/APPDOM
      

   3. 元のpsappsrv.cfgファイルをバックアップします。
   4. 次の情報を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
      

      ノート
      
      

      空白がパスワードの値としてみなされ、認証失敗の原因となる可能性があるため、「=」と値の間に空白を入れないでください。

7. アプリケーション内から通知を送信しようとしているPeopleSoftアプリケーション・ユーザーのプライマリ電子メール・アドレスを追加します。この例では、ユーザーは「PS」です。

   「PS」としてログインし、次のようにします:

   1. PeopleSoftダッシュボードのナビゲーション・メニューを開きます。「PeopleTools」に移動し、「セキュリティ」を選択します。
   2. 「ユーザー プロファイル」を選択し、「ユーザー プロファイル」をクリックします。「PS」のプロファイルを見つけます。
   3. 「一般」タブで、「電子メール アドレスの編集」をクリックします。
   4. 承認済送信者の電子メール・アドレスをプライマリ電子メール・アドレスとして入力します。
8. PeopleSoftアプリケーションからログアウトします。
9. PSADMINユーティリティを使用してアプリケーション・サーバーを再起動します。アプリケーション・サーバーの「管理」メニューの使用を参照してください。
10. 電子メール通知配信をテストします。

    「PS」としてPIAにログインし、コンソールの任意の場所に「通知」を選択します。たとえば、次の操作を実行できます。

    1. 「Peopletools」に移動して、「Webプロファイル」を選択します。
    2. 「Webプロファイルの設定」を選択します。
    3. 「検索」をクリックし、検索結果で「PROD」をクリックします。
    4. 「通知」をクリックし、通知の詳細を入力して、「OK」をクリックします。

    テスト電子メールの受信を確認します。

SMTPエラーをデバッグするには(オプション):

1. 次のパラメータを追加すると、SMTPのデバッグに役立ちます: SMTPTrace=1

   このパラメータを使用する場合は、LogFenceを5に設定する必要があります。デフォルトでは、ログ情報は%PS_SERVDIR%/LOGS内のSMTP<DDMM>.logに書き込まれます。またはログ・ディレクトリ用に設定されたカスタム値に書き込まれます。

   例:

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

2. このパラメータを設定した後に、アプリケーション・サーバーを再起動する必要があります。このパラメータを設定すると、SMTPのログをモニターできます。
3. lsと入力し、電子メールを送信した日付のSMTPファイルを見つけます。
4. 次のコマンドを実行します。

   tail -f <smtp log file and date>

   たとえば、

   tail -f SMTP9_17.log

   出力でエラーを検索します。