Home
You are not currently signed in.

RFC1943

  1. RFC 1943
Network Working Group                                        B. Jennings
Request for Comments: 1943                    Sandia National Laboratory
Category: Informational                                         May 1996


             Building an X.500 Directory Service in the US

Status of this Memo

   This memo provides information for the Internet community.  This memo
   does not specify an Internet standard of any kind.  Distribution of
   this memo is unlimited.

Abstract

   This document provides definition and recommends considerations that
   must be undertaken to operate a X.500 Directory Service in the United
   States.  This project is the work performed for the Integrated
   Directory Services Working Group within the Internet Engineering Task
   Force, for establishing an electronic White Pages Directory Service
   within an organization in the US and for connecting it to a wide-area
   Directory infrastructure.

   Establishing a successful White Pages Directory Service within an
   organization requires a collaborative effort between the technical,
   legal and data management components of an organization. It also
   helps if there is a strong commitment from the higher management to
   participate in a wide-area Directory Service.

   The recommendations presented in the document are the result of
   experience from participating in the Internet White Pages project.

Table of Contents

   1.0     Introduction                                            2
   1.1     Purpose of this Document                                2
   1.2     Introduction to Directory Services                      2
   2.0     The X.500 Protocol                                      4
   2.1     Introduction                                            4
   2.2     Directory Model                                         4
   2.3     Information Model                                       5
   2.4     Benefits and Uses for X.500 Directory Service           6
   2.5     Other Applications of X.500                             7
   3.0     Legal Issues                                            8
   3.1     Introduction                                            8
   3.2     Purpose of the Directory                                8
   3.3     User Rights                                             9
   3.4     Data Integrity                                          9



Jennings                     Informational                      [Page 1]
RFC 1943     Building an X.500 Directory Service in the US      May 1996


   3.5     Protection of the Data                                 10
   3.6     Conclusions                                            10
   4.0     Infrastructure                                         11
   4.1     Introduction                                           11
   4.2     A Well Maintained Infrastructure                       11
   4.3     DUA Interfaces for End Users                           12
   5.0     Datamanagement & Pilot Projects                        13
   5.1     Simple Internet White Pages Service                    13
   5.2     InterNIC                                               13
   5.3     ESnet                                                  14
   6.0     Recommendations                                        14
   6.1     General                                                14
   6.2     Getting Started                                        14
   6.3     Who are the Customers                                  14
   6.4     What are the Contents of the Directory                 15
   6.5     What are the Rights of the Individuals                 15
   6.6     Data Integrity                                         16
   6.7     Data Security                                          16
   6.8     Data Administration                                    17
   6.9     Conclusion                                             17
   7.0     References                                             18
   8.0     Glossary                                               19
   9.0     Security Considerations                                22
   10.0    Author's Address                                       22

1.0     Introduction

1.1     Purpose of this Document

   This document provides an introduction for individuals planning to
   build a directory service for an organization in the US. It presents
   an introduction to the technical, legal, and organizational aspects
   of a directory service. It describes various options to organizations
   who want to operate an X.500 Directory service and illustrates these
   with examples of current X.500 service providers.

1.2     Introduction to Directory Services

   An electronic directory server is an electronic process that provides
   a list of information provided via electronic access. This
   information is variable in content, however it should be explicitly
   defined by the directory purpose. Information about people,
   organizations, services, network hardware are just a few examples of
   data content that a directory service can provide. The aim of an
   X.500 Directory service is to make using the directory intuitive and
   as easy to use as calling for directory assistance. The X.500
   Directory service is an international standard ratified by the
   International organization for Standardization (IS) and the ITU-T



Jennings                     Informational                      [Page 2]
RFC 1943     Building an X.500 Directory Service in the US      May 1996


   International Telecommunication Union formerly (CCITT) in 1988 [1].

   The Directory is intended to be global service comprised of
   independently operated and distributed Directory Service Agents
   (DSAs), that provide information in the form of a White Pages Phone
   Directory.

   Electronic mail communication benefits from the existence of a global
   electronic White Pages to allow network users to retrieve addressing
   information in an intuitive fashion. Manual searching for names and
   addresses, specifically electronic addresses, can take a great deal
   of time. A White Pages directory service can enable network users to
   retrieve the addresses of communication partners in a user friendly
   way, using known variables such as common name, surname, and
   organization to facilitate various levels of searches.

   In order to make global communication over computer networks work
   efficiently, a global electronic White Pages service is
   indispensable. Such a directory service could also contain telephone
   and fax numbers, postal addresses as well as platform type to
   facilitate in translation of documents between users on different
   systems. An electronic White Pages may prove to be useful for
   specific local purposes; replacing paper directories or improving
   quality of personnel administration for example. An electronic
   directory is much easier to produce and more timely than paper
   directories which are often out of date as soon as they are printed.

   The Internet White Pages Project provides many companies in the US
   with an opportunity to pilot X.500 in their organizations.
   Operating as a globally distributed directory service, this project
   allows organizations in a wide variety of industry type to make
   themselves known on the Internet and to provide access to their staff
   as desired.

   Some organizations, such as ESnet agreed to manage directory
   information for other organizations. ESnet maintains data at their
   site for all the national laboratories. They provide assistance to
   organizations in defining their directory information tree (DIT)
   structure. They also provide free access to the X.500 Directory via
   Gopher, WWW, DUAs, whois and finger protocols.

   The InterNIC is another directory services provider on the Internet.
   To date [June 1995] they hold X.500 directory data for 52
   organizations and provide free access to this data via various
   protocols: X.500 DUA, E-Mail, whois, Gopher and WWW.

   To find the most current listing of X.500 providers see RFC 1632 -
   Catalog of Available X.500 Implementations [2].



