Directory Services 7.2.5

SMTP Account Status Notification Handler

The SMTP Account Status Notification Handler is a notification handler that sends email messages to end users and/or administrators whenever an account status notification is generated.

Parent

The SMTP Account Status Notification Handler object inherits from Account Status Notification Handler.

SMTP Account Status Notification Handler properties

You can use configuration expressions to set property values at startup time. For details, see Property value substitution.

Basic Properties Advanced Properties

email-address-attribute-type
enabled
message-subject
message-template-file
recipient-address
sender-address

java-class
send-email-as-html
send-message-without-end-user-address

Basic properties

Use the --advanced option to access advanced properties.

email-address-attribute-type

Synopsis

Specifies which attribute in the user’s entries may be used to obtain the email address when notifying the end user.

Description

You can specify more than one email address as separate values. In this case, the OpenDJ server sends a notification to all email addresses identified.

Default value

If no email address attribute types are specified, then no attempt is made to send email notification messages to end users. Only those users specified in the set of additional recipient addresses are sent the notification messages.

Allowed values

The name of an attribute type defined in the LDAP schema.

Multi-valued

Yes

Required

No

Admin action required

None

Advanced

No

Read-only

No

enabled

Synopsis

Indicates whether the Account Status Notification Handler is enabled. Only enabled handlers are invoked whenever a related event occurs in the server.

Default value

None

Allowed values

true

false

Multi-valued

No

Required

Yes

Admin action required

None

Advanced

No

Read-only

No

message-subject

Synopsis

Specifies the subject that should be used for email messages generated by this account status notification handler.

Description

The values for this property should begin with the name of an account status notification type followed by a colon and the subject that should be used for the associated notification message. If an email message is generated for an account status notification type for which no subject is defined, then that message is given a generic subject.

Default value

None

Allowed values

A string.

Multi-valued

Yes

Required

Yes

Admin action required

None

Advanced

No

Read-only

No

message-template-file

Synopsis

Specifies the path to the file containing the message template to generate the email notification messages.

Description

The values for this property should begin with the name of an account status notification type followed by a colon and the path to the template file that should be used for that notification type. If an account status notification has a notification type that is not associated with a message template file, then no email message is generated for that notification.

Default value

None

Allowed values

A string.

Multi-valued

Yes

Required

Yes

Admin action required

None

Advanced

No

Read-only

No

recipient-address

Synopsis

Specifies an email address to which notification messages are sent, either instead of or in addition to the end user for whom the notification has been generated.

Description

This may be used to ensure that server administrators also receive a copy of any notification messages that are generated.

Default value

If no additional recipient addresses are specified, then only the end users that are the subjects of the account status notifications receive the notification messages.

Allowed values

A string.

Multi-valued

Yes

Required

No

Admin action required

None

Advanced

No

Read-only

No

sender-address

Synopsis

Specifies the email address from which the message is sent. Note that this does not necessarily have to be a legitimate email address.

Default value

None

Allowed values

A string.

Multi-valued

No

Required

Yes

Admin action required

None

Advanced

No

Read-only

No

Advanced properties

Use the --advanced option to access advanced properties.

java-class

Synopsis

Specifies the fully-qualified name of the Java class that provides the SMTP Account Status Notification Handler implementation.

Default value

org.opends.server.extensions.SMTPAccountStatusNotificationHandler

Allowed values

A Java class that extends or implements:

  • org.opends.server.api.AccountStatusNotificationHandler

Multi-valued

No

Required

Yes

Admin action required

The object must be disabled and re-enabled for changes to take effect.

Advanced

Yes

Read-only

No

send-email-as-html

Synopsis

Indicates whether an email notification message should be sent as HTML.

Description

If this value is true, email notification messages are marked as text/html. Otherwise outgoing email messages are assumed to be plaintext and marked as text/plain.

Default value

false

Allowed values

true

false

Multi-valued

No

Required

No

Admin action required

None

Advanced

Yes

Read-only

No

send-message-without-end-user-address

Synopsis

Indicates whether an email notification message should be generated and sent to the set of notification recipients even if the user entry does not contain any values for any of the email address attributes (that is, in cases when it is not be possible to notify the end user).

Description

This is only applicable if both one or more email address attribute types and one or more additional recipient addresses are specified.

Default value

true

Allowed values

true

false

Multi-valued

No

Required

Yes

Admin action required

None

Advanced

Yes

Read-only

No