service
SMTP Service — SMTP Server Service<service class="xms.transport.smtp.SMTPService" name="name" … > child tags </service>
Table 74. Attributes for service tag (for xms.transport.smtp.SMTPService)
| Name | Description | Type | Default Value | Required |
|---|---|---|---|---|
| TLSMode | TLS Mode | TLSMode One of the following values: starttls,smtps | starttls | no |
| address | The local addresses to listen for connections. | InetSocketAddress A hostname:port pair or hostname. Port is 0 if unspecified | localhost | no |
| allowInsecureAuth | Allow authentication without TLS encryption | boolean true or false | false | no |
| authenticator | An authenticator to authenticate SMTP sessions | Authenticator Name of a Authenticator as defined in XMSAuthenticationService | none | no |
| backLog | The backlog for incoming socket connections | int positive integer | 50 | no |
| banner | An alternate SMTP banner | String any character combination | none | no |
| heloRequired | The HELO command is required | boolean true or false | false | no |
| hostMap | A String Map that maps local IPs to hostnames | StringMap Name of a StringMap as defined in StringMapService | none | no |
| hostname | The default hostname of this machine | String any character combination | none | no |
| keyStore | A keystore to use for TLS encryption | KeyStore Name of a KeyStore as defined in KeyStoreService | none | no |
| maxReceived | The maximum number of Received headers allowed in a message before considering the message a loop | int any integer | 20 | no |
| port | The local port to listen for connections. | int any integer | 25 | no |
| requireAuth | Require authentication | boolean true or false | false | no |
| requireTLS | Require TLS Encryption | boolean true or false | false | no |
| socketTimeout | The socket timeout in ms | long any integer | 300000 | no |
| target | The name of the service to direct incoming messages to. | MessageSink Name of a Service that implements MessageSink | none | yes |
This tag depends on the following services (or a service that extends or implements these classes)
<filter class="class" … />
The following classes can be used in the class attribute for this tag:
xms.filter.SimpleConnectionFilter — Simple Connection Filter
xms.filter.connection.LocalBlacklistFilter — Local Blacklist Filter
xms.filter.data.VirtualServerGroupFilter — Virtual Server Group Filter
xms.filter.dkim.DKIMVerificationFilter — DKIM Verification Filter
xms.filter.domainkeys.DomainKeysSignatureFilter — Domain Keys Signature Filter
xms.filter.domainkeys.DomainKeysVerificationFilter — Domain Keys Verification Filter
xms.filter.recipient.LocalDeliveryFilter — Local Delivery Filter
xms.filter.recipient.MultiplexerMapFilter — Multiplexer Map Filter
xms.filter.recipient.RecipientDomainBlackList — Recipient Domain Black List
xms.filter.recipient.RecipientListFilter — Recipient List Filter
xms.filter.recipient.SimpleRecipientRejectFilter — Simple Recipient Reject Filter
xms.filter.recipient.SimpleRelayFilter — Simple Relay Filter
Example 71. Example configuration for SMTP Service
Required attributes are marked with a bold typeface
<service class="xms.transport.smtp.SMTPService" name="name"
TLSMode="TLSMode"
address="address"
allowInsecureAuth="allowInsecureAuth"
authenticator="authenticator"
backLog="backLog"
banner="banner"
heloRequired="heloRequired"
hostMap="hostMap"
hostname="hostname"
keyStore="keyStore"
maxReceived="maxReceived"
port="port"
requireAuth="requireAuth"
requireTLS="requireTLS"
socketTimeout="socketTimeout"
target="target">
<filter class="class" name="name" … />
</service>