Jennings                     Informational                      [Page 3]
RFC 1943     Building an X.500 Directory Service in the US      May 1996


2.0     The X.500 Protocol

2.1     Introduction

   This chapter provides the basic technical information necessary for
   an organization to begin deploying an X.500 Directory Service. It
   provides a brief introduction to the X.500 protocol and the
   possibilities that X.500 offers.

2.2     The Directory Model

   X.500 Directory Model is a distributed collection of independent
   systems which cooperate to provide a logical data base of information
   to provide a global Directory Service. Directory information about a
   particular organization is maintained locally in a Directory System
   Agent (DSA). This information is structured within specified
   standards. Adherence to these standards makes the distributed model
   possible. It is possible for one organization to keep information
   about other organizations, and it is possible for an organization to
   operate independently from the global model as a stand alone system.
   DSAs that operate within the global model have the ability to
   exchange information with other DSAs by means of the X.500 protocol.

   DSAs that are interconnected form the Directory Information Tree
   (DIT). The DIT is a virtual hierarchical data structure. An X.500
   pilot using QUIPU software introduced the concept of a "root" DSA
   which represents the world; below which "countries" are defined.
   Defined under the countries are "organizations". The organizations
   further define "organizational units" and/ or "people". This DIT
   identifies the DIT for the White Pages X.500 services.

   Each DSA provides information for the global directory. Directories
   are able to locate in the hierarchical structure discussed above,
   which DSA holds a certain portion of the directory. Each directory
   manages information through a defined set of attributes and in a
   structure defined as the Directory Information Base (DIB).

   A DSA is accessed by means of a Directory User Agent (DUA). A DUA
   interacts with the Directory by communicating with one or more DSAs
   as necessary to respond to a specific query. DUAs can be an IP
   protocol such as whois or finger, or a more sophisticated application
   which may provide Graphical User Interface (GUI) access to the DSA.
   Access to a DSA can be accomplished by an individual or automated by
   computer application.







Jennings                     Informational                      [Page 4]
RFC 1943     Building an X.500 Directory Service in the US      May 1996


2.3     The Information Model

   In addition to the Directory Model, the X.500 standard defines the
   information model used in the Directory Service. All information in
   the Directory is stored in "entries", each of which belong to at
   least one "object class". In the White Pages application of X.500
   object classes are defined as country, organization, organizational
   unit and person.

   The object classes to which an entry belongs defines the attributes
   associated with a particular entry. Some attributes are mandatory
   others are optional. System administrators may define their own
   attributes and register these with regulating authorities, which will
   in turn make these attributes available on a large scale.

   Every entry has a Relative Distinguished Name (RDN), which uniquely
   identifies the entry. A RDN is made up of the DIT information and the
   actual entry.

   The Directory operates under a set of rules know as the Directory
   schema.  This defines correct utilization of attributes, and ensures
   an element of sameness throughout the global Directory Service.

   Under the White Pages object class "Person" there are three mandatory
   attributes:

        objectClass     commonName      surName

   These attributes along with the DIT structure above, define the RDN.

   An example of an entry under Sandia National Laboratory is shown
   here: @c=US@o=Sandia National Laboratory@ou=Employees@cn=Barbara
   Jennings

                                   root
                                   /  \
                                  /    \
                                c=US    c=CA
                                /  \
                               /    \
                  o=Sandia National   o=ESnet
                    Laboratory
                   /   \
                  /     \
            ou=Employees  ou=Guests
              /                \
             /                  \
     cn=Barbara Jennings        cn=Paul Brooks



Jennings                     Informational                      [Page 5]
RFC 1943     Building an X.500 Directory Service in the US      May 1996


   Organizations may define the best structure suited for their DIT.
   Typically an organizations DIT will look very much like the
   organizations structure itself. A DIT structure is determined by
   naming rules and as such, becomes the elements unique Relative
   Distinguished Name (RDN). The DIT structure may also be dependent on
   whether the DSA information is administered by a flat file or a
   database. Extra consideration to designing of the DIT structure
   should be taken when using flat files versus a database, as it takes
   longer to search through a flat file if the tree structure becomes
   too complex or intricate. To obtain information on recommended schema
   for DIT structuring see RFC1274 [3].

