exchange-version
Section: smtp-client
Default Value: Exchange2010
Valid Values: A valid Exchange server version, such as Exchange2010, Exchange2010_SP1, Exchange2010_SP2, Exchange2010_SP3, Exchange2013, Office365, Exchange2016
Changes Take Effect: At the next POP cycle
Modified: 8.5.201.05, 8.5.202.02
Specifies the version of the Exchange corporate server.
Note: For Exchange 2019 support, leave this option empty or set it to Exchange2016.
exchange-version
Section: pop-client
Default Value: Exchange2010
Valid Values: A valid exchange server version, such as Exchange2010, Exchange2010_SP1, Exchange2010_SP2, Exchange2010_SP3, Exchange2013, Office365, Exchange2016
Changes Take Effect: At the next POP cycle
Modified: 8.5.201.05, 8.5.202.02
Specifies the version of Exchange corporate server.
Note: For Exchange 2019 support, leave this option empty or set it to Exchange2016.
password
Section: secret-<secretName>
Default Value: No default value
Valid Values: The Google application client_secret value when an account is registered in Google
Changes Take Effect: At the next POP cycle for a POP client (pop-client) or at start/restart for an SMTP client (smtp-client)
Introduced: 8.5.201.05
Specifies the client_secret value of the corresponding Google application associated with the mailbox or the SMTP account.
tenant-authority
Section: smtp-client
Default Value: https://login.microsoftonline.com
Valid Values: The valid Microsoft authority server is https://login.microsoftonline.com. The valid Google authority server is a case-insensitive string that contains "google".
Changes Take Effect: At start/restart
Introduced: 8.5.107.06
Modified: 8.5.201.05, 8.5.202.02, 8.5.205.03
Specifies the authority server of the registered Microsoft Azure application for the Office 365 or the Google application for the Gmail SMTP account in the SMTP client. This parameter takes effect only when the mail.<server-type>.auth.mechanisms is set to XOAUTH2 or type is GRAPH.
secret
Section: smtp-client
Default Value: smtp
Valid Values: Any string without the white space
Changes Take Effect: At start/restart
Introduced: 8.5.201.05
Specifies the secretName of the secret-<secretName> section to associate with the Google application secret after the SMTP account is registered in Google. This is a Gmail-only option when an SMTP account is OAuth 2.0 enabled (mail.smtp.auth.mechanisms is XOAUTH2).
password
Section: smtp-client
Default Value: No default value
Valid Values: A valid password or refresh_token
Changes Take Effect: At start/restart
Modified: 8.5.201.05, 8.5.205.03
With basic authentication and OAuth 2.0 enabled (mail.ews.auth.mechanisms is XOAUTH2) for a Microsoft Azure mailbox, specifies the password used to authenticate the user with respect to the corporate e-mail server when sending out messages. You set this value during the E-mail Server setup. This applies only when enable-authentication is set to true.
For Gmail, if OAuth 2.0 is enabled (mail.smtp.auth.mechanisms is XOAUTH2), this option is used for the refresh_token of the SMTP account.
client-id
Section: smtp-client
Default Value: No default value
Valid Values: A valid Client ID of the Microsoft Azure or Google application provided by the customer after the mailbox is registered in Microsoft Azure or Google
Changes Take Effect: At start/restart
Introduced: 8.5.107.06
Modified: 8.5.201.05, 8.5.202.02, 8.5.205.03
Specifies the Client ID of the registered Microsoft Azure application for the Office 365 or the Google application for the Gmail account in the SMTP client. This parameter takes effect only when the mail.<server-type>.auth.mechanisms is set to XOAUTH2 or type is GRAPH.
tenant-authority
Section: pop-client
Default Value: https://login.microsoftonline.com
Valid Values: The valid Microsoft authority server is https://login.microsoftonline.com. The valid Google authority server is a case-insensitive string that contains "google".
Changes Take Effect: At the next POP cycle
Introduced: 8.5.107.06
Modified: 8.5.201.05, 8.5.202.02, 8.5.205.03
Specifies the authority server of the registered Microsoft Azure application for the Office 365 or the Google application for the Gmail mailbox in the corresponding POP client. This parameter takes effect only when the mail.<type>.auth.mechanisms is set to XOAUTH2 or type is GRAPH.
secret
Section: pop-client
Default Value: No default value
Valid Values: Any string without the white space
Changes Take Effect: At the next POP cycle
Introduced: 8.5.201.05
Modified: 8.5.202.02
Specifies the secretName of the secret-<secretName> section to associate with the Google application secret after the mailbox is registered in Google. This is a Gmail-only option when a mailbox is OAuth 2.0 enabled (mail.<type>.auth.mechanisms is XOAUTH2).
password
Section: pop-client
Default Value: No default value
Valid Values: A valid password or refresh_token
Changes Take Effect: At the next POP cycle
Modified: 8.5.205.03
Specifies the password associated with this account for basic authentication and OAuth2 enabled (mail.ews.auth.mechanisms is XOAUTH2) for a Microsoft Azure mailbox. You set this value during the E-mail Server setup.
For Gmail, if a mailbox is OAuth2 enabled (mail.imap.auth.mechanisms is XOAUTH2), this option is used for the refresh_token of the mailbox.
client-id
Section: pop-client
Default Value: No default value
Valid Values: A valid Client ID of the Microsoft Azure or Google application provided by the customer after the mailbox is registered in Microsoft Azure or Google
Changes Take Effect: At the next POP cycle
Introduced: 8.5.107.06
Modified: 8.5.201.05, 8.5.202.02, 8.5.205.03
Specifies the Client ID of the registered Microsoft Azure application for the Office 365 mailbox or the Google application for the Gmail mailbox in the corresponding POP client. This parameter takes effect only when the mail.<type>.auth.mechanisms is set to XOAUTH2 or type is GRAPH..
8.5.201.05
E-mail Server Release Notes
| Release Date | Release Type | Restrictions | AIX | Linux | Mac | Solaris | Windows |
|---|---|---|---|---|---|---|---|
| 03/31/21 | Update | X | X |
Helpful Links
Releases Info
Product Documentation
Genesys Products
What's New
This release contains the following new features and enhancements:
- Support for the OAuth 2.0 authorization access to Gmail mailboxes with the IMAP and SMTP protocols. See Setting up Gmail mailboxes for OAuth 2.0 authorization for details. (ESR-15288)
- The following configuration options were modified or added to support this functionality:
- [pop-client] section:
- [smtp-client] section:
- The new section, [secret-<secretName>], is added with the password option.
- The following configuration options were modified or added to support this functionality:
- Support for Microsoft Exchange 2016. (ESR-15334)
- The following configuration options were modified to support this functionality:
- [pop-client] section: exchange-version
- [smtp-client] section: exchange-version
- The following configuration options were modified to support this functionality:
Resolved Issues
This release contains the following resolved issues:
E-mail Server now correctly handles the logging keys. Previously, some logging keys were not handled correctly and caused E-mail Server to post a Null pointer exception when a connection to a mailbox failed. (ESR-15375, ESR-15370)
Upgrade Notes
No special procedure is required to upgrade to release 8.5.201.05.