Red Hat Version4.1 Manuale Utente

comp.sysTCP/IPdirectory serverWorld Wide WebwwPersonalIStoreProxymerchant systemHTMLhttp://wwwInternetserversecuritynewsURLHTMLmailInternavigatorcommu

x Netscape Directory Server Gateway Customization GuidechangeHTML ...

82 Netscape Directory Server Gateway Customization GuideFor compatibility with HTTP clients that can’t handle an HTTP response with a charset paramete

Appendix A, .conf Parameters 83Example dirmgr “cn=Directory Manager, o=airius.com”For information on the root DN and on setting permissions for the di

84 Netscape Directory Server Gateway Customization GuideincludeDescription Specifies the location of another config file that should be read by the ga

Appendix A, .conf Parameters 85location-suffixDescription Identifies the directory suffix used to create new entries in the directory.This value is ap

86 Netscape Directory Server Gateway Customization Guide<rdnattr>. The attribute used to name entries of this type. For example, the default val

Appendix A, .conf Parameters 87templateDescription Maps specific object classes to internal gateway templates. These templates define how a specific o

88 Netscape Directory Server Gateway Customization Guide• ADR;WORK—The work address of the of the person or resource described by the vCard. By defaul

Appendix A, .conf Parameters 89Example The following example changes the mapping of the NOTE property from the default description attribute to a cust

90 Netscape Directory Server Gateway Customization Guide

Appendix B, Gateway Directives Reference 91IntroductionAppendixBGateway Directives ReferenceThis appendix describes directives used in Gateway HTML ob

Contents xiDS_SAVEBUTTON ... 101DS_EDITASBUTTON ...

Introduction92 Netscape Directory Server Gateway Customization GuideNote With the exception of GCONTEXT, each directive must start at the beginning of

Appendix B, Gateway Directives Reference 93Context-Related DirectivesContext-Related DirectivesThe context-related directives GCONTEXT and PCONTEXT ap

Entry-Related Directives94 Netscape Directory Server Gateway Customization Guide<!-- PCONTEXT --><form>Entry-Related DirectivesEntry-relat

Appendix B, Gateway Directives Reference 95Entry-Related DirectivesArguments attr=attribute-name . Displays the named attribute. Any attribute may be

Entry-Related Directives96 Netscape Directory Server Gateway Customization Guideoptions=option. Modifies how the attribute is displayed. Legal values

Appendix B, Gateway Directives Reference 97Entry-Related Directivesrows=number, rows=+number, rows=>number. Controls the number of rows used to dis

Entry-Related Directives98 Netscape Directory Server Gateway Customization Guide"options=readonly" --><!-- DS_ATTRIBUTE "attr=mai

Appendix B, Gateway Directives Reference 99Entry-Related DirectivesArgumentsprefix=text. HTML text to emit before view elements (optional) suffix=text

Entry-Related Directives100 Netscape Directory Server Gateway Customization GuideDS_SEARCHDESCDescriptionSpecifies that text describing the type of se

Appendix B, Gateway Directives Reference 101Entry-Related DirectivesArgumentslabel=text. Use "text" as the label on the button. If not provi

xii Netscape Directory Server Gateway Customization Guidedosearch ...

Entry-Related Directives102 Netscape Directory Server Gateway Customization GuideExamples<!-- DS_SAVEBUTTON "label=Save Changes" -->&l

Appendix B, Gateway Directives Reference 103Entry-Related DirectivesDS_CONFIRM_NEWPASSWORDDescriptionDisplays an HTML password INPUT field. The gatewa

Entry-Related Directives104 Netscape Directory Server Gateway Customization GuideDS_CLOSEBUTTONDescriptionDisplays a Close button, which causes the co

Appendix B, Gateway Directives Reference 105Entry-Related DirectivesDS_EMIT_BASE_HREFDescriptionEmit a <BASE> tag that contains the base URL for

Entry-Related Directives106 Netscape Directory Server Gateway Customization GuideDS_END_DNSEARCHFORMDescriptionXXX (Not supported in DS 1.0)ArgumentsN