2.4     Benefits and Uses for X.500 Directory Service

   The nature of the X.500 Directory makes it suitable for independently
   operated segments that can be expanded to global distribution. The
   benefits for local directory use are:

   - with the distributed nature of the service, an organization may
   separate the responsibility for management of many DSAs and still
   retain the overall structure;

   - the robustness of this service allows it to provide information to a
   wide range of applications. Whereas globally integrated projects must
   conform to a specific DIT, independent X.500 operations may define
   unique DITs, object classes and attributes as per their specific
   needs;

   - X.500 is a good alternative for paper directories, offering the
   ability to update and modify in an interactive mode. This allows a
   company to provide the most current information with less cost and
   effort;

   - because of the electronic base of X.500, other electronic
   applications may interact with the application without human
   intervention.

   The benefits for global directory use are:

   - the distributed nature of X.500 is well suited for large global
   applications such as the White Pages Directory. Maintenance can be
   performed in a distributed manner;

   - X.500 offers good searching capabilities from any level in the DIT.
   Also with "User Friendly Naming" in place, searches are very
   intuitive;





Jennings                     Informational                      [Page 6]
RFC 1943     Building an X.500 Directory Service in the US      May 1996


   - there are DUA interfaces for the White Pages service available for
   all types of workstations. For an overview of X.500 software reference
   RFC1632.

   - X.500 is an international standard. Using such a standard ensures
   interoperability within the worldwide base.

2.5     Other Applications of X.500

   In addition to the White Pages, X.500 can be used as a source for any
   type of information that needs a distributed storage base.

   The University of Michigan is using X.500 for electronic mail
   routing. Any mail coming to the university domain, umich.edu; gets
   expanded out to a local address that is stored in the rfc822Mailbox
   attribute. The University also operates a standard X.500 name server
   which provides name lookup service of over 200,000 names. They use
   the Lightweight Directory Access Protocol (LDAP) [11].

   An implementation of the X.500 Standard directory service has been
   incorporated into the Open Software Foundation (OSF) Distributed
   Computing Environment (DCE). This component, known as the Global
   Directory Service (GDS), provides an area where distributed
   application clients can find their application servers. The GDS, in
   response to requests made by other clients, provides the unique
   network address for a particular DCE resource.  Because it is based
   on a international standard, GDS can offer access to resources among
   users and organizations worldwide. This scalable service can be
   performed in DCE environments that range in size from the very small
   to the very large.

   Lookup services can be implemented into a variety of applications.
   Cambridge University in Great Britain implemented the X.500 directory
   service into an employee locator application. Based on badge sensors
   at strategic locations, this application can determine the
   whereabouts of an employee on the campus. As the individual moves
   about, the sensors register their location in an X.500 Directory.

   Digital Signature Service (DSS) and Privacy Enhanced Mail (PEM) work
   on the principal of a directory key server which generates and
   provide users with "public" codes that match previously registered
   "private" codes. Only the recipient can decipher messages sent in
   this fashion. The X.509 [4] standard for key certificates easily fits
   within the structure of the X.500 Directory Service.







Jennings                     Informational                      [Page 7]
RFC 1943     Building an X.500 Directory Service in the US      May 1996


3.0     Legal Issues

3.1     Introduction

   Currently in the United States, there are no specific legal rules for
   the information that is provided via an electronic directory service.
   Various organizations and groups associated with usage of the
   Internet, noting a need to address privacy and data integrity issues,
   have prepared directives to address this issue. Two such areas
   addressed are those of the rights of registrants included in the
   directory and the responsibility of administrators to guarantee the
   integrity of such data.

   Registries containing information that is related to an individual is
   freely transferred and unregulated in the US, unless the provider of
   the data is an agency or an holder of sensitive information as
   defined by federal legislation and further may differ for each state.
   An agency is defined as: any executive department, military
   department, Government corporation, Government controlled
   corporation, or other establishment in the executive branch of the
   Government (including the Executive Office of the President), or any
   independent regulatory agency. Sensitive data can be financial
   records, medical records, and certain legal documents. As previously
   noted, each state has their own legislation on sensitive or private
   data.The registered persons have little recourse to control list
   information short of filing a lawsuit against the information
   provider.

   For individuals who transfer data across country boundaries, it is
   important to understand that other countries may have legislation to
   regulate data. Prior to requesting list information from these
   countries, an administrator should review applicable legislation and
   have some mechanism in place to ensure how data will be handled once
   it is crosses the border. Policy Statements for some countries have
   been prepared and are provided for via Code of Conduct papers.

