KB-1817 Errors due to special characters in password.properties

Parmida Borhani — Wed, 12 Dec 2018 06:23:31 GMT

Current Revision posted to Appian Knowledge Base by Parmida Borhani on 12/12/2018 6:23:31 AM

Symptoms

A mail server is set up to be used with Appian. Appian is configured for either:

SMTP server authentication, with conf.mailhandler.mail.smtp.auth=true in custom.properties.
Email Polling.

When configured for SMTP server authentication, the following error message is seen in the application server log:

ERROR com.appiancorp.process.runtime.activities.SendEmailActivity - javax.mail.AuthenticationFailedException: 535 5.7.8 Error: authentication failed: authentication failure

When configured for polling an email account, the following error message is seen mail-listener.log:

ERROR com.appiancorp.process.emailpoller.MailActivation - An error occurred while attempting to open the mailbox to poll; no mail will be fetched. 
javax.mail.AuthenticationFailedException: Authentication failed.

The following are both true when configured for SMTP server authentication:

The SMTP username, conf.mailhandler.mail.user, in custom.properties is correct.
The associated password, conf.password.SMTP, in password.properties is correct.

The following are both true when configured for polling an email account:

The email username conf.mailhandler.poller.EmailHandlerBean.userName in custom.properties is correct.
The associated password conf.password.EmailHandlerBean.EMAIL_HANDLER in password.properties is correct.

Cause

Some special characters within password.properties need to be escaped when used in:

The STMP password field, conf.password.SMTP
The email user password field, conf.password.EmailHandlerBean.EMAIL_HANDLER

The characters which need to be escaped may vary depending on the mail server being used. For example, it is known that the character , needs to be escaped.

Action

If it is determined a special character needs to be escaped, add the characters \\ in front of the special character.

E.g. conf.password.SMTP=password\\,example

Some special characters do not need to be escaped. To test if a special character needs to be escaped when authentication is failing:

Change the password to remove the special character in question.
If authentication is successful without the special character, re-add the special character and escape it with \\.

Affected Versions

This article applies to Appian 17.2 and later.

Last Reviewed: December 2018

Tags: email, authentication, infrastructure

DRAFT KB-XXXX Errors due to special characters in password.properties

Tom Ryan — Tue, 11 Dec 2018 18:54:02 GMT

Revision 20 posted to Appian Knowledge Base by Tom Ryan on 12/11/2018 6:54:02 PM

Symptoms

A mail server is set up to be used with Appian. Appian is configured for either:

SMTP server authentication, with conf.mailhandler.mail.smtp.auth=true in custom.properties.
Email Polling.

When configured for SMTP server authentication, the following error message is seen in the application server log:

ERROR com.appiancorp.process.runtime.activities.SendEmailActivity - javax.mail.AuthenticationFailedException: 535 5.7.8 Error: authentication failed: authentication failure

When configured for polling an email account, the following error message is seen mail-listener.log:

ERROR com.appiancorp.process.emailpoller.MailActivation - An error occurred while attempting to open the mailbox to poll; no mail will be fetched. 
javax.mail.AuthenticationFailedException: Authentication failed.

The following are both true when configured for SMTP server authentication:

The SMTP username, conf.mailhandler.mail.user, in custom.properties is correct.
The associated password, conf.password.SMTP, in password.properties is correct.

The following are both true when configured for polling an email account:

The email username conf.mailhandler.poller.EmailHandlerBean.userName in custom.properties is correct.
The associated password conf.password.EmailHandlerBean.EMAIL_HANDLER in password.properties is correct.

Cause

Some special characters within password.properties need to be escaped when used in:

The STMP password field, conf.password.SMTP
The email user password field, conf.password.EmailHandlerBean.EMAIL_HANDLER

The characters which need to be escaped may vary depending on the mail server being used. For example, it is known that the character , needs to be escaped.

Action

If it is determined a special character needs to be escaped, add the characters \\ in front of the special character.

E.g. conf.password.SMTP=password\\,example

Some special characters do not need to be escaped. To test if a special character needs to be escaped when authentication is failing:

Change the password to remove the special character in question.
If authentication is successful without the special character, re-add the special character and escape it with \\.

Affected Versions

This article applies to Appian 17.2 and later.

Last Reviewed: November 2018

Tags: email, authentication, infrastructure

DRAFT KB-XXXX Errors due to special characters in password.properties

Zach Puderbach — Thu, 15 Nov 2018 14:39:19 GMT

Revision 19 posted to Appian Knowledge Base by Zach Puderbach on 11/15/2018 2:39:19 PM

Symptoms

A mail server is set up to be used with Appian. Appian is configured for either:

SMTP server authentication, with conf.mailhandler.mail.smtp.auth=true in custom.properties.
Email Polling.

When configured for SMTP server authentication, the following error message is seen in the application server log:

ERROR com.appiancorp.process.runtime.activities.SendEmailActivity - javax.mail.AuthenticationFailedException: 535 5.7.8 Error: authentication failed: authentication failure

When configured for polling an email account, the following error message is seen mail-listener.log:

ERROR com.appiancorp.process.emailpoller.MailActivation - An error occurred while attempting to open the mailbox to poll; no mail will be fetched. 
javax.mail.AuthenticationFailedException: Authentication failed.