Appendix B, Gateway Directives Reference 107Entry-Related DirectivesArguments for ELSE and ENDIFNone. Note that conditions marked with an astericks (*

Miscellaneous Directives108 Netscape Directory Server Gateway Customization Guide<!-- ENDIF ----><!-- IF "AttributeHasThisValue" &q

Appendix B, Gateway Directives Reference 109Miscellaneous DirectivesTITLEDescriptionEmit HTML <HEAD>, <TITLE>, and <BODY> elements.

Miscellaneous Directives110 Netscape Directory Server Gateway Customization GuideINCLUDEDescriptionInclude the contents of another HTML file. Note tha

Appendix B, Gateway Directives Reference 111Miscellaneous DirectivesArgumentsprefix=prefix-text. text displayed before the last operation info. suffix

Contents xiiiAdding Entries Using the New Entry Form ...128Adding a Person Entry ...

Miscellaneous Directives112 Netscape Directory Server Gateway Customization GuideExample<!-- DS_GATEWAY_VERSION -->IF/ ELSE/ ELIF/ ENDIF Same as

Appendix C, CGI Usage 113AppendixCCGI UsageThis appendix provides regular expression-type descriptions of the ways to invoke the CGIs in script files.

114 Netscape Directory Server Gateway Customization Guidedneditdnedit?CONTEXT=context&TEMPLATE=tmplname&DN=dn&ATTR=attrname&DESC=descr

Appendix C, CGI Usage 115filtersuffix = FILTERSUFFIXscope = SCOPEsearchdesc = SEARCHDESCeditedit?template&context=CONTEXT[&info=INFOSTRING] [&

116 Netscape Directory Server Gateway Customization Guide

Appendix D, Gateway User Help 117AppendixDGateway User HelpThis appendix provides instructions for using the Directory Server 4.0 gateway interface. T

Searching the Directory118 Netscape Directory Server Gateway Customization Guideou=Marketing, o=Airius.comou=Accounting, o=Airius.comEntries for peopl

Appendix D, Gateway User Help 119Searching the DirectoryBoth types of searches permit searching for any of the entry types described in Table 7.9.Afte

Searching the Directory120 Netscape Directory Server Gateway Customization GuideTo perform a standard search:1. Select the Standard Search tab. The St

Appendix D, Gateway User Help 121Searching the Directory• a character space, a period, or a space and a period together• one or more charactersFor exa

xiv Netscape Directory Server Gateway Customization Guide

Searching the Directory122 Netscape Directory Server Gateway Customization GuideSearching for Email AddressesStandard search searches for matching ema

Appendix D, Gateway User Help 123Searching the DirectoryThe options for the first three of these fields are provided in pull-down menus. The fourth fi

Searching the Directory124 Netscape Directory Server Gateway Customization GuideNo matchesA search result that returns no matches means one of the fol

Appendix D, Gateway User Help 125AuthenticationAuthenticationAuthentication is the process of enabling users to perform operations on the directory. B

Authentication126 Netscape Directory Server Gateway Customization Guide• allow or deny access based on the physical machine being used.The interface p

Appendix D, Gateway User Help 127AuthenticationLogging Out of the DirectoryTo unauthenticate:1. Click on the authentication tab. The Authentication fo

Adding Entries Using the New Entry Form128 Netscape Directory Server Gateway Customization GuideAdding Entries Using the New Entry FormThe New Entry f

Appendix D, Gateway User Help 129Adding Entries Using the New Entry Form•an NT person•a group•an NT group• an organizational unit• an organizationDire

Adding Entries Using the New Entry Form130 Netscape Directory Server Gateway Customization GuideAdding an NT Person EntryWhen creating an NT Person en

Appendix D, Gateway User Help 131Adding Entries Using the New Entry FormAdding an NT GroupRequired fields for an NT Group include:•Name•NT Group Name•

xvTablesLocation of gateway files for release 4.0 ...12Location of gateway files for release

Adding Entries Using the New Entry Form132 Netscape Directory Server Gateway Customization GuideAdding an Organization EntryAn organization can only b

Index 133IndexAAdditional CGI directory 19Additional document directory 19Advanced searchattributes for 59example of pop-up menu 60Attributesadding to

134 Netscape Directory Server Gateway Customization GuideDS_DELETEBUTTON 101DS_DNEDITBUTTON 105DS_EDITASBUTTON 102DS_EDITBUTTON 100DS_EMIT_BASE_HREF 1

Index 135what is 1Gateway CGIs 6Gateway clients, see HTTP clientsGateway cloning 12, 23Gateway configuration.conf file 23changing LDAP port using base

136 Netscape Directory Server Gateway Customization GuideHTTP server configurationadd additional CGI directory (3.x) 21add additional CGI directory (4

Index 137vcard-property 87pb.conf, see Directory ExpressPort setting 23POST operationspecifying in an HTML form 7using PCONTEXT 7RRoot processes 13Roo

138 Netscape Directory Server Gateway Customization Guide

xvi Gateway Customization Guide

xviiExamplesHTML and configuration directories specified in pb.conf ...6Embedding GCONTEXT in a Link ...

xviii Writer’s Guide

Chapter 1, Gateway Features 1Chapter1Chap ter 1 Gateway FeaturesThis chapter describes the gateway features introduced with release 4.0 of the Directo

Netscape Communications Corporation ("Netscape") and its licensors retain all ownership rights to the software programs offered by Netscape

HTTP Server Requirements for Gateways2 Netscape Directory Server Gateway Customization GuideIn Version 4.0 of Netscape Directory Server, many gateway

Chapter 1, Gateway Features 3Gateways Installed with Directory Server 4.0See Also“Location of Gateway Files” on page 12Default Gateway (dsgw.conf)In a

Gateways Installed with Directory Server 4.04 Netscape Directory Server Gateway Customization GuideDuring Netscape Directory Server 4.0 installation,

Chapter 1, Gateway Features 5Support for Multiple Gateway InstancesFigure 1.3 Directory Express Extended Search ResultsSupport for Multiple Gateway In

Support for Multiple Gateway Instances6 Netscape Directory Server Gateway Customization GuideThe .conf files defining the configuration of gateway ins

Chapter 1, Gateway Features 7Support for Multiple Gateway InstancesPOST Operations (PCONTEXT)In a POST operation, the CGI posts to the gateway instanc

Gateway Localization8 Netscape Directory Server Gateway Customization GuideGateway LocalizationThe gateway is designed to allow support for clients in

Chapter 1, Gateway Features 9Non-Anonymous SearchingNon-Anonymous SearchingRelease 3.0 of the gateway allows anonymous searching only. This provides o

Compatibility with Existing Gateways10 Netscape Directory Server Gateway Customization GuideCompatibility with Existing GatewaysRelease 4.0 of the Dir

Chapter 2, Setting Up the Gateway 11Chapter2Chapter 2Setting Up the GatewayThis chapter describes the planning decisions and tasks required to install

iiiPrefaceThe descriptions, instructions, and examples in this guide can be used to create and modify a gateway instance to suit the needs of users in

Gateway Installation Planning12 Netscape Directory Server Gateway Customization Guide• whether to migrate existing gateways to release 4.1 gateways or

Chapter 2, Setting Up the Gateway 13Gateway Installation PlanningSee Also“Gateway Cloning” on page 23Gateway Release 3.xOne gateway is installed for e

Gateway Installation Planning14 Netscape Directory Server Gateway Customization GuideMigrating 3.x default Gateways to Release 4.0Release 4.0 of the N

Chapter 2, Setting Up the Gateway 15Gateway Installation PlanningRunning the Gateway Migration ScriptThe dsgwmig script runs automatically during the

Gateway Installation Planning16 Netscape Directory Server Gateway Customization Guide• the number of users accessing the gateway at a given time• the

Chapter 2, Setting Up the Gateway 17HTTP Server ConfigurationHTTP Server ConfigurationName Translation MappingThe HTTP server uses Name Translation ma

HTTP Server Configuration18 Netscape Directory Server Gateway Customization GuideIn release 3.x, to access a different suffix, another HTTP server and

Chapter 2, Setting Up the Gateway 19HTTP Server ConfigurationFigure 2.1 Configuring an Additional Document DirectoryFigure 2.2 Configuring an Addition

HTTP Server Configuration20 Netscape Directory Server Gateway Customization GuideAdd an Additional Document Directory (4.0 Gateways)Adding an addition

Chapter 2, Setting Up the Gateway 21HTTP Server ConfigurationAdding an additional CGI directory is necessary to make the gateway’s CGI programs availa

Related Informationiv Netscape Directory Server Gateway Customization Guide• Chapter 5, Entry Types and Object Class Attributes: Provides examples of

Creating a New Gateway Instance (4.0 only)22 Netscape Directory Server Gateway Customization GuideThe process listed identifies the name under which t

Chapter 2, Setting Up the Gateway 23Gateway .conf File Configuration4. Create an HTML directory for the new gateway: For example, to provide an HTML d

Gateway .conf File Configuration24 Netscape Directory Server Gateway Customization GuideSetting Up the Directory ManagerWhen the Directory server is i

Chapter 2, Setting Up the Gateway 25Gateway .conf File ConfigurationFigure 2.3 Authenticating as Directory ManagerSetting up the Suffix for Adding Ent

Gateway .conf File Configuration26 Netscape Directory Server Gateway Customization GuideConfiguring the gateway to use SSL when communicating with the

Chapter 2, Setting Up the Gateway 27Configuring Gateway ClientsIf a single character set works well for most gateway users, define it using the charse

Configuring Gateway Clients28 Netscape Directory Server Gateway Customization GuideUnicode and Latin-1 Character SetsWhen the user is using Netscape C

Chapter 2, Setting Up the Gateway 29Configuring Gateway Clients6. Go to Edit | Preferences | Navigator | Languages and configure the list of languages

Configuring Gateway Clients30 Netscape Directory Server Gateway Customization Guide• In the Search Directory dialog, users can enter more complex quer

Chapter 3, Gateway Localization 31Chapter3Chapter 3Gateway LocalizationThis chapter describes gateway localization and identifies the tasks required t

Contents vContentsPreface ... iiiWho Need

How the Gateway Selects a Character Set32 Netscape Directory Server Gateway Customization GuideThe NT Synchronization Server, installed with the Direc

Chapter 3, Gateway Localization 33How the Gateway Selects a Character SetHTTP Clients that Request UTF-8Browsers designed for localization are configu

Special Characters34 Netscape Directory Server Gateway Customization GuideSpecial CharactersNon-breaking SpaceIf the client’s character set lacks a ch

Chapter 3, Gateway Localization 35Setting Up Locales for TranslationSupport for multiple locales is accomplished by translating documentation (includi

Setting Up Locales for Translation36 Netscape Directory Server Gateway Customization Guideinclude “../config/dsgw-l10n.conf”4. create a “zh” directory

Chapter 4, Files Controlling Gateway Functionality 37Chapter4Chapter 4Files Controlling GatewayFunctionalityThis chapter describes gateway components.

An Overview of Gateway File Types38 Netscape Directory Server Gateway Customization Guide• create new gateway instances• edit the object class attribu

Chapter 4, Files Controlling Gateway Functionality 39Gateway .conf FilesGateway .conf FilesA gateway’s .conf file describes the gateway’s instance. A

Object Class Templates40 Netscape Directory Server Gateway Customization Guidedsgwsearchprefs.confThe object classes and object class attributes than

Chapter 4, Files Controlling Gateway Functionality 41Gateway Script FilesGateway Script FilesScript files are used to dynamically generate HTML forms

vi Netscape Directory Server Gateway Customization GuideGateway Release 4.0 ...

Gateway Search Result Templates42 Netscape Directory Server Gateway Customization GuideGateway Search Result TemplatesSearch result templates control

Chapter 4, Files Controlling Gateway Functionality 43Banner FilesSee AlsoChapter 6, “Search Attributes, Filters, and Results,” describes how search re

Banner Files44 Netscape Directory Server Gateway Customization Guide

Chapter 5, Entry Types and Object Class Attributes 45Chapter5Chapter 5Entry Types and Object ClassAttributesThis chapter describes how entry type form

Entry Types (Object Classes)46 Netscape Directory Server Gateway Customization Guide• location parameter settings that determine where in the director

Chapter 5, Entry Types and Object Class Attributes 47Entry Types (Object Classes)Figure 5.1 New Entry FormConsiderations for Adding New Entry TypesBef

Mapping Locations and Entry Types48 Netscape Directory Server Gateway Customization GuideDeciding how the new entry is formattedWhen the new object cl

Chapter 5, Entry Types and Object Class Attributes 49Mapping Locations and Entry Typesnewtype orgperson "Person" cn acct hr pay pd testnewty

Object Class Attributes in Template Files50 Netscape Directory Server Gateway Customization GuideNote UID-based DN formats are recommended because the

Chapter 5, Entry Types and Object Class Attributes 51Object Class Attributes in Template FilesTemplates and DirectivesObject class attributes associat

Contents viiConfiguring Gateway Clients ...27Language Support for HTTP Clie

Object Class Attributes in Template Files52 Netscape Directory Server Gateway Customization Guide</TR>To complete the row, two null cells are ad

Chapter 5, Entry Types and Object Class Attributes 53Object Class Attributes in Template Files<TD>&nbsp;</TD><TD>&nbsp;</

Object Class Attributes in Template Files54 Netscape Directory Server Gateway Customization Guide<!-- DS_OBJECTCLASS "value=person,inetOrgPers

Chapter 5, Entry Types and Object Class Attributes 55Object Class Attributes in Template Filestemplate Airiusperson person inetorgperson airiuspersonT

Object Class Attributes in Template Files56 Netscape Directory Server Gateway Customization GuideNote Netscape recommends modifying an existing search

Chapter 6, Search Attributes, Filters, and Results 57Chapter6Chapter 6Search Attributes, Filters, and ResultsThis chapter describes the files that con

Search Configuration Files58 Netscape Directory Server Gateway Customization Guidedsgwsearchprefs.conf Preferences for searching object classes define

Chapter 6, Search Attributes, Filters, and Results 59Changing Search ScopeChanging Search ScopeSearch object entries in dsgwsearchprefs.conf define th

Modifying Search Attributes for Advanced Searches60 Netscape Directory Server Gateway Customization GuideFigure 6.1 Entry Type Pull-Down Menu for Adva

Chapter 6, Search Attributes, Filters, and Results 61Modifying Search Attributes for Advanced SearchesFigure 6.3 Matching Type Pull-Down on Advanced S

viii Netscape Directory Server Gateway Customization GuideObject Class Templates ...

Modifying Search Attributes for Advanced Searches62 Netscape Directory Server Gateway Customization GuideThe first column in Example 6.1 specifies how

Chapter 6, Search Attributes, Filters, and Results 63Modifying Search Attributes for Advanced SearchesDirectory Express Search Support for User IDDire

Adding Search Support for a New Object64 Netscape Directory Server Gateway Customization GuideAdding Search Support for a New ObjectThere are two ways

Chapter 6, Search Attributes, Filters, and Results 65Adding Search Support for a New ObjectThe syntax added to dsgwfilter.conf in Example 6.4 defines

Modifying Default Search Filters66 Netscape Directory Server Gateway Customization GuideThe syntax in Example 6.6 specifies a list of filters for sear

Chapter 6, Search Attributes, Filters, and Results 67Modifying Default Search FiltersExample 6.7 Search Filter for Email Address Searches"@"

Customizing Search Result Templates68 Netscape Directory Server Gateway Customization GuideCustomizing Search Result TemplatesHow the Gateway Displays

Chapter 6, Search Attributes, Filters, and Results 69Customizing Search Result TemplatesTable 6.3 lists the default gateway search objects and the inf

Customizing Search Result Templates70 Netscape Directory Server Gateway Customization Guide<TH NOWRAP>Name<TH NOWRAP>Phone Number<TH NO

Chapter 7, Customizing Graphics and Color 71Chapter7Chapter 7Customizing Graphics and ColorThis chapter describes how to change the appearance of defa

Contents ixSpecifying Search Attributes for Person ...61Directory Express Search Support for Use

Updating the Banner Image72 Netscape Directory Server Gateway Customization Guide• link colorUpdating the Banner ImageThe default gateway banner image

Chapter 7, Customizing Graphics and Color 73Updating Button ImagesUpdating Button ImagesButtons on gateway forms can be replaced by updating button im

Color Schemes74 Netscape Directory Server Gateway Customization Guide• newentrytitle.htmlChanging the default filename of a button .gif file requires

Chapter 7, Customizing Graphics and Color 75Color SchemesTable 7.2 Files Controlling Appearance of Gateway FormsTo Change Colors on the Edit File Typ

Color Schemes76 Netscape Directory Server Gateway Customization GuideChanging Colors Using BODY TagTable 7.3 lists the five standard color attributes

Chapter 7, Customizing Graphics and Color 77Changing Table ColorsChanging Table ColorsSpecifying Color Names and Color CodesThere are two ways to spec

Changing Table Colors78 Netscape Directory Server Gateway Customization GuideChanging Color of Table HeadingsTo change the color of table heading text

Appendix A, .conf Parameters 79AppendixA.conf ParametersThis appendix describes, in alphabetical order, gateway configuration parameters. Parameters a

80 Netscape Directory Server Gateway Customization GuidebaseurlDescription Specifies the host name and port number used to contact the Directory Serve

Appendix A, .conf Parameters 81binddnfileDescription Specifies the location of the file where the bind DN and bind password are stored. This file is u