3.2     Purpose of the Directory

   The operational intent including presentation data and list
   registrants and access rights must be clearly defined and stated.
   Initially this provides the skeleton of the DIT. Eventually a
   statement such as this may provide a basis legally justifying the
   directory.

   All data presented must be defined in the purpose. If for example, a
   directory is for the sole purpose of providing professional
   addressing information - an entry would include name, postal address,
   office telephone, facsimile number, electronic mail address and



Jennings                     Informational                      [Page 8]
RFC 1943     Building an X.500 Directory Service in the US      May 1996


   company name.  Private address information listing the home address
   or phone would be prohibited as would any other information not
   directly related to addressing.

3.3     User Rights

   The North American Directory Forum (NADF) has published a document
   that defines the User Bill of Rights [5]. This document defines an
   individuals rights regarding the public release of personal or
   private information.  Among other issues stated, the user has the
   right to be notified regarding the inclusion of their information in
   a data registry as well as the right to examine and have incorrect
   information changed.

   This paper is specifically written for the North American Directory
   Forum and recommends compliance with US or Canadian laws regulating
   privacy and access information.

   Although current US legislation does not include all the suggestions
   in this document, it is the responsibility of the controller of the
   data to respect the rights of the individuals. These recommended
   rules can be seen as respect for the individual and the considerate
   controller will follow these guidelines within any boundaries that
   they may be mandated by.

3.4     Data Integrity

   An information provider has the responsibility to guarantee the data
   that they make available to users. The integrity of a data source is
   heavily weighted by the accuracy and timeliness of the contents.
   Interoperable data sources must have concurrence of these factors as
   well. The degree to which an information provider can guarantee the
   validity of the data that they present, reflects on the validity of
   the provider in general. RFC 1355 [6], suggests that a data source
   enable accuracy statements describing the process that the individual
   NIC will use to maintain accuracy in the database.

   In the European community, it is a legal requirement that the
   information provider guarantee accurate data.

   The controller of the information needs to be certain of the primary
   source of data. When possible, the controller should develop routines
   of random checks to validate the registry data for correctness.








Jennings                     Informational                      [Page 9]
RFC 1943     Building an X.500 Directory Service in the US      May 1996


3.5     Data Security

   A Directory Service with non-authenticated access from the Internet
   is difficult to protect from unauthorized use. Unauthorized use being
   defined by each organization within the directory purpose statement.
   Typical misuse being by individuals who attempt to duplicate the
   directory for unauthorized purposes. Other security measures include:
   Access Control Lists (ACLs), limitations on number of entries
   returned to a query, and time to search flags. The result of such
   controls will affect the legitimate user as well as the user they are
   intended to block.

   An alternative that may provide protection from misuse is to create
   and display an attribute with each entry stating non-approved usage.
   This feature will also provide evidence of restricted use in the
   event that a legal case is necessary to stop unauthorized access.

   The responsibility again falls on the data provider/implementor of
   the directory service. Astute programmers will create or make use of
   existing tools to protect against data destruction, falsification,
   and misuse.

3.6     Conclusions

   User Rights, Data Integrity and Protection of data should not be
   considered merely in an effort to abide by legal rulings; they should
   be the intention of a good data source. A successful Directory
   Service must be aware of the requirements of those individuals
   inclusive in the list as well as those of the directory users.

   In general, at the minimum the following conditions should be
   observed:

        1. Define the purpose of the Directory.
        2. Initially inform all registrants of their inclusion in
           a Directory.
        3. Prevent the use of data beyond the stated purpose.
        4. Limit the attributes associated to an entry within
           boundaries of the purpose.
        5. Work towards a suitable level of security.
        6. Develop a mechanism to correct/remove faulty data
           or information that should not be in the Directory.









Jennings                     Informational                     [Page 10]
RFC 1943     Building an X.500 Directory Service in the US      May 1996


4.0     Infrastructure

4.1     Introduction

   The White Pages Project, currently operated by Performance Systems
   International (PSI) provides a reliable QUIPU infrastructure for
   sites wishing to provide their own X.500 directory. Started in 1989
   as the NYSERNet White Pages Pilot Project it was the first
   production-quality field test of the Open Systems Interconnection
   (OSI) technology running on top of TCP/IP suite of protocols [7].
   This pilot X.500 Directory, provided a real-time testbed for a
   variety of administrative and usage issues that arise. Today, more
   than 30 countries participate in the globally distributed project
   with over 1 million entries. The White Pages pilot is one of 37 other
   pilots cooperating to provide information in the Nameflow-PARADISE
   directory; an European project.

   Initially the software was public domain, QUIPU X.500 [8]. This
   "shareware" application in conjunction with administrative services
   provided free of charge by PSI, allowed for a truly distributed X.500
   Directory Service to operate.

   In keeping with the Internet rules of operation, the lack of the US
   regulations, the suggestions of North American Directory Forum and
   the Internet Engineering Task Force (IETF), the complications that
   arise from multi-distributed data as a service can be overwhelming.
   PSI took on the challenge to provide such a service, and continues to
   ensure operations today.