The following are both true when configured for SMTP server authentication:

The SMTP username, conf.mailhandler.mail.user, in custom.properties is correct.
The associated password, conf.password.SMTP, in password.properties is correct.

The following are both true when configured for polling an email account:

The email username conf.mailhandler.poller.EmailHandlerBean.userName in custom.properties is correct.
The associated password conf.password.EmailHandlerBean.EMAIL_HANDLER in password.properties is correct.

Cause

Some special characters within password.properties need to be escaped when used in:

The STMP password field, conf.password.SMTP
The email user password field, conf.password.EmailHandlerBean.EMAIL_HANDLER

For example, it is known that the character , needs to be escaped.

Action

If it is determined a special character needs to be escaped, add the characters \\ in front of the special character.

E.g. conf.password.SMTP=password\\,example

Some special characters do not need to be escaped. To test if a special character needs to be escaped when authentication is failing:

Change the password to remove the special character in question.
If authentication is successful without the special character, re-add the special character and escape it with \\.

Affected Versions

This article applies to Appian 17.2 and later.

Last Reviewed: November 2018

Tags: email, authentication, infrastructure

DRAFT KB-XXXX Errors due to special characters in password.properties

Rebecca Jonas — Thu, 15 Nov 2018 14:15:04 GMT

Revision 18 posted to Appian Knowledge Base by Rebecca Jonas on 11/15/2018 2:15:04 PM

Symptoms

A mail server is set up to be used with Appian. Appian is configured for either:

SMTP server authentication, with conf.mailhandler.mail.smtp.auth=true in custom.properties.
Email Polling.

When configured for SMTP server authentication, the following error message is seen in the application server log:

ERROR com.appiancorp.process.runtime.activities.SendEmailActivity - javax.mail.AuthenticationFailedException: 535 5.7.8 Error: authentication failed: authentication failure

When configured for polling an email account, the following error message is seen mail-listener.log:

ERROR com.appiancorp.process.emailpoller.MailActivation - An error occurred while attempting to open the mailbox to poll; no mail will be fetched. 
javax.mail.AuthenticationFailedException: Authentication failed.

The following are both true when configured for SMTP server authentication:

The SMTP username, conf.mailhandler.mail.user, in custom.properties is correct.
The associated password, conf.password.SMTP, in password.properties is correct.

The following are both true when configured for polling an email account:

The email username conf.mailhandler.poller.EmailHandlerBean.userName in custom.properties is correct.
The associated password conf.password.EmailHandlerBean.EMAIL_HANDLER in password.properties is correct.

Cause

Some special characters within password.properties need to be escaped when used in:

The STMP password field, conf.password.SMTP
The email user password field, conf.password.EmailHandlerBean.EMAIL_HANDLER

For example, it is known that the character , needs to be escaped.

Action

If it is determined a special character needs to be escaped, add the characters \\ in front of the special character.

E.g. conf.password.SMTP=password\\,example

Some special characters do not need to be escaped. If it is unsure if a special character needs to be escaped:

Change the password to remove the special character in question.
If authentication is successful without the special character, re-add the special character and escape it with \\.

Affected Versions

This article applies to Appian 17.2 and later.

Last Reviewed: November 2018

Tags: email, authentication, infrastructure

DRAFT KB-XXXX Errors due to special characters in password.properties

Zach Puderbach — Thu, 15 Nov 2018 14:12:16 GMT

Revision 17 posted to Appian Knowledge Base by Zach Puderbach on 11/15/2018 2:12:16 PM

Symptoms

A mail server is set up to be used with Appian. Appian is configured for either:

SMTP server authentication, with conf.mailhandler.mail.smtp.auth=true in custom.properties.
Email Polling.

When configured for SMTP server authentication, the following error message is seen in the application server log:

ERROR com.appiancorp.process.runtime.activities.SendEmailActivity - javax.mail.AuthenticationFailedException: 535 5.7.8 Error: authentication failed: authentication failure

When configured for polling an email account, the following error message is seen mail-listener.log:

ERROR com.appiancorp.process.emailpoller.MailActivation - An error occurred while attempting to open the mailbox to poll; no mail will be fetched. 
javax.mail.AuthenticationFailedException: Authentication failed.

The following are both true when configured for SMTP server authentication:

The SMTP username, conf.mailhandler.mail.user, in custom.properties is correct.
The associated password, conf.password.SMTP, in password.properties is correct.

The following are both true when configured for polling an email account:

The email username conf.mailhandler.poller.EmailHandlerBean.userName in custom.properties is correct.
The associated password conf.password.EmailHandlerBean.EMAIL_HANDLER in password.properties is correct.

Cause

Some special characters within password.properties need to be escaped when used in:

The STMP password field, conf.password.SMTP
The email user password field, conf.password.EmailHandlerBean.EMAIL_HANDLER

For example, it is known that the character , needs to be escaped.

Action

If it is determined a special character needs to be escaped, add the characters \\ in front of the special character.

E.g. conf.password.SMTP=password\\,example

However, some special characters do not need to be escaped. If it is unsure if a special character needs to be escaped:

Change the password to remove the special character in question.
If authentication is successful without the special character, re-add the special character and escape it with \\.

Affected Versions

This article applies to Appian 17.2 and later.

Last Reviewed: November 2018

Tags: email, authentication, infrastructure

DRAFT KB-XXXX Errors due to special characters in password.properties

Rebecca Jonas — Thu, 15 Nov 2018 13:43:14 GMT

Revision 16 posted to Appian Knowledge Base by Rebecca Jonas on 11/15/2018 1:43:14 PM

Symptoms

A mail server is set up to be used with Appian. Appian is configured for either:

SMTP server authentication, with conf.mailhandler.mail.smtp.auth=true in custom.properties.
Email Polling.

When configured for SMTP server authentication, the following error message is seen in the application server log:

ERROR com.appiancorp.process.runtime.activities.SendEmailActivity - javax.mail.AuthenticationFailedException: 535 5.7.8 Error: authentication failed: authentication failure

When configured for polling an email account, the following error message is seen mail-listener.log:

ERROR com.appiancorp.process.emailpoller.MailActivation - An error occurred while attempting to open the mailbox to poll; no mail will be fetched. 
javax.mail.AuthenticationFailedException: Authentication failed.

The following are both true when configured for SMTP server authentication:

The SMTP username, conf.mailhandler.mail.user, in custom.properties is correct.
The associated password, conf.password.SMTP, in password.properties is correct.

The following are both true when configured for polling an email account:

The email username conf.mailhandler.poller.EmailHandlerBean.userName in custom.properties is correct.
The associated password conf.password.EmailHandlerBean.EMAIL_HANDLER in password.properties is correct.

Cause

Some special characters within password.properties need to be escaped when used in:

The STMP password field, conf.password.SMTP
The email user password field, conf.password.EmailHandlerBean.EMAIL_HANDLER

For example, it is known that the character , needs to be escaped.

Action

If it is determined a special character needs to be escaped, add the characters \\ in front of the special character.

E.g. conf.password.SMTP=password\\,example

If it is unsure if a special character needs to be escaped:

Change the password to remove the special character in question.
If authentication is successful without the special character, re-add the special character and escape it with \\.

Affected Versions

This article applies to Appian 17.2 and later.

Last Reviewed: November 2018

Tags: email, authentication, infrastructure

DRAFT KB-XXXX Errors due to special characters in password.properties

Zach Puderbach — Thu, 15 Nov 2018 12:00:54 GMT

Revision 15 posted to Appian Knowledge Base by Zach Puderbach on 11/15/2018 12:00:54 PM

Symptoms

A mail server is set up to be used with Appian. Appian is configured for either:

SMTP server authentication, with conf.mailhandler.mail.smtp.auth=true in custom.properties.
Email Polling.

When configured for SMTP server authentication, the following error message is seen in the application server log:

ERROR com.appiancorp.process.runtime.activities.SendEmailActivity - javax.mail.AuthenticationFailedException: 535 5.7.8 Error: authentication failed: authentication failure

When configured for polling an email account, the following error message is seen mail-listener.log:

ERROR com.appiancorp.process.emailpoller.MailActivation - An error occurred while attempting to open the mailbox to poll; no mail will be fetched. 
javax.mail.AuthenticationFailedException: Authentication failed.

The following are both true when configured for SMTP server authentication:

The SMTP username, conf.mailhandler.mail.user, in custom.properties is correct.
The associated password, conf.password.SMTP, in password.properties is correct.

The following are both true when configured for polling an email account:

The email username conf.mailhandler.poller.EmailHandlerBean.userName in custom.properties is correct.
The associated password conf.password.EmailHandlerBean.EMAIL_HANDLER in password.properties is correct.

Cause

Some special characters within password.properties need to be escaped when used in:

The STMP password field, conf.password.SMTP
The email user password field, conf.password.EmailHandlerBean.EMAIL_HANDLER

It is known the character , needs to be escaped.

Action

If it is determined a special character needs to be escaped, add the characters \\ in front of the special character.

E.g. conf.password.SMTP=password\\,example

If it is unsure a special character needs to be escaped:

Change the password to remove the special character in question.
If authentication is successful without the special character, re-add the special character and escape it with \\.

Affected Versions

This article applies to all Appian versions 17.2 and later.

Last Reviewed: November 2018

Tags: email, authentication, infrastructure

DRAFT KB-XXXX Errors due to special characters in password.properties

Zach Puderbach — Thu, 15 Nov 2018 11:55:21 GMT

Revision 14 posted to Appian Knowledge Base by Zach Puderbach on 11/15/2018 11:55:21 AM

Symptoms

An SMTP server is set up to be used with Appian. Appian is configured for either:

SMTP server authentication, with conf.mailhandler.mail.smtp.auth=true in custom.properties.
Email Polling.

When configured for SMTP server authentication, the following error message is seen in the application server log:

ERROR com.appiancorp.process.runtime.activities.SendEmailActivity - javax.mail.AuthenticationFailedException: 535 5.7.8 Error: authentication failed: authentication failure

When configured for polling an email account, the following error message is seen mail-listener.log:

ERROR com.appiancorp.process.emailpoller.MailActivation - An error occurred while attempting to open the mailbox to poll; no mail will be fetched. 
javax.mail.AuthenticationFailedException: Authentication failed.

The following are both true when configured for SMTP server authentication:

The SMTP username, conf.mailhandler.mail.user, in custom.properties is correct.
The associated password, conf.password.SMTP, in password.properties is correct.

The following are both true when configured for polling an email account:

The email username conf.mailhandler.poller.EmailHandlerBean.userName in custom.properties is correct.
The associated password conf.password.EmailHandlerBean.EMAIL_HANDLER in password.properties is correct.

Cause

Some special characters within password.properties need to be escaped when used in:

The STMP password field, conf.password.SMTP
The email user password field, conf.password.EmailHandlerBean.EMAIL_HANDLER

It is known the character , needs to be escaped.

Action

If it is determined a special character needs to be escaped, add the characters \\ in front of the special character.

E.g. conf.password.SMTP=password\\,withcomma

If it is unsure a special character needs to be escaped:

Change the password to remove the special character in question.
If authentication is successful without the special character, re-add the special character and escape it with \\.

Affected Versions

This article applies to all Appian versions 17.2 and later.

Last Reviewed: November 2018

Tags: email, authentication, infrastructure

DRAFT KB-XXXX Errors due to special characters in password.properties

Zach Puderbach — Thu, 15 Nov 2018 11:55:05 GMT

Revision 13 posted to Appian Knowledge Base by Zach Puderbach on 11/15/2018 11:55:05 AM

Symptoms

An SMTP server is set up to be used with Appian. Appian is configured for either:

SMTP server authentication, with conf.mailhandler.mail.smtp.auth=true in custom.properties.
Polling an email account.

When configured for SMTP server authentication, the following error message is seen in the application server log:

ERROR com.appiancorp.process.runtime.activities.SendEmailActivity - javax.mail.AuthenticationFailedException: 535 5.7.8 Error: authentication failed: authentication failure

When configured for polling an email account, the following error message is seen mail-listener.log:

ERROR com.appiancorp.process.emailpoller.MailActivation - An error occurred while attempting to open the mailbox to poll; no mail will be fetched. 
javax.mail.AuthenticationFailedException: Authentication failed.

The following are both true when configured for SMTP server authentication:

The SMTP username, conf.mailhandler.mail.user, in custom.properties is correct.
The associated password, conf.password.SMTP, in password.properties is correct.

The following are both true when configured for polling an email account:

The email username conf.mailhandler.poller.EmailHandlerBean.userName in custom.properties is correct.
The associated password conf.password.EmailHandlerBean.EMAIL_HANDLER in password.properties is correct.

Cause

Some special characters within password.properties need to be escaped when used in:

The STMP password field, conf.password.SMTP
The email user password field, conf.password.EmailHandlerBean.EMAIL_HANDLER

It is known the character , needs to be escaped.

Action

If it is determined a special character needs to be escaped, add the characters \\ in front of the special character.

E.g. conf.password.SMTP=password\\,withcomma

If it is unsure a special character needs to be escaped:

Change the password to remove the special character in question.
If authentication is successful without the special character, re-add the special character and escape it with \\.

Affected Versions

This article applies to all Appian versions 17.2 and later.

Last Reviewed: November 2018

Tags: email, authentication, infrastructure

DRAFT KB-XXXX Errors due to special characters in password.properties

Zach Puderbach — Thu, 08 Nov 2018 12:42:20 GMT

Revision 12 posted to Appian Knowledge Base by Zach Puderbach on 11/8/2018 12:42:20 PM

Symptoms

An SMTP server is set up to be used with Appian. Appian is configured for either:

SMTP server authentication, with conf.mailhandler.mail.smtp.auth=true in custom.properties.
Polling an email account.

When configured for SMTP server authentication, the following error message is seen in the application server log:

ERROR com.appiancorp.process.runtime.activities.SendEmailActivity - javax.mail.AuthenticationFailedException: 535 5.7.8 Error: authentication failed: authentication failure

When configured for polling an email account, the following error message is seen mail-listener.log:

ERROR com.appiancorp.process.emailpoller.MailActivation - An error occurred while attempting to open the mailbox to poll; no mail will be fetched. 
javax.mail.AuthenticationFailedException: Authentication failed.

The following are both true when configured for SMTP server authentication:

The SMTP username, conf.mailhandler.mail.user, in custom.properties is correct.
The associated password, conf.password.SMTP, in password.properties is correct.

The following are both true when configured for polling an email account:

The email username conf.mailhandler.poller.EmailHandlerBean.userName in custom.properties is correct.
The associated password conf.password.EmailHandlerBean.EMAIL_HANDLER in password.properties is correct.

Cause

Some special characters within password.properties need to be escaped when used in:

The STMP password field, conf.password.SMTP
The email user password field, conf.password.EmailHandlerBean.EMAIL_HANDLER

It is known the character , needs to be escaped.

Action

If it is determined a special character needs to be escaped, add the characters \\ in front of the special character.

EX. conf.password.SMTP=password\\,withcomma

If it is unsure a special character needs to be escaped:

Change the password to remove the special character in question.
If authentication is successful without the special character, re-add the special character and escape it with \\.

