Red Hat DIRECTORY SERVER 7.1 - GATEWAY CUSTOMIZATION Guide d'installation

Naviguer en ligne ou télécharger Guide d'installation pour Serveurs Red Hat DIRECTORY SERVER 7.1 - GATEWAY CUSTOMIZATION. Red Hat DIRECTORY SERVER 7.1 - GATEWAY CUSTOMIZATION Installation guide Manuel d'utilisatio

  • Télécharger
  • Ajouter à mon manuel
  • Imprimer
  • Page
    / 132
  • Table des matières
  • MARQUE LIVRES
  • Noté. / 5. Basé sur avis des utilisateurs

Résumé du contenu

Page 1 - Gateway Customization Guide

Gateway Customization GuideRed Hat Directory ServerVersion 7.1April 2005

Page 2

10 Red Hat Directory Server Gateway Customization Guide • April 2005Arguments for ELSE and ENDIF . . . . . . . . . . . . . . . . . . . . . . . . . .

Page 3 - Contents

Introduction108 Red Hat Directory Server Gateway Customization Guide • April 2005Structure of an HTML TemplateDirectory entry display, edit, and add t

Page 4

Context-Related DirectivesAppendix B Gateway Directives 109Context-Related DirectivesThe context-related directives GCONTEXT and PCONTEXT appear withi

Page 5

Entry-Related Directives110 Red Hat Directory Server Gateway Customization Guide • April 2005Entry-Related DirectivesEntry-related directives are supp

Page 6

Entry-Related DirectivesAppendix B Gateway Directives 111type=how-to-display. Renders the attribute on-screen in a particular format. Legal values des

Page 7

Entry-Related Directives112 Red Hat Directory Server Gateway Customization Guide • April 2005defaultvalue=default-value. Supplies a default value for

Page 8

Entry-Related DirectivesAppendix B Gateway Directives 113cols=number, cols=+number, cols=>number. Controls the width of the displayed attribute. If

Page 9

Entry-Related Directives114 Red Hat Directory Server Gateway Customization Guide • April 2005DS_OBJECTCLASSDescribes the type of directory entries for

Page 10

Entry-Related DirectivesAppendix B Gateway Directives 115DS_SORTENTRIESSpecifies that entries should be sorted; typically used within list templates.

Page 11

Entry-Related Directives116 Red Hat Directory Server Gateway Customization Guide • April 2005DS_EDITBUTTONDisplays a button which, when clicked, bring

Page 12

Entry-Related DirectivesAppendix B Gateway Directives 117<!-- DS_SAVEBUTTON "checksubmit=formDataValid()" -->DS_EDITASBUTTONDisplays a

Page 13 - Prerequisite Reading

11domodify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Page 14 - Related Information

Entry-Related Directives118 Red Hat Directory Server Gateway Customization Guide • April 2005DS_OLDPASSWORDDisplays an HTML password field for the old

Page 15 - Preface 19

Entry-Related DirectivesAppendix B Gateway Directives 119ArgumentsNone.DS_END_ENTRYFORMCauses the gateway to emit a </FORM> tag. This directive

Page 16

Entry-Related Directives120 Red Hat Directory Server Gateway Customization Guide • April 2005ArgumentsNone.DS_ATTRVAL_SETDisplay an attribute based on

Page 17 - Introduction

Entry-Related DirectivesAppendix B Gateway Directives 121Examples<!-- IF "!DirectoryIsLocalDB" -->The entry was last modified by <!

Page 18 - Default Gateway

Miscellaneous Directives122 Red Hat Directory Server Gateway Customization Guide • April 2005Miscellaneous DirectivesBODYEmit HTML <BODY> elemen

Page 19 - Directory Express (pb.conf)

Miscellaneous DirectivesAppendix B Gateway Directives 123ENDHTMLEmit </BODY></HTML> sequenceArgumentsNone.HELPBUTTONDisplay a Help button

Page 20

Miscellaneous Directives124 Red Hat Directory Server Gateway Customization Guide • April 2005Argumentsfilename. The name of the file to include. This

Page 21 - Default Gateway (dsgw.conf)

Miscellaneous DirectivesAppendix B Gateway Directives 125DS_GATEWAY_VERSIONEmit a string containing the version of the directory gateway CGI being exe

Page 22 - URLs for Gateway Access

Miscellaneous Directives126 Red Hat Directory Server Gateway Customization Guide • April 2005

Page 23 - Chapter 1 Introduction 27