4.2     A Well Maintained Infrastructure

   This distributed information service involves the cohesive effort of
   all of the participating organizations. The ISO Development
   Environment (ISODE) implementation of the OSI Directory, provided the
   attributes and uniformity to facilitate this effort.

   The primary DSA for the PSI Project is named Alpaca. Operating on a
   Sun Sparc 10 with 120 megabytes of memory, this host serves as the
   Master for the DSAs of 117 organizations under c=US. Redundancy for
   Alpaca is provided by two sources, Fruit Bat operated by PSI and Pied
   Tamarin operated by the InterNIC. Slave updates to this host are
   provided on a nightly basis from the individual DSAs.

   The data presentation is hierarchical in nature and emulates the
   common white pages telephone book. The information provided contains
   at minimum: a common name, voice phone listing, and electronic mail
   addressing. Each entry has a uniqueness associates with it; the
   relative distinguished name which is comprised of the entire



Jennings                     Informational                     [Page 11]
RFC 1943     Building an X.500 Directory Service in the US      May 1996


   directory information tree. The DITs may vary slightly, but each must
   contain an organization, and a person. The nature of the directory
   and the structure of the actual organization for whom the directory
   is being provided contribute to the overall DIT structure. The
   following is a list of commonly used attributes:

commonName      physicalDeliveryOfficeName      stateOrProvinceName
description     photo                           streetAddress
userid          postOfficeBox                   surname
favouriteDrink  postalAddress                   telephoneNumber
title           rfc822Mailbox                   facsimileTelephoneNumber

4.3     DUA Interfaces for End Users

   There are a variety of user interfaces on the market today that will
   provide Directory User Agent access to the X.500 Directory. Standard
   protocols such as fred, whois, whois++, finger, are used widely.
   Interfaces are also available via World-wide Web browsers and
   electronic mail.

   Vendors providing DUAs include ISODE Consortium, NeXor, and Control
   Data Corporation. These applications operate in conjunction with the
   vendor provided DSAs.

   Historically DUA interfaces were difficult to implement and required
   the entire OSI stack. Implementing such a product on a PC or Apple
   platform required skillful programming. The executable for these
   platforms were usually very large. The IETF has since defined and
   standardized the Lightweight Directory Access Protocol (LDAP) [11]; a
   protocol for accessing on-line Directory services which offers
   comparable functionality to the Directory Access Protocol (DAP). It
   runs directly over TCP and is used by nearly all X.500 clients. LDAP
   does not have the overhead of the various OSI layers and runs on top
   of TCP/IP.

   The functionality varies by specific DUA. Each offers access to the
   X.500 Directory. Most offer the ability to make modifications to
   entries. There are a few that offer Kerberos authentication.

   Further information on LDAP clients for specific platforms can be
   found on the University of Michigan WWW server:
   http://www.umich.edu/~rsug/ldap.

   Another interface that has been tested and recommended for users by
   our Dutch (Surfnet) colleagues is Directory Enquiry (DE). Originally
   developed by University College London for the Paradise project in
   Europe, the engineers at Surfnet have selected DE as the best
   interface for "dumb" terminals. They have also translated the



Jennings                     Informational                     [Page 12]
RFC 1943     Building an X.500 Directory Service in the US      May 1996


   interface into Dutch for their local users [12].

   Ideally, users should be able to access X.500 directly from their
   electronic mail applications. Vendors (other than the ones mentioned
   above) have been slow to incorporate the X.500 Standards into their
   electronic mail applications.

5.0     Datamanagement & Pilot Projects

5.1     Simple Internet White Pages Service

   A wide variety of directory services retrieval protocols has emerged
   in the time since the original Internet White Pages was begun in
   1989. To ensure that decentralized implementations will have
   interoperability with other providers, the IETF Integrated Directory
   Services Working Group, is working to create a draft focusing on the
   common information and operational modeling issues to which all
   Internet White Pages Services (IWPS) must conform to.

   Utilizing current information servers, the conceptual model described
   includes issues regarding naming, schema, query and response issues
   for a narrowly defined subset of directory services. The goal of this
   paper is to establish a simple set of information objects, coupled
   with a basic set of process requirements that will form a basis which
   can lead to ubiquitous IWPS. With this goal in mind, it will be
   easier to proved a consistent User view of the various directory
   services.

5.2     InterNIC

   The InterNIC [9] is a collaborative project of two organizations
   working together to offer the Internet community a full scope of
   network information services. Established in January 1993 by the
   National Science Foundation, the InterNIC provides registration
   services and directory and database services to the Internet.
   (Internet a global network of more than 13,000 computers networks,
   connecting over 1.7 million computers and used by an estimated 13
   million people.) In keeping up with the exponential growth of the
   Internet, the InterNIC provides a guide to navigate the maze of
   available resources.

   InterNIC provides two types of services; InterNIC directory and
   database services and registration services. AT&T provides the
   directory and database services, acting as the pointer to numerous
   resources on the network offering X.500 to help users easily locate
   other users and organizations on the Internet.





