An e-mail distribution list is represented by an entry in the directory consisting of attributes drawn from these object classes:
|
|
top - attributes useful for describing the classifications of a directory object. |
|
|
groupOfNames - attributes useful for describing a collection of user objects. |
|
|
rfc822MailGroup - attributes useful for describing an e-mail distribution list. |
|
|
emailGroup - attributes for further describing an e-mail distribution list, especially those needed to support Sendmail distribution lists (aliases (4) format). |
The top and groupOfNames object classes are defined in X.521 (1993). The rfc822MailGroup object class is defined in the default schema of the University of Michigan LDAP implementation. The emailGroup object class is defined by Sun Microsystems, Inc.
A distribution lists entry is extensible and may contain attributes from additional object classes once such object classes have been defined in the directory schema.
emailGroup object classThe emailGroup object class represents SIMS distribution list. All SIMS distribution lists must have this object class. The object class is defined as follows:
( OID - TBD
NAME 'emailGroup'
MUST (
commonname $ objectClass
)
MAY (
authorizedDomain $ authorizedSubmitter $ dataSource $
expandable $ mailDeliveryFile $ mailDeliveryOption $
mailProgramDeliveryInfo $ mailHost $ ownerDeliveryFile $
ownerDeliveryOption $ ownerProgramDeliveryInfo $
requestsToDeliveryFile $ requestsToDeliveryOption $
requestsToProgramDeliveryInfo $ rfc822AuthorizedSubmitter $
rfc822Mailmember $ rfc822Owner $
rfc822UnauthorizedSubmitter $ unauthorizedDomain $
unauthorizedSubmitter
))
TABLE D-7 Required emailGroup Attributes Attribute
Definition
commonname
(cis, 1 - many, {mta, admin}) A distribution list's common name. The distribution list name is generated from the commonname attribute. Please refer to "Creating a Distribution List" on page 355 for details on how the mta generates a fully qualified rfc822 address from the commonname.
objectClass
(cis, 1 - many, {mta, admin}) The object class used in defining a SIMS distribution list.
authorizedDomain
(cis, 1 - many, {mta, admin}) Domain name from which users are authorized to post to the distribution list. Wildcard character is "*" and the value should conform to rfc822 specification. A distribution list entry with an empty authorizedDomain allows senders from all domains to post messages to the list, except if they are called out in the following attributes: unauthorizedSubmitter, unauthorizedDomain, rfc822UnauthorizedSubmitter.
authorizedSubmitter
(dn, 1 - many, {mta, admin}) Distinguished name of the user(s) authorized to submit messages to the distribution list. These users should be defined in the directory server. The mta determines the e-mail address of the authorizedSubmitter by looking up the e-mail address of the dn in the directory.
expandable
(cis, 0 - 1, {mta, admin}) Determines if the distribution list is expandable or not. Takes value of TRUE/FALSE. If set to TRUE, expn <dl name> returns the rfc822 address of the members of this distribution list.
mailDeliveryFile
(ces, 0 - many, {mta, admin}) Fully qualified path of a file name to which incoming messages to this distribution list are appended.
mailDeliveryOption
(cis, 0 - many, {mta, admin}) One or delivery options. While inbound messages can be delivered into multiple message stores (mailbox and native) message access server can read messages only from one of them. The mail store where messages are read from are specified using the mailFolderMap attribute. The supported options are:
mailbox - Does not apply to distribution lists.
shared - deliver mail to a shared mailbox in Sun Message Store. This is used for setting up shared mailbox for a distribution list. Shared mailbox works for members of the distribution list receiving mail on the same mail server. This implies that setting mailDeliveryOption to shared delivers messages only to those members specified in members attribute who receive mail on the same mail server (i.e. have the same mailHost). Members specified in rfc822MailMember (i.e. external members of this distribution list) do not receive mail messages.
native - Does not apply to distribution lists.
autoreply - Does not apply to distribution lists.
program - deliver mail to a Solaris program. Must point to a valid Solaris program and the program has to be on a approved list of programs installed by the system administrator. See "To Make Delivery Programs Available to Users" on page 102.
forward - Does not apply to distribution lists.
file - append mail to a file. For this option to have any effect, mailDeliveryFile would have to point to a valid file over which the user id. under which SIMS is running has write privileges. Please refer to mailDeliveryFile in this section.
c:<custom channel name> - route mail to a user define channel. SIMS software development kit allows users to develop channel programs. These channel programs are used to process the messages delivered to the channel queue by the message transfer agent. Please refer to the SIMS software development kit and the mta documentation for more details on the developing and using custom channel programs. Also note that the key word c followed by a : is required to precede the channel name.
mailProgramDeliveryInfo
(ces, 0 - many, {mta, admin}) Specifies one or more named commands, to use in program delivery. The valid named commands are defined by
imta-program(1m). Please refer to the man pages for details on how to define named commands.mailHost
(cis, 0 -1, {admin, mta}) Hostname of the distribution list's SMTP/MIME mail server. The host name should be fully qualified.
rfc822AuthorizedSubmitter
(cis, 0 - many, {admin, mta}) E-mail addresses of users authorized to post messages to the list. Distribution lists where this attribute is not set permits everybody to post messages to the list, as long as the sender is not called out in rfc822UnauthorizedSubmitter, unauthorizedDomain or unauthorizedSubmitter attributes. Setting this attribute has the effect of disallowing all users from sending messages to this list except those users specified in rfc822AuthorizedSubmitter.
rfc822MailMember
(cis, 0 - many, {mta, admin}) Stores the e-mail addresses (RFC-822 format) defined for the members of this list.
rfc822Owner
(cis, 0 - many, {mta, admin}) E-mail address of the owner(s) of the list. Must conform to RFC-822 format.
rfc822UnauthorizedSubmitter
(cis, 0 - many, {admin, mta}) E-mail addresses of users not permitted to post to the list.
unauthorizedDomain
(cis, 0 - many, {mta, admin}) Domain name for which users are not permitted to post to the list.
unauthorizedSubmitter
(dn, 0 - many, {admin, mta}) Distinguished name of users not permitted to post messages to the list. These users have to be defined in the directory.
rfc822MailGroup Object Class
The rfc822MailGroup object class is described below for reference. This object class is defined by in the default schema of University of Michigan LDAP implementation. The object class is defined as follows:
( OID - TBD
NAME 'rfc822MailGroup'
MUST (
commonname $ objectClass
)
MAY (
associatedDomain $ autoMgt $ description $
destinationIndicator $ errorsTo $ facsimileTelephoneNumber $
internationaliSDNNumber $ joinable $ krbName $ labeledURI $
mail $ member $ memberOfGroup $ moderator $
multiLineDescription $ notice $ owner $
physicalDeliveryOfficeName $ postOfficeBox $ postalAddress $
postalCode $ preferredDeliveryMethod $ registeredAddress $
requestsTo $ rfc822ErrorsTo $ rfc822RequestsTo $ seeAlso $
streetAddress $ suppressNoEmailError $ telephoneNumber $
teletexTerminalIdentifier $ telexNumber $ userPassword $
x121Address $ xacl
)
)
TABLE D-9 Required rfc822MailGroup Attributes Attribute
Definition
commonname
(cis, 1 - many, {mta, admin}) a distribution lists common name. The distribution list name is generated from the commonname attribute. Please refer to "Creating a Distribution List" on page 355 for details on how the mta generates a fully qualified rfc822 address from the commonname.
objectClass
(cis, 1 - many, {mta, admin}) The object class used in defining a SIMS distribution list.
associatedDomain
(cis, 1 - many, {mta, admin}) Domain name associated with the list.
errorsTo
(dn, 0 - many, {mta, admin}) Distinguished name of an entry to which errors are sent.
member
(dn, 0 - many, {mta, admin}) Distinguished names of members of this list. These users have to be defined in the directory for them to receive e- mail messages sent to the list.
moderator
(dn, 0 - many, {mta, admin}) Distinguished name of the moderator of the list. If a distribution list entry has a valid moderator value, all messages submitted to the list are forwarded to the moderator. The moderator then re-submits messages to the list for them to be delivered to the list members.
requestsTo
(dn, 0 - many, {mta, admin}) Distinguished name to which requests to be added to this list, are sent. Request alias generated by the MTA is of the format
<listname>-request@<domain>, where domain is the value of the associatedDomain attribute.rfc822ErrorsTo
(cis, 0 - many, {mta, admin}) E-mail address (RFC 822 format) to which errors are sent.
rfc822RequestsTo
(cis, 0 - many, {mta, admin}) E-mail address (RFC 822 format) to which request to be added to the list are sent. Request alias generated by the MTA is of the format <listname>-request@<domain>, where domain is the value of the associatedDomain attribute.