127Appendix CCGI UsageThis appendix provides regular expression-type descriptions of the ways to invoke the CGIs in script files. Each regular express

Page 24

12 Red Hat Directory Server Gateway Customization Guide • April 2005

Page 25 - Setting Up the Gateway

128 Red Hat Directory Server Gateway Customization Guide • April 2005searchType = SEARCHTYPEsearchAttr = SEARCHATTRunauthunauth[?conetxt=CONTEXT]dnedi

Page 26 - Gateway Cloning

Appendix C CGI Usage 129newentrynewentry[?context=CONTEXT[&file=FILE]]entrytype = ETentryname = ENrdntag = RDNTAGselectLocation = SLdnsuffix = DNS

Page 27 - Server Configuration

130 Red Hat Directory Server Gateway Customization Guide • April 2005

Page 28 - HTTP Server Configuration

131IndexAAdvanced searchattributes for 69example of pop-up menu 71Attributesadding to object classes 61deleting from object classes 61auth CGI 127Auth

Page 29 - Gateway Root Suffix

132 Red Hat Directory Server Gateway Customization Guide • April 2005DS_ATTRVAL_SET 120DS_BEGIN_DNSEARCHFORM 120DS_BEGIN_ENTRYFORM 119DS_CLOSEBUTTON 1

Page 30

Index 133setting suffix for adding entries 39setting up SSL support 40Gateway configuratoncustomizing Communicator’s LDAP settings 42Gateway files.con

Page 31

134 Red Hat Directory Server Gateway Customization Guide • April 2005NName translation mapping 33newentry CGI 129newtype parameter 56, 100NLS paramete

Page 32

Index 135creating new 75Search preferencesextending 74Search result templatescustomizing 78default templates and related object classes 53modifying 80

Page 33

136 Red Hat Directory Server Gateway Customization Guide • April 2005

Page 34

List of Tables 13List of TablesTable 2-1 Location of Gateway Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Page 35 - Setting Up SSL Support

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

Page 36 - Configuring Gateway Clients

14 Red Hat Directory Server Gateway Customization Guide • April 2005

Page 37

Gateway Customization Guide April 2005iExamplesHTML and configuration directories specified in pb.conf ... 6Emb

Page 38

ii Red Hat Directory Server Gateway Customization Guide

Page 39 - Gateway Localization

Conventions Used in This Book18 Red Hat Directory Server Gateway Customization Guide • April 2005Conventions Used in This BookThis section explains th

Page 40 - Characters Sets

Related InformationPreface 19• Red Hat Directory Server Deployment Guide. Provides an overview for planning your deployment of the Directory Server. I

Page 41 - Special Characters

Related Information20 Red Hat Directory Server Gateway Customization Guide • April 2005

Page 42 - Gateway Locales

21Chapter 1IntroductionThis chapter describes the gateway functionality of Red Hat Directory Server (Directory Server). The chapter contains the follo

Page 43

What Is a Gateway?22 Red Hat Directory Server Gateway Customization Guide • April 2005Gateways Installed with Directory ServerTwo gateway instances ar

Page 44

Directory Express and Default GatewayChapter 1 Introduction 23Directory ExpressThe configuration file for Directory Express is serverRoot/clients/dsgw

Page 45 - Chapter 4

Red Hat, Inc.1801 Varsity Drive Raleigh NC 27606-2072 USA Phone: +1 919 754 3700 Phone: 888 733 4281 Fax: +1 919 754 3701 PO Box 13588 Research Triang

Page 46 - Gateway .conf Files

Directory Express and Default Gateway24 Red Hat Directory Server Gateway Customization Guide • April 2005Figure 1-1 Directory Express: Search Result F

Page 47

Support for Multiple Gateway InstancesChapter 1 Introduction 25Default Gateway (dsgw.conf)In addition to the standard search form, the default gateway

Page 48 - Gateway Script Files

Support for Multiple Gateway Instances26 Red Hat Directory Server Gateway Customization Guide • April 2005Specifying Gateway Configuration to Gateway

Page 49

Anonymous and Non-Anonymous SearchingChapter 1 Introduction 27http://adminHost:adminPort/clients/dsgw/bin/lang?context=<context>The default gate

Page 50 - Banner Files

Automatic Updates to Directory Configuration28 Red Hat Directory Server Gateway Customization Guide • April 2005The updatedsgw script runs automatical

Page 51 - Editing Entry Types