Affected Versions

This article applies to all Appian versions 17.2 and newer.

Last Reviewed: November 2018

Tags: email, authentication, infrastructure

DRAFT KB-XXXX Errors due to special characters in password.properties

Zach Puderbach — Thu, 08 Nov 2018 12:41:34 GMT

Revision 11 posted to Appian Knowledge Base by Zach Puderbach on 11/8/2018 12:41:34 PM

Symptoms

An SMTP server is set up to be used with Appian. Appian is configured for either:

SMTP server authentication, with conf.mailhandler.mail.smtp.auth=true in custom.properties.
Polling an email account.

When configured for SMTP server authentication, the following error message is seen in the application server log:

ERROR com.appiancorp.process.runtime.activities.SendEmailActivity - javax.mail.AuthenticationFailedException: 535 5.7.8 Error: authentication failed: authentication failure

When configured for polling an email account, the following error message is seen mail-listener.log:

ERROR com.appiancorp.process.emailpoller.MailActivation - An error occurred while attempting to open the mailbox to poll; no mail will be fetched. 
javax.mail.AuthenticationFailedException: Authentication failed.

The following are both true when configured for SMTP server authentication:

The SMTP username, conf.mailhandler.mail.user, in custom.properties is correct.
The associated password, conf.password.SMTP, in password.properties is correct.

The following are both true when configured for polling an email account:

The email username conf.mailhandler.poller.EmailHandlerBean.userName in custom.properties is correct.
The associated password conf.password.EmailHandlerBean.EMAIL_HANDLER in password.properties is correct.

Cause

Some special characters within password.properties need to be escaped when used in:

The STMP password field, conf.password.SMTP
The email user password field, conf.password.EmailHandlerBean.EMAIL_HANDLER

Appian is aware that the character , needs to be escaped in the conf.password.SMTP field.

Action

If it is determined a special character needs to be escaped, add the characters \\ in front of the special character.

EX. conf.password.SMTP=password\\,withcomma

If it is unsure a special character needs to be escaped:

Change the password to remove the special character in question.
If authentication is successful without the special character, re-add the special character and escape it with \\.

Affected Versions

This article applies to all Appian versions 17.2 and newer.

Last Reviewed: November 2018

Tags: email, authentication, infrastructure

DRAFT KB-XXXX Errors due to special characters in password.properties

Zach Puderbach — Thu, 08 Nov 2018 12:41:20 GMT

Revision 10 posted to Appian Knowledge Base by Zach Puderbach on 11/8/2018 12:41:20 PM

Symptoms

An SMTP server is set up to be used with Appian. Appian is configured for either:

SMTP server authentication, with conf.mailhandler.mail.smtp.auth=true in custom.properties.
Polling an email account.

When configured for SMTP server authentication, the following error message is seen in the application server log:

ERROR com.appiancorp.process.runtime.activities.SendEmailActivity - javax.mail.AuthenticationFailedException: 535 5.7.8 Error: authentication failed: authentication failure

When configured for polling an email account, the following error message is seen mail-listener.log:

ERROR com.appiancorp.process.emailpoller.MailActivation - An error occurred while attempting to open the mailbox to poll; no mail will be fetched. 
javax.mail.AuthenticationFailedException: Authentication failed.

The following are both true when configured for SMTP server authentication:

The SMTP username conf.mailhandler.mail.user, in custom.properties is correct.
The associated password conf.password.SMTP, in password.properties is correct.

The following are both true when configured for polling an email account:

The email username conf.mailhandler.poller.EmailHandlerBean.userName in custom.properties is correct.
The associated password conf.password.EmailHandlerBean.EMAIL_HANDLER in password.properties is correct.

Cause

Some special characters within password.properties need to be escaped when used in:

The STMP password field, conf.password.SMTP
The email user password field, conf.password.EmailHandlerBean.EMAIL_HANDLER

Appian is aware that the character , needs to be escaped in the conf.password.SMTP field.

Action

If it is determined a special character needs to be escaped, add the characters \\ in front of the special character.

EX. conf.password.SMTP=password\\,withcomma

If it is unsure a special character needs to be escaped:

Change the password to remove the special character in question.
If authentication is successful without the special character, re-add the special character and escape it with \\.

Affected Versions

This article applies to all Appian versions 17.2 and newer.

Last Reviewed: November 2018

Tags: email, authentication, infrastructure

DRAFT KB-XXXX Errors due to special characters in password.properties

Zach Puderbach — Thu, 08 Nov 2018 12:40:34 GMT

Revision 9 posted to Appian Knowledge Base by Zach Puderbach on 11/8/2018 12:40:34 PM

Symptoms

An SMTP server is set up to be used with Appian. Appian is configured for either:

SMTP server authentication, with conf.mailhandler.mail.smtp.auth=true in custom.properties.
Polling an email account.

When configured for SMTP server authentication, the following error message is seen in the application server log:

ERROR com.appiancorp.process.runtime.activities.SendEmailActivity - javax.mail.AuthenticationFailedException: 535 5.7.8 Error: authentication failed: authentication failure

When configured for polling an email account, the following error message is seen mail-listener.log:

ERROR com.appiancorp.process.emailpoller.MailActivation - An error occurred while attempting to open the mailbox to poll; no mail will be fetched. 
javax.mail.AuthenticationFailedException: Authentication failed.

The following are both true when configured for SMTP server authentication:

The SMTP username conf.mailhandler.mail.user in custom.properties is correct.
The associated password conf.password.SMTP in password.properties is correct.

The following are both true when configured for polling an email account:

The email username conf.mailhandler.poller.EmailHandlerBean.userName in custom.properties is correct.
The associated password conf.password.EmailHandlerBean.EMAIL_HANDLER in password.properties is correct.

Cause

Some special characters within password.properties need to be escaped when used in:

The STMP password field, conf.password.SMTP
The email user password field, conf.password.EmailHandlerBean.EMAIL_HANDLER

Appian is aware that the character , needs to be escaped in the conf.password.SMTP field.

Action

If it is determined a special character needs to be escaped, add the characters \\ in front of the special character.

EX. conf.password.SMTP=password\\,withcomma

If it is unsure a special character needs to be escaped:

Change the password to remove the special character in question.
If authentication is successful without the special character, re-add the special character and escape it with \\.

Affected Versions

This article applies to all Appian versions 17.2 and newer.

Last Reviewed: November 2018

Tags: email, authentication, infrastructure

DRAFT KB-XXXX Errors due to special characters in password.properties

Zach Puderbach — Thu, 08 Nov 2018 12:40:25 GMT

Revision 8 posted to Appian Knowledge Base by Zach Puderbach on 11/8/2018 12:40:25 PM

Symptoms

An SMTP server is set up to be used with Appian. Appian is configured for either:

SMTP server authentication, with conf.mailhandler.mail.smtp.auth=true in custom.properties.
Polling an email account.

When configured for SMTP server authentication, the following error message is seen in the application server log:

ERROR com.appiancorp.process.runtime.activities.SendEmailActivity - javax.mail.AuthenticationFailedException: 535 5.7.8 Error: authentication failed: authentication failure

When configured for polling an email account, the following error message is seen mail-listener.log:

ERROR com.appiancorp.process.emailpoller.MailActivation - An error occurred while attempting to open the mailbox to poll; no mail will be fetched. 
javax.mail.AuthenticationFailedException: Authentication failed.

The following are both true when configured for SMTP server authentication:

The SMTP username conf.mailhandler.mail.user in custom.properties is correct.
The associated password conf.password.SMTP in password.properties is correct.

The following are both true when configured for polling an email account:

The email username conf.mailhandler.poller.EmailHandlerBean.userName in custom.properties is correct.
The associated password conf.password.EmailHandlerBean.EMAIL_HANDLER in password.properties is correct.

Cause

Some special characters within password.properties need to be escaped when used in:

The STMP password field, conf.password.SMTP
The email user password field, conf.password.EmailHandlerBean.EMAIL_HANDLER

Appian is aware that the character , needs to be escaped in the conf.password.SMTP field.

Action

If it is determined a special character needs to be escaped, add the characters \\ in front of the special character.

EX. conf.password.SMTP=password\\,withcomma

If it is unsure a special character needs to be escaped:

Change the password to remove the special character in question.
If authentication is successful without the special character, re-add the special character and escape it with \\.

Affected Versions

This article applies to all Appian versions 17.2 and newer.

Last Reviewed: November 2018

Tags: email, authentication, infrastructure

DRAFT KB-XXXX Errors due to special characters in password.properties

Zach Puderbach — Thu, 08 Nov 2018 12:38:36 GMT

Revision 7 posted to Appian Knowledge Base by Zach Puderbach on 11/8/2018 12:38:36 PM

Symptoms

An SMTP server is set up to be used with Appian. Appian is configured for either:

SMTP server authentication, with conf.mailhandler.mail.smtp.auth=true in custom.properties.
Polling an email account.

When configured for SMTP server authentication, the following error message is seen in the application server log:

ERROR com.appiancorp.process.runtime.activities.SendEmailActivity - javax.mail.AuthenticationFailedException: 535 5.7.8 Error: authentication failed: authentication failure

When configured for polling an email account, the following error message is seen mail-listener.log:

ERROR com.appiancorp.process.emailpoller.MailActivation - An error occurred while attempting to open the mailbox to poll; no mail will be fetched. javax.mail.AuthenticationFailedException: Authentication failed.

The following are both true when configured for SMTP server authentication:

The SMTP username conf.mailhandler.mail.user in custom.properties is correct.
The associated password conf.password.SMTP in password.properties is correct.

The following are both true when configured for polling an email account:

The email username conf.mailhandler.poller.EmailHandlerBean.userName in custom.properties is correct.
The associated password conf.password.EmailHandlerBean.EMAIL_HANDLER in password.properties is correct.

Cause

Some special characters within password.properties need to be escaped when used in:

The STMP password field, conf.password.SMTP
The email user password field, conf.password.EmailHandlerBean.EMAIL_HANDLER

Appian is aware that the character , needs to be escaped in the conf.password.SMTP field.

Action

If it is determined a special character needs to be escaped, add the characters \\ in front of the special character.

EX. conf.password.SMTP=password\\,withcomma

