web500gw: Supported URL format
Syntax
- http://host[:port]/[ldaphost[:ldapport]/]DN[?[attrs][$flags][?[scope=filter]]
- host ::= the hostname or IP address of the host running web500gw
- port ::= the port number web500gw is listening at host
- ldaphost ::= the hostname or IP address of the LDAP server to contact
- port ::= the port number web500gw is listening at host
- -- if left empty a configured default LDAP server will be used
- ldapport ::= the portnumber of the LDAP server
- -- if left empty the LDAP default port 389 is used
- DN ::= a string as defined in RFC 1485
- -- The entry's LDAP Distinguished Name, escaped using % method.
- attrs ::= attr [, attrs]
- attr ::= NULL | a string as defined in RFC 1487
- -- Attribute list: what attributes should be displayed from the entry or the entries
- flags ::= flag [, flags]
- flags ::= NULL | table | btable | list | oneline | valsonly | entryonly | nodn | deref | lang=xx
- flags ::= NULL | table | btable | list | oneline | valsonly | entryonly | nodn | deref | lang=xx
- -- Flags: how the result should be formatted, options ... see below
- scope ::= O | S
- -- O = onelevel search, S = subtree search
- filter ::= a string as defined in RFC 1558
- -- Filter: Search specification
Description of flags
| Flag | Description |
| table | Show entries or search results as table |
| btable | Show entries or search results as bordered table |
| list | Show entries or search results as lists (<DL>) |
| oneline | More compact display: All values of one attribute on one line |
| valsonly | Show attribute values only, not attribute names |
| entryonly | Show entries or search results only, without page headers/trailers and navigation/search tools |
| nodn | Donīt show Distinguished names in search results |
| deref | Dereference alias entries during search |
| lang=xx | Use the language xx if available. xx is the two-letter language code like en for English or de for German. |
Examples
- /DN
- Display of an entry (attributes and flags server defined, with possible additional functions, e.g. list below nonleaf objects, modify button)
- / (empty DN)
- If option
rootishomeis set: show HOMEDN
If optionrootishomeis not set: show "X.500 root" - /DN?telephoneNumber
- Specified attribute of an entry
- /DN?$list
- Entry with all attributes (server defined) with special display flags
- /DN?vcard
- vCard for an entry
- /DN?telephoneNumber,mail,postalAddress$table
- Entry with user-defined attributes and display flags
- /DN??
- Search for all entries below DN, show result with server defined attributes and flags (Browse)
- /DN?description?
- Search for all entries below DN, show result with the specified attribute (flags server defined)
- /DN?$table?
- Search for all entries below DN, show result with display flags
- /DN?$btable,oneline?
- Another example (compact table with border)
- /DN?telephoneNumber,mail$btable,valsonly?
- Table of all entries with 2 attributes ("Telephone Book")
- /DN?jpegPhoto$btable,valsonly?S=(&(objectclass=person)(jpegPhoto=*))
- Search for all persons with JPEG Photo, displayed as a table
- /M
- Special URL: "Homepage"
Old go500gw like URL's
are supported if compiled withSUPPORT_OLD_URLS (see Makefile).
- /MDN
- Browse below DN
- /RDN
- Read an entry
- /SDN?S=filter
- Search below DN for filter
Availability
Features
Changes
Known Bugs
Links & References
Installation
Modes
Configuration:
web500gw.conf
Hints
vCards
Search interface
Adding entries
Examples:
web500gw.conf
ldaptemplates.conf
ldapfriendly
Support:
Y2K proof?
Mailing List
Troubleshooting
URL format
URLs in entries
LDAP errors
Developers
SF.net Project
Test it:
TU Chemnitz
TU Chemnitz CGI
Other sites