Jennings                     Informational                     [Page 13]
RFC 1943     Building an X.500 Directory Service in the US      May 1996


5.3     ESnet

   The Energy Sciences Network [10], is a nationwide computer data
   communications network whose primary purpose is support multiple
   program, open scientific research. As part of this support, ESnet
   offers networking services including information access and
   retrieval, directory services, group communications series, remote
   file access services and infrastructure services. As a early member
   of the White-Pages Pilot Project, ESnet continues to be a part of the
   worldwide distributed directory service based on the ISO/OSI X.500
   standard. There are over nineteen ESnet organization represented in
   the directory, comprising over 120,000 entries. ESnet provides access
   to seven other sites via the X.500 DSAs.

6.0     Recommendations

6.1     General

   The X.500 Directory technology is available through several options.
   Vendors can provide consultation for schema design as well as supply,
   install, and support the software to perform the operations required.
   For smaller organizations or companies who do not want to administer
   their own DSA, there are providers available who will maintain the
   DSAs remotely and provide this service to the Internet. Those with
   network and management expertise, can either operate independently or
   join one of several white pages directory projects. Careful
   consideration must be given to the initial investment required and
   the required maintenance process.

6.2     Getting Started

   Successful initialization of a directory service requires a
   systematic approach. The complexity of offering this type of service
   becomes more apparent as implementation progresses. Several aspects
   must be considered as this service becomes a cooperative effort among
   the technical, administrative, organizational, and legal disciplines.
   Procedures must be defined and agreed to at the initial phase of
   implementing an X.500 Directory service [13].  The following are
   issues that should be addressed in these procedures.

6.3     Who are the Customers?

   Defining the customer and the customer requirements will determine
   the scope of service to offer. What is the primary purpose for the
   directory service? A company may find it desirable to do away with a
   paper directory while simultaneously providing the current directory
   information. The directory may be for internal use only or expanded
   to any users with Internet access. Will the customer use the



Jennings                     Informational                     [Page 14]
RFC 1943     Building an X.500 Directory Service in the US      May 1996


   directory for e-mail address only or is other locational information
   such as postal address and telephone number a requirement?

   The directory may provide information to electronic customers such as
   distributed computing applications as well. In this case, the data
   must be provided in machine readable format.

   Will the customers extend across country boundaries? Information may
   be considered private by one country and not by another. It is
   necessary to be aware of the legalities and restrictions for the
   locality using the data.  Some counties have published a Code of
   Conduct with the IETF, explicitly stating the legal restrictions on
   directory and list data. Check the archives to determine if the
   country with whom information will be shared has presented such
   information.

6.4     What are the contents of the Directory?

   The information presented in the directory is tightly coupled with
   the purpose. If the purpose is to provide addressing information for
   individuals, then customary information would include: Name, address,
   phone, e-mail address, facsimile number, pager, etc. If the use of
   the directory is to facilitate electronic mail routing then the
   destination mail address needs to be included for each user. No other
   information should be presented in the directory if it is not
   directly related to the purpose.

   If the directory is internal only, it may be desirable to include the
   registrants title as well. Remember that information available on the
   Internet is generally open to anyone who wants to access it.
   Individuals wishing to target a specific market may access
   directories to create customer mailing lists.

   The structure or schema of the X.500 Directory must be an initial
   consideration. Will the hierarchy follow the company structure or is
   a different approach more practical? How many entries will there be
   in the directory five or 50,000? A complex hierarchyfor thousands of
   users may affect the efficiency of queries.

6.5     What are the rights of the individuals?

   The subjects included in the directory shall have well defined
   rights.  These may be mandated by company policy, legal restrictions,
   and the ultimate use of the directory. For a basic Internet White
   Pages Service these rights may include:






Jennings                     Informational                     [Page 15]
RFC 1943     Building an X.500 Directory Service in the US      May 1996


        1. the option of inclusion in the directory
        2. the right of access to the information
        3. the right to have inaccurate entries corrected

   The terms and conditions for employees of an organization may affect
   these rights. On becoming an employee of any organization, an
   individual inevitably agrees to forego certain personal privacies and
   to accept restrictions.

   Every organization should develop and publish the "rights" that can
   be expected by the list registrants.

6.6     Data Integrity

   Information that needs to be included in the directory may come from
   various sources. Demographic information may originate from the human
   resources department. Electronic mail addresses may be provided by
   the computer network department. To guarantee data integrity, it is
   advised that the data be identified and maintained as corporate
   information.

   The required timeliness of the data is unique for each DSA. Updates
   to the data may be a frequent as once a day or once a month. Updates
   to the data must be provided on a regular basis. In cases where data
   is time sensitive, an attribute should be included to display the
   most recent maintenance date.

   A regular check for data accuracy should be included in the directory
   administration. Faulty information may put an organization in breach
   of any data protection laws and possibly render the company as
   unreliable.

