MailNews:LDAP Address Books: Difference between revisions

From MozillaWiki
Jump to navigation Jump to search
(→‎LDAP Logging: Update version numbers)
(Move the LDAP alpha schema onto a separate page, so this page can be more generic.)
Line 26: Line 26:
* [ftp://ftp.mozilla.org/pub/mozilla.org/thunderbird/nightly/latest-mozilla1.8/ Thunderbird]
* [ftp://ftp.mozilla.org/pub/mozilla.org/thunderbird/nightly/latest-mozilla1.8/ Thunderbird]


== LDAP Address Book Schema - Alpha Version ==
== LDAP Address Book Schema ==


This is the current alpha version of the Mozilla LDAP Address Book Schema. It will work with Thunderbird 1.5 and SeaMonkey 1.0 (both including alpha/beta versions).
The address book code specifies default settings for communicating with LDAP servers.


To use it copy the text below into a file and point you LDAP server at it. With this specification you won't need to change any of the LDAP default attributes.
The default settings are specified in a [[MailNews:Mozilla LDAP Address Book Schema|defined schema]], currently in an alpha version. Setting up a LDAP server with this schema, and setting up the address book (Thunderbird or SeaMonkey) to talk to that LDAP server will enable all fields to work correctly.


If you find any problems with this schema, they should be filed here on the [[MailNews_Talk:LDAP Address Books]] discussion page, bugs with Thunderbird or SeaMonkey should be filed in [https://bugzilla.mozilla.org/ bugzilla].
TODO: Detail how to override the default schema for LDAP address books.
 
Any Updates to the schema will be documented in the header.
 
----
<pre>
# Mozilla: @VERSION@
#
# mozillaAbPersonAlpha
#
# Created initial version --[[User:Standard8|Standard8]] 12:21, 5 Dec 2005 (PST)
#
# This file contains LDAPv3 schema for use with the Mozilla Address Book
# and is intended to ...
 
# Depends upon
#  Definition of an X.500 Attribute Type and an Object Class to Hold
#  Uniform Resource Identifiers (URIs) [RFC2079], and A Summary of
#  the X.500(96) User Schema for use with LDAPv3 [RFC2256] (core.schema)
#
#  The COSINE and Internet X.500 Schema [RFC1274] (cosine.schema)
#
#  The InetOrgPerson Schema [RFC2798] (inetorgperson.schema)
 
# 1.3.6.1.4.1.13769.4.x - Mozilla AB 'Other' tab
 
attributetype ( 1.3.6.1.4.1.13769.4.1 NAME 'mozillaCustom1'
        EQUALITY caseIgnoreMatch
        SUBSTR caseIgnoreSubstringsMatch
        SYNTAX 1.3.6.1.4.1.1466.115.121.1.15{128} SINGLE-VALUE )
attributetype ( 1.3.6.1.4.1.13769.4.2 NAME 'mozillaCustom2'
        EQUALITY caseIgnoreMatch
        SUBSTR caseIgnoreSubstringsMatch
        SYNTAX 1.3.6.1.4.1.1466.115.121.1.15{128} SINGLE-VALUE )
 
attributetype ( 1.3.6.1.4.1.13769.4.3 NAME 'mozillaCustom3'
        EQUALITY caseIgnoreMatch
        SUBSTR caseIgnoreSubstringsMatch
        SYNTAX 1.3.6.1.4.1.1466.115.121.1.15{128} SINGLE-VALUE )
attributetype ( 1.3.6.1.4.1.13769.4.4 NAME 'mozillaCustom4'
        EQUALITY caseIgnoreMatch
        SUBSTR caseIgnoreSubstringsMatch
        SYNTAX 1.3.6.1.4.1.1466.115.121.1.15{128} SINGLE-VALUE )
# 1.3.6.1.4.1.13769.3.x - Mozilla AB 'Address' tab
 
attributetype ( 1.3.6.1.4.1.13769.3.1 NAME 'mozillaHomeStreet'
        EQUALITY caseIgnoreMatch
        SUBSTR caseIgnoreSubstringsMatch
        SYNTAX 1.3.6.1.4.1.1466.115.121.1.15{128} SINGLE-VALUE )
 
attributetype ( 1.3.6.1.4.1.13769.3.2 NAME 'mozillaHomeStreet2'
        EQUALITY caseIgnoreMatch
        SUBSTR caseIgnoreSubstringsMatch
        SYNTAX 1.3.6.1.4.1.1466.115.121.1.15{128} SINGLE-VALUE )
 
attributetype ( 1.3.6.1.4.1.13769.3.3 NAME 'mozillaHomeLocalityName'
        SUP name SINGLE-VALUE )
 
attributetype ( 1.3.6.1.4.1.13769.3.4 NAME 'mozillaHomeState'
        SUP name SINGLE-VALUE )
 
attributetype ( 1.3.6.1.4.1.13769.3.5 NAME 'mozillaHomePostalCode'
        EQUALITY caseIgnoreMatch
        SUBSTR caseIgnoreSubstringsMatch
        SYNTAX 1.3.6.1.4.1.1466.115.121.1.15{40} SINGLE-VALUE )
 
attributetype ( 1.3.6.1.4.1.13769.3.6 NAME 'mozillaHomeCountryName'
        SUP name SINGLE-VALUE )
 
attributetype ( 1.3.6.1.4.1.13769.3.7 NAME 'mozillaHomeUrl'
        EQUALITY caseIgnoreMatch
        SYNTAX 1.3.6.1.4.1.1466.115.121.1.15{128} SINGLE-VALUE )
 
attributetype ( 1.3.6.1.4.1.13769.3.8 NAME 'mozillaWorkStreet2'
        EQUALITY caseIgnoreMatch
        SUBSTR caseIgnoreSubstringsMatch
        SYNTAX 1.3.6.1.4.1.1466.115.121.1.15{128} SINGLE-VALUE )
 
attributetype ( 1.3.6.1.4.1.13769.3.9 NAME 'mozillaWorkUrl'
        EQUALITY caseIgnoreMatch
        SYNTAX 1.3.6.1.4.1.1466.115.121.1.15{128} SINGLE-VALUE )
# 1.3.6.1.4.1.13769.2.x - Mozilla AB 'Contact' tab
 
attributetype ( 1.3.6.1.4.1.13769.2.1
        NAME ( 'mozillaNickname' 'xmozillanickname' )
        SUP name )
 
attributetype ( 1.3.6.1.4.1.13769.2.2
        NAME ( 'mozillaSecondEmail' 'xmozillasecondemail' )
        EQUALITY caseIgnoreIA5Match
        SUBSTR caseIgnoreIA5SubstringsMatch
        SYNTAX 1.3.6.1.4.1.1466.115.121.1.26{256} SINGLE-VALUE )
 
attributetype ( 1.3.6.1.4.1.13769.2.3
        NAME ( 'mozillaUseHtmlMail' 'xmozillausehtmlmail' )
        SYNTAX 1.3.6.1.4.1.1466.115.121.1.7 SINGLE-VALUE )
 
# AOL Instant Messenger (AIM) Identity
attributetype ( 1.3.6.1.4.1.13769.2.4
        NAME ( 'nsAIMid' 'nscpaimscreenname' )
        EQUALITY telephoneNumberMatch
        SUBSTR telephoneNumberSubstringsMatch
        SYNTAX 1.3.6.1.4.1.1466.115.121.1.50 )
 
# 1.3.6.1.4.1.13769.9 - Mozilla AB objectclasses
# The mozillaAddressBookEntry object class is used to define entries
# representing Cards in the Mozilla Address Book.  The commonName attribute
# is used for naming entries of this object class, but may not be unique.
#            department $
 
objectclass ( 1.3.6.1.4.1.13769.9.1 NAME 'mozillaAbPersonAlpha'
        SUP top AUXILIARY
        MUST ( cn )
        MAY( c $
              description $
              displayName $
              fax $
              givenName $
              homePhone $
              l $
              mail $
              mobile $
              mozillaCustom1 $
              mozillaCustom2 $
              mozillaCustom3 $
              mozillaCustom4 $
              mozillaHomeCountryName $
              mozillaHomeLocalityName $
              mozillaHomePostalCode $
              mozillaHomeState $
              mozillaHomeStreet $
              mozillaHomeStreet2 $
              mozillaHomeUrl $
              mozillaNickname $
              mozillaSecondEmail $
              mozillaUseHtmlMail $
              mozillaWorkStreet2 $
              mozillaWorkUrl $
              nsAIMid $
              o $
              ou $
              pager $
              postalCode $
              postOfficeBox $
              sn $
              st $
              street $
              telephoneNumber $
              title ) )
</pre>
----

Revision as of 21:42, 8 March 2007

Resources
MailNews Homepage
Address Book Homepage
Roadmap
Help Wanted
LDAP Address Books
Code Structure
Bug Locations
Related Standards

LDAP Logging

We have now enabled LDAP Logging on Release builds on the trunk and the 1.8.1 branch (aka SeaMonkey 1.1.x/Thunderbird 2.0a and 2.0b)

The LDAP logging can be used to view the messages that the Address Book is sending and receiving to/from your LDAP server. We hope that this will aid debugging problems on an LDAP link.

To enable logging set the environment variable "NSPR_LOG_MODULES" to ldap:5 (see links below for how to do this) and start up Address Book, then attempt an LDAP search or autocomplete and the connection/message process will be logged to the console.

For ease of logging, you may wish to also set the NSPR_LOG_FILE to a file location so that you don't need to capture the file output. See the links below on how to set this up.

See these links for more detail:

Trunk nightlies are available from:

Branch nightlies are available from:

LDAP Address Book Schema

The address book code specifies default settings for communicating with LDAP servers.

The default settings are specified in a defined schema, currently in an alpha version. Setting up a LDAP server with this schema, and setting up the address book (Thunderbird or SeaMonkey) to talk to that LDAP server will enable all fields to work correctly.

TODO: Detail how to override the default schema for LDAP address books.

Retrieved from "https://wiki.allizom.org/index.php?title=MailNews:LDAP_Address_Books&oldid=51238"