Monitor

Back Next

Email Service

You can configure an email service to use, for example, in connection with an alert service triggered when processes are suspended on an uncaught fault. The email service settings enable you to send an email to a specified administrator.

If you execute processes designed with Process Designer, you can use

Application Integration Console

to configure one email service to use for processes that run on a Secure Agent and another email service for your organization's processes that run on the Cloud Server. You can then use the Send Email option when you define an Alert Service to send notifications when a process is suspended on an uncaught fault.

To define an email service, configure the following properties:

Property	Description
Enable SMTP Service	Select to enable the email service after you have configured all the properties.
Host	Enter the email server’s DNS name such as mail.mydomain.com or an IP address such as 192.168.1.1.
Port	Enter the port to use for communication between the Process Server and the email server. The default value is 25.
Authentication Type	Select password-based authentication or OAuth authentication.

To create the email connection using password-based authentication, configure the following properties:

Property	Description
Username	Required. Enter the name used to log in to your email server, usually the account name. This field is optional depending on whether the SMTP server requires credentials. For example: notifyme@mydomain.com
Password	Required. Enter and confirm the password for the user name.
Security	(Optional). Select a security protocol, if desired: TLS (Transport Layer Security) SSL (Secure Sockets Layer) Ensure that you configure the port to enable the appropriate security transport.

To create the email connection using OAuth authentication, configure the following properties on the connection creation page:

Property	Description
Authorization URL	Required. Enter the OAuth authorization URL for the email service that is used to authorize the user request. For example: https://login.microsoftonline.com/xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx/oauth2/v2.0/authorize
Token Request URL	Required. Enter the OAuth token request URL that handles token requests. For example: https://login.microsoftonline.com/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/oauth2/v2.0/token The refresh token expires in 90 days. The user must authenticate again and publish the connection before the token expires.
Client ID	Required. Specify the identifier value from the OAuth provider.
Client Secret	Required. Enter the client secret to connect to the email application.
Scope	Required. Specify the scope. The scope in OAuth authentication limits an application's access to a user's account. You can select multiple scopes for a single client. To enter multiple scopes, separate each value with a space. For a Microsoft Outlook email account, enter the following scope: https://outlook.office.com/SMTP.Send offline_access
Authorization Status	Indicates the current status, the name of the user who authorized, and the last time when the authorization was completed.
Authorize Access	Click to initiate the authorization workflow using OAuth.