29Chapter 2Setting Up the GatewayThis chapter describes the planning decisions and tasks required to install and initially configure a gateway for acc

Page 52 - Entry Types (Object Classes)

Gateway Installation Planning30 Red Hat Directory Server Gateway Customization Guide • April 2005Two gateway instances are installed during Directory

Page 53

Gateway Installation PlanningChapter 2 Setting Up the Gateway 31Protecting Bind DN and PasswordThe gateway configuration files reference files that co

Page 54

HTTP Server Configuration32 Red Hat Directory Server Gateway Customization Guide • April 2005There are many factors affecting gateway performance on a

Page 55 - UID-Based DN

HTTP Server ConfigurationChapter 2 Setting Up the Gateway 33Name Translation MappingThe HTTP server uses Name Translation mapping to translate a virtu

Page 56 - Templates and Directives

3ContentsList of Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Page 57

HTTP Server Configuration34 Red Hat Directory Server Gateway Customization Guide • April 20052. Adding the following CGI directories (under Program Ma

Page 58 - Extending Object Classes

HTTP Server ConfigurationChapter 2 Setting Up the Gateway 352. Add an additional document directory.Adding an additional document directory is necessa

Page 59

Creating a New Gateway Instance36 Red Hat Directory Server Gateway Customization Guide • April 2005http://webserverHost:webserverPort/clients/dsgw/bin

Page 60

Gateway .conf File ConfigurationChapter 2 Setting Up the Gateway 377. To access the new gateway instance (in this example, example.conf) navigate the

Page 61 - Search Configuration Files

Gateway .conf File Configuration38 Red Hat Directory Server Gateway Customization Guide • April 2005It is strongly recommended that you use a differen

Page 62 - Changing Search Scope

Gateway .conf File ConfigurationChapter 2 Setting Up the Gateway 39Figure 2-1 Authenticating as Directory Manager Setting Up the Suffix for Adding Ent

Page 63

Configuring Gateway Clients40 Red Hat Directory Server Gateway Customization Guide • April 2005Enabling SSL communications on the Directory Server is

Page 64 - Search form

Configuring Gateway ClientsChapter 2 Setting Up the Gateway 41Language Support for HTTP ClientsWhen a user accesses information in the directory from

Page 65

Configuring Gateway Clients42 Red Hat Directory Server Gateway Customization Guide • April 2005Customizing Communicator’s LDAP SettingsAdministrators

Page 66

43Chapter 3Gateway LocalizationThis chapter describes gateway localization and identifies the tasks required to set up additional gateway locales. The

Page 67 - Bit Position Match Type

4 Red Hat Directory Server Gateway Customization Guide • April 2005Chapter 2 Setting Up the Gateway . . . . . . . . . . . . . . . . . . . . . . . . .

Page 68 - Extending Search Preferences

How the Gateway Selects a Character Set44 Red Hat Directory Server Gateway Customization Guide • April 2005How the Gateway Selects a Character SetThe

Page 69 - Creating a New Search Object

Special CharactersChapter 3 Gateway Localization 45HTTP Clients that Do Not Request UTF-8For browsers that do not request UTF-8 by default, the gatewa

Page 70

Gateway Locales46 Red Hat Directory Server Gateway Customization Guide • April 2005This works around a problem with Japanese NT, which garbles environ

Page 71

Setting Up Locales for TranslationChapter 3 Gateway Localization 47dsgw-l10n.confdsgw-l10n.conf provides translation in the Search and Advanced Search

Page 72 - Search Result Tables

Setting Up Locales for Translation48 Red Hat Directory Server Gateway Customization Guide • April 2005

Page 73

49Chapter 4File Controlling Gateway FunctionalityThis chapter provides examples of customized gateways. The chapter contains the following sections:•

Page 74

Gateway .conf Files50 Red Hat Directory Server Gateway Customization Guide • April 2005Files that control gateway functionality are described in Table

Page 75

Gateway Search Configuration FilesChapter 4 File Controlling Gateway Functionality 51• The locations where new entries can be created within the direc

Page 76

Object Class Templates52 Red Hat Directory Server Gateway Customization Guide • April 2005Object Class TemplatesThe gateway contains a template file f

Page 77 - Banner Image

Gateway Search Result TemplatesChapter 4 File Controlling Gateway Functionality 53Gateway Search Result TemplatesSearch result templates control how t

Page 78 - Button Images

5Setting Up Locales for Translation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Page 79 - Updating Button Images

Banner Files54 Red Hat Directory Server Gateway Customization Guide • April 2005Chapter 6, “Search Attributes, Filters, and Results,” describes how se

Page 80 - Color Schemes

55Chapter 5Editing Entry TypesThis chapter describes how entry type formats — defined by object classes and their attributes — can be controlled by ed

Page 81 - Color Using Attribute

Entry Types (Object Classes)56 Red Hat Directory Server Gateway Customization Guide • April 2005templateThe template parameter is used to map the gate

Page 82 - Changing Table Colors

Mapping Locations and Entry TypesChapter 5 Editing Entry Types 57Considerations for Adding New Entry TypesBefore adding support for a new entry type (

Page 83 - Color Name Hexadecimal Value

Mapping Locations and Entry Types58 Red Hat Directory Server Gateway Customization Guide • April 2005In the example, locations defined in the newtype

Page 84

Object Class Attributes in Template FilesChapter 5 Editing Entry Types 59UID-Based DNWhen a person or Windows person entry is added to the directory,

Page 85

Object Class Attributes in Template Files60 Red Hat Directory Server Gateway Customization Guide • April 2005Default Gateway Object ClassesThe default

Page 86

Object Class Attributes in Template FilesChapter 5 Editing Entry Types 61Adding Attributes to Object ClassesAdding an attribute to an object class req

Page 87

Object Class Attributes in Template Files62 Red Hat Directory Server Gateway Customization Guide • April 20052. Insert a null pair to replace the dele

Page 88

Object Class Attributes in Template FilesChapter 5 Editing Entry Types 632. Edit the third line in the template file to indicate the name of the new d

Page 89

6 Red Hat Directory Server Gateway Customization Guide • April 2005Modifying Search Attributes for Advanced Searches . . . . . . . . . . . . . . . .

Page 90

Object Class Attributes in Template Files64 Red Hat Directory Server Gateway Customization Guide • April 20056. Define a template parameter in dsgw.co

Page 91

67Chapter 6Search Attributes, Filters, and ResultsThis chapter describes the files that control how the gateway searches for objects and describes how

Page 92

Changing Search Scope68 Red Hat Directory Server Gateway Customization Guide • April 2005• The label of the search attribute as it is displayed in the

Page 93

Modifying Search Attributes for Advanced SearchesChapter 6 Search Attributes, Filters, and Results 69Modifying Search Attributes for Advanced Searches

Page 94

Modifying Search Attributes for Advanced Searches70 Red Hat Directory Server Gateway Customization Guide • April 2005Figure 6-1 Advanced Search Form:

Page 95

Modifying Search Attributes for Advanced SearchesChapter 6 Search Attributes, Filters, and Results 71Figure 6-2 Advanced Search Form: Entry Type Figur

Page 96

Modifying Search Attributes for Advanced Searches72 Red Hat Directory Server Gateway Customization Guide • April 2005Figure 6-4 Advanced Search Form:

Page 97

Modifying Search Attributes for Advanced SearchesChapter 6 Search Attributes, Filters, and Results 73The third column contains a string of six bits. E

Page 98

Adding Search Support for a New Object74 Red Hat Directory Server Gateway Customization Guide • April 2005"dsgw-people"subtree"full nam

Page 99 - Gateway Directives

Adding Search Support for a New ObjectChapter 6 Search Attributes, Filters, and Results 75People"""Search for":"(&(object

Page 100 - Structure of an HTML Template

7Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Page 101 - Context-Related Directives

Modifying Default Search Filters76 Red Hat Directory Server Gateway Customization Guide • April 2005not-used-by-dsgwnot-used-by-dsgwsubtree"name&

Page 102 - Entry-Related Directives

Modifying Default Search FiltersChapter 6 Search Attributes, Filters, and Results 77• Search Filters for User Data Patterns• Specifying a Search Filte

Page 103 - Table B-3

Customizing Search Result Templates78 Red Hat Directory Server Gateway Customization Guide • April 2005Customizing Search Result TemplatesThe followin

Page 104

Customizing Search Result TemplatesChapter 6 Search Attributes, Filters, and Results 79Figure 6-5 Search Results Table 6-3 lists the default gateway s

Page 105

Customizing Search Result Templates80 Red Hat Directory Server Gateway Customization Guide • April 2005A new search result template is required for ea

Page 106 - DS_VIEW_SWITCHER

Customizing Search Result TemplatesChapter 6 Search Attributes, Filters, and Results 81<!-- DS_ATTRIBUTE "attr=title" --></TD>&l

Page 107 - DS_SEARCHDESC

Customizing Search Result Templates82 Red Hat Directory Server Gateway Customization Guide • April 2005

Page 108 - DS_SAVEBUTTON

83Chapter 7Customizing Graphics and ColorThis chapter describes how to change the appearance of default gateway forms. The chapter contains the follow

Page 109 - DS_CONFIRM_NEWPASSWORD

Button Images84 Red Hat Directory Server Gateway Customization Guide • April 2005Updating the Banner Image (title.gif)The following sections describe

Page 110 - DS_BEGIN_ENTRYFORM

Button ImagesChapter 7 Customizing Graphics and Color 85Updating Button ImagesThe default button images have a height of 24 pixels and a width of 122

Page 111 - DS_BEGIN_DNSEARCHFORM

8 Red Hat Directory Server Gateway Customization Guide • April 2005Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Page 112 - IF/ ELSE/ ELIF/ ENDIF

Color Schemes86 Red Hat Directory Server Gateway Customization Guide • April 2005Color SchemesChanging the color schemes for a form requires editing t

Page 113 - Examples

Color SchemesChapter 7 Customizing Graphics and Color 87Changing Colors Using BODY TagTable 7-3 lists the five standard color attributes that can be c

Page 114 - Miscellaneous Directives

Changing Table Colors88 Red Hat Directory Server Gateway Customization Guide • April 2005In the example, the attribute is a standard HTML %color attri

Page 115 - INCLUDECONFIG

Changing Table ColorsChapter 7 Customizing Graphics and Color 89Changing Color of Table HeadingsTo change the color of table heading text, edit the fo

Page 116 - DS_LOCATIONPOPUP

Changing Table Colors90 Red Hat Directory Server Gateway Customization Guide • April 2005

Page 117 - DS_GATEWAY_VERSION

91Appendix AParameters Defined in the .conf FileThe dsgw.conf and pb.conf files are installed during Red Hat Directory Server (Directory Server) insta

Page 118

baseurl92 Red Hat Directory Server Gateway Customization Guide • April 2005baseurlSpecifies the host name and port number used to contact the Director

Page 119

changeHTMLAppendix A Parameters Defined in the .conf File 93Formatbinddnfile binddn_filenameExamplebinddnfile /export/TEST/binddnfilechangeHTMLUsed by

Page 120 - (GETs only. No POSTs.)

configdir94 Red Hat Directory Server Gateway Customization Guide • April 2005More information: “ignoreAcceptCharsetFrom,” on page 97Formatcharset char

Page 121 - Appendix C CGI Usage 129

enable-aim-presenceAppendix A Parameters Defined in the .conf File 95Exampledirmgr "cn=Directory Manager, o=example.com"For information on t

Page 122

9Arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Page 123

gwnametrans96 Red Hat Directory Server Gateway Customization Guide • April 2005,<!-- DS_ATTRIBUTE "attr=nsaimstatustext" "options=qu

Page 124

htmldirAppendix A Parameters Defined in the .conf File 97htmldirSpecifies the location of the HTML files for the gateway. These include the HTML files

Page 125 - Index 133

location98 Red Hat Directory Server Gateway Customization Guide • April 2005locationDefines the location choices selectable from the gateway when addi

Page 126

location-suffixAppendix A Parameters Defined in the .conf File 99location-suffixIdentifies the directory suffix used to create new entries in the dire

Page 127 - Index 135

NLS100 Red Hat Directory Server Gateway Customization Guide • April 2005rdnattr. The attribute used to name entries of this type. For example, the def

Page 128

securitypathAppendix A Parameters Defined in the .conf File 101The orgchart-attrib-farleft-rdn attribute is the same as the one included in the Org Ch

Page 129 - List of Tables

url-orgchart-base102 Red Hat Directory Server Gateway Customization Guide • April 2005template orgperson person inetorgpersonurl-orgchart-basePoints t

Page 130

vcard-propertyAppendix A Parameters Defined in the .conf File 103Formatvcard-property vcardprop syntax ldapattr [ldapattr2...]vcardprop. The name of a

Page 131

vcard-property104 Red Hat Directory Server Gateway Customization Guide • April 2005syntax. A string that describes the nature of the vCard information

Page 132

107Appendix BGateway DirectivesThis appendix describes directives used in gateway HTML object class and search result templates. The appendix contains

Commentaires sur ces manuels

Pas de commentaire