Integrando o PeopleSoft com o Serviço Email Delivery

Configurar o PeopleSoft para Enviar E-mails por meio do Serviço Email Delivery

Você pode usar o PeopleSoft para enviar e-mails por meio do Serviço Email Delivery. Antes de usar o PeopleSoft, você deve configurar o Oracle Cloud Infrastructure Email Delivery no seu aplicativo PeopleSoft.

Para permitir que o PeopleSoft se integre ao serviço Email Delivery:

1. Certifique-se de que o serviço Email Delivery esteja configurado para enviar e-mails. Consulte Conceitos Básicos.
   Observação
   
   

   As credenciais SMTP são obrigatórias para configurar o PeopleSoft para usar o serviço Email Delivery. Não esqueça de anotar o nome de usuário e a senha ao gerar as credenciais SMTP.

2. Execute o seguinte comando para exibir a cadeia de certificados:

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

   Exemplo de saída:

   [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. Extraia o certificado que assinou seu domínio. Neste exemplo, este é o último certificado (2 s:/C=US/O=DigiCert Inc/OU=www.digicert.com/CN=DigiCert Global Root G2). Copie e cole o certificado em um arquivo DigiCert.pem separado, incluindo os campos BEGIN CERTFICATE e END CERTIFICATE.
   Por exemplo:

   -----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. Adicione os certificados ao aplicativo PeopleSoft.

   Faça log-in no PIA (Pure Internet Architecture) como o usuário "PS" e importe os certificados para o ambiente de destino. Consulte Instalando Certificados Digitais Baseados no Servidor de Aplicativos e consulte a seção Adicionando Autoridades de CA e Instalando Certificados Raiz.

5. Criptografe a senha SMTP no arquivo de configuração.

   Você pode criptografar a senha SMTP usando o PIA ou o utilitário PSCipher.

   Usando o PIA

   1. Abra o menu de navegação no painel de controle do PeopleSoft. Vá para o PeopleTools e selecione Integration Broker.
   2. Selecione Configuração e, em seguida, clique em Gateways. Selecione o gateway LOCAL padrão.
   3. Clique em Propriedades de Configuração do Gateway. O ID de usuário padrão é 'administrator' e a senha padrão é a senha selecionada durante a configuração.
   4. Clique no link Página Propriedades Avançadas.
   5. Clique em Criptografia de Senha na parte inferior da página. Esse é o local no qual você criptografará sua senha.

   Usando o PSCipher

   O utilitário PSCipher pode ser encontrado em $PS_CFG_HOME/webserv/<DOMAIN>/piabin, em que <DOMAIN> é o domínio do seu servidor Web.

   Execute o seguinte comando:

   ./PSCipher.sh <example-password>

   Observação
   
   

   A senha pode ter caracteres especiais; portanto, você precisará colocar a senha entre aspas simples. Por exemplo: ./PSCipher.sh '#rpassword$){'

6. Atualize as configurações SMTP no servidor de Aplicativos do PeopleSoft. Para obter mais informações, consulte Definições de SMTP na documentação do PeopleSoft.

   Estabeleça uma conexão ssh com a máquina do servidor de Aplicativos do PeopleSoft (como o nome de usuário "opc") e faça o seguinte:

   1. Alterne o usuário para psadm2 (por exemplo, sudo su - psadm2).
      Observação
      
      psadm2 é o usuário do domínio do PeopleTools que cria e configura o domínio do Servidor de Aplicativos.
       
   2. Navegue até o diretório de configuração do Appserver.

      Execute o seguinte comando:

      $ cd $PS_CFG_HOME/appserv/APPDOM
      

   3. Faça backup do arquivo psappsrv.cfg original.
   4. Adicione as seguintes informações ao arquivo 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
      

      Observação
      
      

      Não inclua espaço entre "=" e os valores porque o espaço pode ser contado no valor da senha, causando uma falha de autenticação.

7. Adicione o endereço de e-mail principal do usuário do aplicativo PeopleSoft que está tentando enviar notificações de dentro do aplicativo. Neste exemplo, o usuário é "PS".

   Faça log-in como "PS" e faça o seguinte:

   1. Abra o menu de navegação no painel de controle do PeopleSoft. Vá para o PeopleTools e selecione Segurança.
   2. Selecione Perfis de Usuário e clique em Perfis de usuário. Localize o perfil de "PS".
   3. Na guia Geral, clique em Editar Endereços de E-mail.
   4. Informe o endereço de e-mail do remetente aprovado como o endereço de e-mail principal.
8. Faça log-out do aplicativo PeopleSoft.
9. Reinicialize o servidor de aplicativos usando o utilitário PSADMIN. Consulte Usando o Menu Administração do Servidor de Aplicativos.
10. Teste a entrega da notificação por e-mail.

    Faça log-in no PIA como "PS" e selecione Notificar em qualquer lugar na console. Por exemplo, você pode fazer o seguinte:

    1. Vá para Peopletools e selecione Perfil da Web.
    2. Selecione Configuração do Perfil da Web.
    3. Clique em Pesquisar e, em seguida, em PROD nos resultados da pesquisa.
    4. Clique em Notificar, informe os detalhes da notificação e clique em OK.

    Confirme o recebimento do e-mail de teste.

Para depurar erros de SMTP (opcional):

1. Você pode adicionar o seguinte parâmetro para ajudar na depuração do SMTP: SMTPTrace=1

   O LogFence deve ser definido como 5 para usar este parâmetro. O sistema grava as informações de log em SMTP<DDMM>.log em %PS_SERVDIR%/LOGS por padrão ou o valor personalizado definido para o Diretório de Log.

   Por exemplo:

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

2. Depois de definir esse parâmetro, será necessário reinicializar o servidor de Aplicativos. Uma vez definido este parâmetro, você poderá monitorar o log de SMTP.
3. Digite ls e localize o arquivo SMTP correspondente à data em que você enviou o e-mail.
4. Execute o seguinte comando:

   tail -f <smtp log file and date>

   Por exemplo,

   tail -f SMTP9_17.log

   Procure eventuais erros no resultado.