Email Account form –Completing the Email Account tab

You are here: Reference > Data classes > Email Account data instances > Email Account form –Completing the Email Account tab

Email Account form – Completing the Email Account tab
About New Email Account History More...

Use the Email Account form to configure email accounts that manage outgoing (Sender) and incoming (Receiver) email. You specify email addresses to send from and to reply to, SMTP host information, User IDs, passwords, and more. When you configure email for your application, you reference the Email Account name in the email listener's Account Information field so the listener can get the information it needs to route incoming and outgoing messages.

Select email provider

Optionally, click Select Email Provider to select from a list of commonly used email providers, such as Google Gmail and Yahoo mail. When you make a selection and click OK, some form fields, such as Host, Port, and Protocol, are populated automatically. You can edit any of the automatically-populated fields. Be aware, however, that the edited information on the form may no longer accurately represent the provider.

Note: Connection settings vary by email service provider and these settings should be obtained from the service providers.

Sender

Complete the fields in this section to configure outgoing mail.

Identity

Full name - Enter the full name of the sender.
From - Required. Specify the email address associated with email sent from this account.
User ID - Identify the SMTP User ID for sending email from this host. If no value is specified, the value in the From field is used.
Password - Enter the password for User ID sending mail from this host. Click Set Password, then enter the sender password.
Reply to - Enter the email address to which recipients of email messages sent from this account can reply. Use a working, valid email address that is reviewed by a person or is processed.

Connection

Host (SMTP) - Required. Enter the IP address or hostname of the SMTP host.
Port - Enter an SMTP server port number for outgoing email connections. The default options are:
- 25 (Unsecured)
- 587 (STARTTLS)
- 465 (SMTPS)
Use SMTPS - Enable only if the email service requires an SMTPS connection. Do not enable if the channel is to be secured by STARTTLS.

Message signing

Complete the fields in this section if your application will be sending digitally signed email.

Keystore instance - Enter the location of the keystore data instance used for digital signatures. Click the plus sign to create one.
Certificate alias - Enter one or more characters that match all or part of a specific certificate within the keystore data instance. If blank, Pega 7 Platform selects the first one it finds of the correct type.

After you save the Email Account form, click to confirm that Pega 7 Platform can connect to the SMTP host identified on this tab.

Receiver

Complete the fields in this section to configure inbound mail.

Identity

- User ID - Identify the SMTP User ID for sending email from this host. If no value is specified, the value in the From field is used.
- Password - Enter the password for User ID sending mail from this host. Click Set Password, then enter the sender password.

Connection

Host - Required. Enter the POP3 or IMAP mail server host name or IP address for receiving incoming email.
Port - Enter a POP3 or IMAP server port number for email connections:
- IMAP: 143 (Unsecured) or 993 (Secured with SSL)

POP3: 110 (Unsecured) or 995 (Secured with SSL)

Protocol - Use the drop-down menu to specify the server email protocol: IMAP or POP3. IMAP has a larger feature set than POP3, and is usually the preferred protocol for that reason.
Use SSL/TLS - Enable Secure Sockets Layer (SSL) protocol to secure the connection between Pega and the inbound email server.

After you save the Email Account form, click Test Connectivity to confirm that Pega can connect to the host identified on this tab. Review details that are displayed after the test is completed.

Advanced

Use this section to override the default settings used by the email receiver. Specify the key and value for valid JavaMail API IMAP and POP3 protocol provider properties as defined in the Java packages com.sun.mail.imap and com.sun.mail.pop3, respectively.

Note: Customizing the email receiver with these settings must be done with care and may result in an unproven, unsupported configuration

For example, it may be necessary to disable plain authentication for compatibility with some Microsoft Exchange servers:

Key - mail.imaps.auth.plain.disable

Value - true