If it is unsure a special character needs to be escaped:

Change the password to remove the special character in question.
If authentication is successful without the special character, re-add the special character and escape it with \\.

Affected Versions

This article applies to all Appian versions 17.2 and newer.

Last Reviewed: November 2018

Tags: email, authentication, infrastructure

DRAFT KB-XXXX Errors due to special characters in password.properties

Zach Puderbach — Thu, 08 Nov 2018 12:04:17 GMT

Revision 6 posted to Appian Knowledge Base by Zach Puderbach on 11/8/2018 12:04:17 PM

Symptoms

An SMTP server is set up to be used with Appian. Appian is configured for either:

SMTP server authentication, with conf.mailhandler.mail.smtp.auth=true in custom.properties.
Polling an email account.

When configured for SMTP server authentication, the following error message is seen in the application server log:

ERROR com.appiancorp.process.runtime.activities.SendEmailActivity - javax.mail.AuthenticationFailedException: 535 5.7.8 Error: authentication failed: authentication failure

When configured for polling an email account, the following error message is seen mail-listener.log:

ERROR com.appiancorp.process.emailpoller.MailActivation - An error occurred while attempting to open the mailbox to poll; no mail will be fetched. 
javax.mail.AuthenticationFailedException: Authentication failed.

The following are both true when configured for SMTP server authentication:

The SMTP username conf.mailhandler.mail.user in custom.properties is correct.
The associated password conf.password.SMTP in password.properties is correct.

The following are both true when configured for polling an email account:

The email username conf.mailhandler.poller.EmailHandlerBean.userName in custom.properties is correct.
The associated password conf.password.EmailHandlerBean.EMAIL_HANDLER in password.properties is correct.

Cause

Some special characters within password.properties need to be escaped when used in:

The STMP password field, conf.password.SMTP
The email user password field, conf.password.EmailHandlerBean.EMAIL_HANDLER

Appian is aware that the character , needs to be escaped in the conf.password.SMTP field.

Action

If it is determined a special character needs to be escaped, add the characters \\ in front of the special character.

EX. conf.password.SMTP=password\\,withcomma

If it is unsure a special character needs to be escaped:

Change the password to remove the special character in question.
If authentication is successful without the special character, re-add the special character and escape it with \\.

Affected Versions

This article applies to all Appian versions 17.2 and newer.

Last Reviewed: November 2018

Tags: email, authentication, infrastructure

DRAFT KB-XXXX Errors with special characters in password.properties

Zach Puderbach — Thu, 08 Nov 2018 12:03:41 GMT

Revision 5 posted to Appian Knowledge Base by Zach Puderbach on 11/8/2018 12:03:41 PM

Symptoms

An SMTP server is set up to be used with Appian. Appian is configured for either:

SMTP server authentication, with conf.mailhandler.mail.smtp.auth=true in custom.properties.
Polling an email account.

When configured for SMTP server authentication, the following error message is seen in the application server log:

ERROR com.appiancorp.process.runtime.activities.SendEmailActivity - javax.mail.AuthenticationFailedException: 535 5.7.8 Error: authentication failed: authentication failure

When configured for polling an email account, the following error message is seen mail-listener.log:

ERROR com.appiancorp.process.emailpoller.MailActivation - An error occurred while attempting to open the mailbox to poll; no mail will be fetched. 
javax.mail.AuthenticationFailedException: Authentication failed.

The following are both true when configured for SMTP server authentication:

The SMTP username conf.mailhandler.mail.user in custom.properties is correct.
The associated password conf.password.SMTP in password.properties is correct.

The following are both true when configured for polling an email account:

The email username conf.mailhandler.poller.EmailHandlerBean.userName in custom.properties is correct.
The associated password conf.password.EmailHandlerBean.EMAIL_HANDLER in password.properties is correct.

Cause

Some special characters within password.properties need to be escaped when used in:

The STMP password field, conf.password.SMTP
The email user password field, conf.password.EmailHandlerBean.EMAIL_HANDLER

Appian is aware that the character , needs to be escaped in the conf.password.SMTP field.

Action

If it is determined a special character needs to be escaped, add the characters \\ in front of the special character.

EX. conf.password.SMTP=password\\,withcomma

If it is unsure a special character needs to be escaped:

Change the password to remove the special character in question.
If authentication is successful without the special character, re-add the special character and escape it with \\.

Affected Versions

This article applies to all Appian versions 17.2 and newer.

Last Reviewed: November 2018

Tags: email, authentication, infrastructure

DRAFT KB-XXXX Errors with special characters in password.properties

Zach Puderbach — Thu, 08 Nov 2018 11:53:44 GMT

Revision 4 posted to Appian Knowledge Base by Zach Puderbach on 11/8/2018 11:53:44 AM

Symptoms

An SMTP server is set up to be used with Appian. Appian is configured for either:

SMTP server authentication, with conf.mailhandler.mail.smtp.auth=true in custom.properties.
Polling an email account.

When configured for SMTP server authentication, the following error message is seen in the application server log:

ERROR com.appiancorp.process.runtime.activities.SendEmailActivity - javax.mail.AuthenticationFailedException: 535 5.7.8 Error: authentication failed: authentication failure