6.7     Data Security

   Securing networked information resources is inherently complex.
   Attempts must be made to preserve the security of the data. These may
   include access control lists (ACLs), limiting the number or responses
   allowed to queries, or internal/external access to the directory.

   The 1993 recommendations have added a complex access control model
   that is designed to tightly restrict the access that users may have
   to the information in the Directory. Local protection is configured
   by the implementor. A secure X.500 Directory should provide tools to
   protect against destruction, falsification, and loss of data.

   There is not a tool yet that will protect against the misuse of data.
   There are flags and limits that can be set from within the
   application that will serve somewhat as a barrier to such unwanted



Jennings                     Informational                     [Page 16]
RFC 1943     Building an X.500 Directory Service in the US      May 1996


   use. Any restrictions however, also will affect the legitimate users.
   One suggestion is to post a notice of illegitimate use within each
   entry. This of course will only serve as a deterrent and as an asset
   should legal action be required.

   Again, caution must be taken when transferring data between country
   and state borders. In the US data regulations differ from state to
   state.

6.8     Data Administration

   The decentralized nature of the X.500 Directory service means that
   each organization has complete control over the data. As part of a
   global service however, it is important that the operation of the DSA
   be monitored and maintained in a consistent manner. Authorization
   must be given to the local manager of the information and in some
   cases, the subjects included in the directory may also have
   modification privileges.

   Once the service is running, the importance of guaranteed operation
   can not be overstated. Maintenance of the local Directory will be an
   integral part of normal administrative procedures within the
   organization and must be defined and agreed upon in the initial
   stages of development.

6.9     Conclusion

   Establishing a Directory service within an organization will involve
   a great deal of cooperative effort. It is essential to get commitment
   from the integral parties of an organization at the onset.  This
   includes the technical, legal, and data managements components of the
   organization.  Executive level commitment will make it much easier to
   get the cooperation necessary.

   Operational procedures must be clearly defined, as the inclusion in a
   globally distributed service has wide visibility. Adherence to these
   procedures must be maintained to the highest degree possible as
   misinformation may result in unintentional legal violations and
   unreliable access or data can adversely affect on a companys
   reputation.

   An X.500 Directory can be extremely useful for an organization if it
   operates as designed. It may serve as the "hub" of the information
   routing and the basis for several everyday activities. A successful
   service will be one of the most important tools for communication in
   the computer network environment. For people to make use of the
   service, they must be able to rely on consistent and accurate
   information.



Jennings                     Informational                     [Page 17]
RFC 1943     Building an X.500 Directory Service in the US      May 1996


References

   1.      CCITT Blue Book, Volume VIII - Fascicle VIII.8, November 1988.

   2.      RFC 1632; A Revised Catalog of Available X.500
           Implementations. A. Getchell; ESnet, S.
           Sataluri; AT&T.

   3.      RFC 1274; The COSINE and Internet X.500 Schema. P. Barker &
           S. Kille.

   4.      CCITT Blue Book, Volume VIII - Fascicle VIII - Rec. X.509,
           November 1988.

   5.      RFC 1295; User Bill of Rights for entries and listing in the
           Public Directory. Networking Working Group; IETF, January
           1992.

   6.      STD 35, RFC 1355; Privacy and Accuracy Issues in Network
           Information Center Databases. Curran, Marine, August 1992.

   7.      RFC 1006, ISO Transport Class 2 Non-use of Explicit Flow
           Control over TCP RFC 1006 extension. Y. Pouffary, June 1995.

   8.      Colin Robbins, NEXOR Ltd., Nottingham, London.
           c.robbins@nexor.co.uk

   9.      InterNIC; Collaborative effort of AT&T and
           Network Solutions; info@internic.net

   10.     ESnet; Managed and funded by the US Department of Energys
           Energy Research Office in Scientific Computing (DOE/ER/OSC).

   11.     RFC 1777; Lightweight Directory Access Protocol, W. Yeong,
           T. Howes, S. Kille, March 1995.

   12.     Building a Directory Service, Final Report test phase SURFnet
           X.500 pilot project, June 1995.

   13.     The X.500 Directory Services: a discussion of the concerns
           raised by the existence of a global Directory, Julia M. Hill,
           Vol.2/No.1 Electronic Networking, Spring 1992.

   14.     Directory Services and Privacy Issues, E. Jeunik and E.
           Huizer.