When configured for polling an email account, the following error message is seen mail-listener.log:

ERROR com.appiancorp.process.emailpoller.MailActivation - An error occurred while attempting to open the mailbox to poll; no mail will be fetched. 
javax.mail.AuthenticationFailedException: Authentication failed.

The following are both true when configured for SMTP server authentication:

The SMTP username conf.mailhandler.mail.user in custom.properties is correct.
The associated password conf.password.SMTP in password.properties is correct.

The following are both true when configured for polling an email account:

The email username conf.mailhandler.poller.EmailHandlerBean.userName in custom.properties is correct.
The associated password conf.password.EmailHandlerBean.EMAIL_HANDLER in password.properties is correct.

Cause

Some special characters within password.properties need to be escaped when used in:

The STMP password field, conf.password.SMTP
The email user password field, conf.password.EmailHandlerBean.EMAIL_HANDLER

Appian is aware that the character , needs to be escaped.

Action

If it is determined a special character needs to be escaped, add the characters \\ in front of the special character.

EX. conf.password.SMTP=password\\,withcomma

If it is unsure a special character needs to be escaped:

Change the password to remove the special character in question.
If authentication is successful without the special character, re-add the special character and escape it with \\.

Affected Versions

This article applies to all Appian versions 17.2 and newer.

Last Reviewed: November 2018

Tags: email, authentication, infrastructure

DRAFT KB-XXXX Errors with special characters in password.properties

Zach Puderbach — Thu, 08 Nov 2018 11:46:31 GMT

Revision 3 posted to Appian Knowledge Base by Zach Puderbach on 11/8/2018 11:46:31 AM

Symptoms

An SMTP server is set up to be used with Appian. Appian is configured for either:

SMTP server authentication, with conf.mailhandler.mail.smtp.auth=true in custom.properties.
Polling an email account.

When trying to authentication,the following error message is seen in mail-listener.log:

The following are both true when configured for SMTP server authentication:

The SMTP username conf.mailhandler.mail.user in custom.properties is correct.
The associated password conf.password.SMTP in password.properties is correct.

The following are both true when configured for polling an email account:

The email username conf.mailhandler.poller.EmailHandlerBean.userName in custom.properties is correct.
The associated password conf.password.EmailHandlerBean.EMAIL_HANDLER in password.properties is correct.

Cause

Some special characters within password.properties need to be escaped when used in:

The STMP password field, conf.password.SMTP
The email user password field, conf.password.EmailHandlerBean.EMAIL_HANDLER

Appian is aware that the character , needs to be escaped.

Action

If it is determined a special character needs to be escaped, add the characters \\ in front of the special character.

EX. conf.password.SMTP=password\\,withcomma

If it is unsure a special character needs to be escaped:

Change the password to remove the special character in question.
If authentication is successful without the special character, re-add the special character and escape it with \\.

Affected Versions

This article applies to all Appian versions 17.2 and newer.

Last Reviewed: November 2018

Tags: email, authentication, infrastructure

DRAFT KB-XXXX Errors with special characters in password.properties

Zach Puderbach — Thu, 08 Nov 2018 11:11:30 GMT

Revision 2 posted to Appian Knowledge Base by Zach Puderbach on 11/8/2018 11:11:30 AM

Symptoms

An SMTP server is set up to be used with Appian. Appian is configured for either:

SMTP server authentication, with conf.mailhandler.mail.smtp.auth=true in custom.properties
Polling an email account

When trying to authentication,the following error message is seen in mail-listener.log:

The following are both true when configured for SMTP server authentication:

The SMTP username conf.mailhandler.mail.user in custom.properties is correct
The associated password conf.password.SMTP in password.properties is correct

The following are both true when configured for polling an email account:

The email username conf.mailhandler.poller.EmailHandlerBean.userName in custom.properties is correct
The associated password conf.password.EmailHandlerBean.EMAIL_HANDLER in password.properties is correct

Cause

Special characters within Appian need to be escaped when used in the STMP password field in password.properties

Appian is aware that the character ',' needs to be escaped

Action

If it is determined a special character needs to be escaped, add the characters \\ in front of the special character

EX. conf.password.SMTP=password,withcomma

If it is unsure a special character needs to be escaped

1) Try to escape the character with \\

2) Try to use a password without special characters

If there are multiple special characters do this

Affected Versions

This article applies to all Appian versions 17.3 and newer.

Last Reviewed: November 2018

Tags: email, authentication, infrastructure

DRAFT KB-XXXX Errors with special characters in password.properties

Zach Puderbach — Tue, 06 Nov 2018 22:32:11 GMT

Revision 1 posted to Appian Knowledge Base by Zach Puderbach on 11/6/2018 10:32:11 PM

Symptoms

There is an authentication error even after you have confirmed the password is correct

Cause

Appian special characters within Appian need to be escaped when used in the STMP password field in password.properties

Appian is aware that the character ',' needs to be escaped

Action

1) Try to escape the character with \\

2) Try to use a password without special characters

If there are multiple special characters do this

Affected Versions

This article applies to all Appian versions 17.3 and newer.

Last Reviewed: November 2018

Tags: email, authentication, infrastructure