Jennings                     Informational                     [Page 18]
RFC 1943     Building an X.500 Directory Service in the US      May 1996


   15.     The Little Black Book; Mail Bonding with OSI Directory
           Services, Marshall T. Rose, Simon & Schuster Company,
           1992.

   16.     NYSERNet White Pages Pilot Project: Status Report; NYSERNet
           Technical Report #89-12-31-1, Marshall T. Rose, December 1989.

   17.     RFC 1798, Connection-less Lightweight Directory Access
           Protocol, A. Young, June 1995.

   18.     RFC 1781; Using the OSI Directory to Achieve User Friendly
           Naming, S. Kille, March 1995.

   19.     draft-ietf-pds-iwps-design-spec-01.txt, Tony Genovese;
           Microsoft, Work in Progress, July 1995.

   20.     draft-ietf-ids-privacy-00.txt, B. Jennings; Sandia National
           Laboratories, S. Sataluri; AT&T, Work in Progress, November
           1994.

Glossary

   ACL     Access Control List; a mechanism to restrict access to data
           stored in an X.500 Directory Service

   Attribute       A collection of attributes belong to an entry in the
                   Directory Service, and contain information belonging
                   to that entry.

   c=      countryName; Object class definition, specifies a country.
           When used as part of the directory name, it identifies the
           country in which the named object is physically located.

   cn=     commonName; Attribute defining common name for individuals
           included in a directory. In 1988 standards can be up to 64
           characters.

   CCITT   The International Telegraph and Telephone Consultative
           Committee.

   DAP     Directory Access Protocol; the protocol between a DUA and a
           DSA.

   DIB     Directory Information Base; a collection of information
           objects in the Directory.

   DIT     Directory Information Tree; the hierarchy of the distributed
           database that makes up an X.500 service.



Jennings                     Informational                     [Page 19]
RFC 1943     Building an X.500 Directory Service in the US      May 1996


   DSA     Directory System Agent; an application that offers the
           Directory service, this is the database for the Directory.

   DUA     Directory User Agent; an application that facilitates User
           access to a DSA.

   E-Mail  Electronic Mail.  Entry A Directory Service contains entries
           on people, organizations, countries, etc. Entries belong to a
           certain class, and information on entries is stored in
           attributes.

   ESnet   Energy Sciences Network; nationwide computer data
           communications network.

   GUI     Graphical User Interface.

   IETF    Internet Engineering Task Force; an internationally
           represented task force charged with solving the short-term
           needs of the Internet

   Internet        A collection of connected networks, international,
                   running the Internet suite of protocols.

   InterNIC        Directory of Directories, a collaborative project
                   between AT&T, and Network Solutions, Inc.

   IP      Internet Protocol; the network protocol offering a
           conectionless-mode network service in the Internet suite of
           protocols.

   ISODE   ISO Development Environment, a research tool developed to
           study the upper-layers of OSI and deploy network applications
           according to the ISO OSI standards and ITU X series of
           recommendations.

   ITU     International Telecommunication Union; formerly the CCITT.

   LDAP    Lightweight Directory Access Protocol, an Internet Standard
           for a lightweight version of DAP running over TCP/IP.

   Object  Entries in a Directory Service belong to an Object Class to
           Class indicate the type and characteristic; e.g. Object Class
           "person".

   OSI     Open Standards Interconnection, An international
           standardization program, facilitated by ISO and ITU to develop
           standards for data networking.




Jennings                     Informational                     [Page 20]
RFC 1943     Building an X.500 Directory Service in the US      May 1996


   o=      organization; An attribute defining the company or
           organization that the person works for.

   ou=     organizational unit; An attribute found under organization.
           Denotes the department, division, or other such sub-unit of
           the organization that the person works in.

   PEM     Privacy Enhanced Mail; and Internet Standard for sending
           secure Electronic mail.

   PSI     Performance Systems International, Inc.; operator of the
           Internet White Pages Project

   QUIPU   X.500 Directory implementation developed by Colin Robbins
           while at the University College of London.

   RDN     Relative Distinguished Name; a unique identifier for each list
           subject, defined by the hierarchy of the DSA.

   RFC     Request For Comments; Internet series publications

   sn=     surname; Attribute defining the surname of the person in the
           directory.

   TCP/IP  Transmission Control Protocol and Internet Protocol; two
           internet protocols.

   White-Pages     Electronic directory, accessible via Internet suite of
                   protocols.

   Whois   An Internet standard protocol.

   Whois++ An Internet Directory Services protocol; a possible
           alternative for X.500 WPS

   White Pages Service a Directory Service that contains information on
                       people and organizations.

   X.500   A series of recommendations as defined by the ITU, that
           specify a Directory Services protocol.











Jennings                     Informational                     [Page 21]
RFC 1943     Building an X.500 Directory Service in the US      May 1996


9.0 Security Considerations

   Security issues are not discussed in this memo.

Author's Address

   Barbara Jennings
   Sandia National Laboratories
   Scientific Computing Systems
   P.O. Box 5800
   M/S 0807
   Albuquerque, NM  87106
   USA

   Phone:  505-845-8554
   Fax:    505-844-2067
   EMail:  jennings@sandia.gov


































Jennings                     Informational                     [Page 22]
  1. RFC 1943