IBM Tivoli Directory Server verze 5.2 soubor README klienta
GI11-2929-00
IBM Tivoli Directory Server verze 5.2 soubor README klienta
GI11-2929-00
Poznámka Než použijete tyto informace a odpovídající produkt, přečtěte si všeobecné informace uvedené v sekci “Poznámky”, na stránce 7.
Úvod Tento soubor README obsahuje popis sady SDK klienta IBM Tivoli Directory Server verze 5.2. Tato sada SDK (Software Developer Kit) poskytuje podporu pro vývoj aplikací LDAP v následujících operačních systémech: v Windows NT 4.0 s opravou Service Pack 6 nebo vyšší, Windows 2000, Windows XP nebo Windows Server 2003 Standard nebo Enterprise v AIX 4.3.3, 5.1 nebo 5.2 v Systémy Linux na platformě xSeries: Red Hat Enterprise Linux 3.0, UnitedLinux 1.0, SuSE Linux Enterprise Server 8 v Systémy Linux na platformě S/390: Red Hat Advanced Server 3.0, UnitedLinux 1.0, SuSE Linux Enterprise Server 8 v Systémy Linux na platformách iSeries a pSeries: Red Hat Advanced Server 3.0, UnitedLinux 1.0, SuSE Linux Enterprise Server 8 v Solaris 7, 8 nebo 9 v HP-UX 11 nebo 11i
© Copyright IBM Corp. 2003
iii
iv
IBM Tivoli Directory Server verze 5.2 - soubor README klienta
Obsah Úvod . . . . . . . . . . . . . . . . iii
Informace o zabezpečení služeb LDAP (pomocí zabezpečení SSL a TLS) . . . . 5
Popis produktu. . . . . . . . . . . . 1 Aplikace jazyka C .
.
.
.
.
.
.
.
.
.
.
.
. 2
Dodatek. Poznámky . . . . . . . . . . 7 Ochranné známky .
.
.
.
.
.
.
.
.
.
.
.
. 9
Elektronická dokumentace . . . . . . . 3
© Copyright IBM Corp. 2003
v
vi
IBM Tivoli Directory Server verze 5.2 - soubor README klienta
Popis produktu Sada SDK klienta IBM Tivoli Directory Server poskytuje nástroje potřebné pro vývoj aplikací LDAP. K dispozici jsou následující položky: v Knihovny klienta poskytující sadu rozhraní API pro jazyk C v Soubory hlaviček jazyka C pro sestavení a kompilaci aplikací LDAP v Dokumentace popisující programové rozhraní a ukázkové programy v Ukázkové programy ve zdrojovém tvaru v Spustitelné verze ukázkových programů: – ldapmodrdn.exe: úprava relativního DN LDAP – ldapdelete.exe: odstranění LDAP – ldapmodify.exe: úprava LDAP – ldapsearch.exe: hledání LDAP – ldapadd.exe: přidání LDAP (přejmenovaná verze ldapmodify) – ldapchangepwd.exe: změna hesla LDAP – ldapexop.exe: rozšířené operace LDAP Ukázkové programy se nacházejí v následujících adresářích: v AIX: /usr/ldap/examples v HP-UX: /usr/IBMldap/examples v Solaris: /opt/IBMldapc/examples v Linux: /usr/ldap/examples v Windows: ldaphome\examples U ukázkových programů je obsažen i soubor typu makefile pro kompilaci programů, a také ukázkový soubor LDIF. Knihovny LDAP C umožňují programátorům vytvářet aplikace, které mohou přistupovat k adresářovým serverům podporujícím protokol LDAP, mezi které mimo jiné patří: v IBM Tivoli Directory Server V5.2 v IBM Directory Server V4.1, V5.1 v IBM SecureWay Directory Server V3.2.2 v eNetwork LDAP Directory Server V2.1 v eNetwork X.500 Directory Server for AIX v Sun ONE Directory Server Rozhraní LDAP API poskytuje standardní funkce adresářového serveru, jako je čtení, zápis a vyhledávání. Klient může ověřit sám sebe na adresářovém serveru prostřednictvím jednoduchého ověření LDAP, při kterém se používá heslo a jednoznačný název (DN). Klienta lze ověřit také pomocí některého z mechanizmů zabezpečení SASL (CRAM-MD5, DIGEST-MD5, GSSAPI nebo EXTERNAL).
© Copyright IBM Corp. 2003
1
Aplikace jazyka C Sada SDK klienta obsahuje nástroje pro vytvoření vlastní aplikace LDAP (LDAP verze 2 nebo LDAP verze 3). Sada SDK klienta pro jazyk C také poskytuje podporu zabezpečení Secure Sockets Layer (SSL) a TLS (Transport Layer Security), které zajišťují zabezpečení dat šifrováním pro připojení chráněná zabezpečením SSL a TLS. Podpora SSL se zapne po instalaci balíku IBM Global Security Kit, verze 7a (GSKit). Nástroj GSKit je nepovinný software, který je obsažen v balíku produktu IBM Tivoli Directory Server. Poznámka: Důležité informace o použití podpory SSL s verzí 5.2 sady SDK klienta IBM Tivoli Directory Server najdete v oddílu “Informace o zabezpečení služeb LDAP (pomocí zabezpečení SSL a TLS)” na stránce 5.
2
IBM Tivoli Directory Server verze 5.2 - soubor README klienta
Elektronická dokumentace Kromě souboru README jsou ve formátu PDF a HTML dodávány elektronické dokumenty včetně příručky Administration Guide a příručky Programming Reference. Produkt IBM Tivoli Directory Server verze 5.2 podporuje použití klienta JNDI (Java Naming and Directory Interface) společnosti Sun Microsystems. Informace o klientovi JNDI naleznete na webové stránce společnosti Sun Microsystems na adrese http://java.sun.com/products/jndi/1.2/index.html. Poznámka: Chcete-li zobrazit nebo vytisknout dokumentaci ve formátu PDF, můžete si bezplatně stáhnout kopii produktu Adobe Acrobat Reader z webové stránky společnosti Adobe na adrese http://adobe.com. Pro systémy Windows: Příručka Administration Guide file:\instalační adresář\doc\jazyk\admin_gd.pdf nebo admin_gd.htm Příručka C-Client SDK Programming Reference file:\instalační adresář\doc\jazyk\progref.pdf nebo progref.htm Pro systémy AIX: Příručka Administration Guide file:/usr/ldap/doc/jazyk/admin_gd.pdf nebo admin_gd.htm Příručka C-Client SDK Programming Reference file:/usr/ldap/doc/jazyk/progref.pdf nebo progref.htm Pro systémy Linux: Příručka Administration Guide file:/usr/ldap/doc/jazyk/admin_gd.pdf nebo admin_gd.htm Příručka C-Client SDK Programming Reference file:/usr/ldap/doc/jazyk/progref.pdf nebo progref.htm Pro systémy Solaris: Příručka Administration Guide file:/opt/IBMldaps/doc/jazyk/admin_gd.pdf nebo admin_gd.htm Příručka C-Client SDK Programming Reference file:/opt/IBMldaps/doc/jazyk/progref.pdf nebo progref.htm Pro systémy HP-UX: Příručka Administration Guide file:/usr/IBMldap/doc/jazyk/admin_gd.pdf nebo admin_gd.htm Příručka C-Client SDK Programming Reference file:/usr/IBMldap/doc/jazyk/progref.pdf nebo progref.htm Všechny publikace pro tento produkt jsou k dispozici v síti Internet ve formátu PDF (Portable Document Format) nebo HTML (Hypertext Markup Language), případně v obou formátech v knihovně softwaru Tivoli: http://www.ibm.com/software/tivoli/library.
© Copyright IBM Corp. 2003
3
4
IBM Tivoli Directory Server verze 5.2 - soubor README klienta
Informace o zabezpečení služeb LDAP (pomocí zabezpečení SSL a TLS) Má-li být podporováno zabezpečení SSL, vyžaduje verze 5.2 sady SDK klienta, aby byl instalován balík GSKit 7a. Knihovny a pomocné programy LDAP poskytované sadou SDK klienta využívají knihoven SSL (jsou-li přítomny). Knihovny SSL jsou dodávány jako součást balíku IBM GSKit 7a. Byl-li balík GSKit instalován, knihovna LDAP dynamicky zavede knihovny SSL a použije je k zajištění podpory zabezpečených připojení. Pokud balík GSKit instalován nebyl, knihovny SSL nejsou k dispozici a knihovna LDAP je plně funkční s výjimkou podpory SSL. Při použití vrstvy SSL s ověřováním serveru mohou aplikace LDAP použít jednoduché ověřování LDAP (jméno uživatele a heslo) na zabezpečeném, šifrovaném připojení. Vrstva SSL pak zajišťuje ustavení bezpečného připojení mezi klientskou aplikací LDAP a serverem LDAP. Vrstva SSL navíc poskytuje zabezpečení dat šifrováním na připojeních chráněných pomocí SSL. Ověření serverů vzhledem ke klientům je zajištěno pomocí certifikátů X.509. Poznámka: Komponenta serveru IBM Tivoli Directory Server používá pro zajištění podpory SSL také balík GSKit. Bližší informace o balíku GSKit najdete v příručkách IBM Tivoli Directory Server Version 5.2 C-Client SDK Programming Reference a IBM Tivoli Directory Server verze 5.2 - Instalační a konfigurační příručka.
© Copyright IBM Corp. 2003
5
6
IBM Tivoli Directory Server verze 5.2 - soubor README klienta
Dodatek. Poznámky Tyto informace byly vytvořeny pro produkty a služby nabízené v USA. Společnost IBM nemusí produkty, služby nebo funkce uvedené v tomto dokumentu nabízet ve jiných zemích. Informace o produktech a službách, které jsou ve vaší oblasti aktuálně dostupné, získáte od místního zástupce společnosti IBM. Odkazy na produkty, programy nebo služby společnosti IBM v této publikaci nejsou míněny jako vyjádření nutnosti použití pouze uvedených produktů, programů či služeb společnosti IBM. Místo produktu, programu nebo služby společnosti IBM lze použít libovolný funkčně ekvivalentní produkt, program nebo službu, která neporušuje intelektuální vlastnická práva společnosti IBM. Ověření funkčnosti produktu, programu nebo služby pocházející od jiného výrobce je však povinností uživatele. K jednotlivým subjektům popisovaným v tomto dokumentu se mohou vztahovat patenty nebo nevyřízené patentové přihlášky společnosti IBM. Vlastnictví tohoto dokumentu uživateli neposkytuje žádná licenční práva k těmto patentům. Dotazy týkající se licencí můžete posílat písemně na adresu: IBM Director of Licensing IBM Corporation North Castle Drive Armonk, NY 10504-1785 USA Odpovědi na dotazy týkající se licencí pro dvoubajtové znakové sady (DBCS) získáte od oddělení IBM Intellectual Property Department ve vaší zemi, nebo tyto dotazy můžete zasílat písemně na adresu: IBM World Trade Asia Corporation Licensing 2-31 Roppongi 3-chome, Minato-ku Tokyo 106, Japonsko Následující odstavec se netýká Spojeného království ani jiných zemí, ve kterých je takovéto vyjádření v rozporu s místními zákony: SPOLEČNOST INTERNATIONAL BUSINESS MACHINES CORPORATION TUTO PUBLIKACI POSKYTUJE “TAK, JAK JE” BEZ JAKÉKOLI ZÁRUKY, AŤ UŽ PŘÍMÉ ČI ODVOZENÉ, VČETNĚ, ALE NE VÝHRADNĚ, ODVOZENÝCH ZÁRUK TÝKAJÍCÍCH SE PORUŠOVÁNÍ ZÁKONŮ, PRODEJNOSTI ČI VHODNOSTI K URČITÉMU ÚČELU. V některých státech nejsou prohlášení týkající se přímých či odvozených záruk v určitých případech dovolena, a proto se vás toto prohlášení nemusí týkat. Uvedené údaje mohou obsahovat technické nepřesnosti nebo typografické chyby. Údaje zde uvedené jsou pravidelně upravovány a tyto změny budou zahrnuty v nových vydáních této publikace. Společnost IBM může kdykoli bez upozornění provádět vylepšení nebo změny v produktech či programech popsaných v této publikaci. Veškeré uvedené odkazy na stránky WWW, které nespravuje společnost IBM, jsou uváděny pouze pro referenci a v žádném případě neslouží jako záruka funkčnosti těchto stránek. Materiály uvedené na těchto stránkách WWW nejsou součástí materiálů pro tento produkt IBM a použití uvedených stránek je pouze na vlastní nebezpečí. Společnost IBM může použít nebo distribuovat jakékoli informace, které jí sdělíte, libovolným způsobem, který společnost považuje za odpovídající, bez vyžádání vašeho svolení.
© Copyright IBM Corp. 2003
7
Vlastníci licence k tomuto programu, kteří chtějí získat informace o možnostech (i) výměny informací s nezávisle vytvořenými programy a jinými programy (včetně tohoto) a (ii) oboustranného využití vyměňovaných informací, mohou kontaktovat informační středisko na adrese: IBM Corporation Department MU5A46 11301 Burnet Road Austin, TX 78758 USA Poskytnutí takových informací může být podmíněno dodržením určitých podmínek a požadavků zahrnujících v některých případech uhrazení stanoveného poplatku. Licencovaný program popsaný v tomto dokumentu a veškerý licencovaný materiál k němu dostupný jsou společností IBM poskytovány na základě podmínek uvedených ve smlouvách IBM Customer Agreement, IBM International Program License Agreement nebo v jiné ekvivalentní smlouvě. Jakékoli údaje o výkonnosti obsažené v této publikaci byly zjištěny v řízeném prostředí. Výsledky získané v jakémkoli jiném operačním prostředí se proto mohou výrazně lišit. Některá měření mohla být prováděna na vývojových verzích systémů a není zaručeno, že tato měření budou stejná i na běžně dostupných systémech. Některé údaje mohly být navíc zjištěny pomocí extrapolace. Skutečné výsledky mohou být jiné. Čtenáři tohoto dokumentu by měli zjistit použitelné údaje pro své specifické prostředí. Informace týkající se produktů jiných výrobců pocházejí od dodavatelů těchto produktů, z jejich veřejných oznámení nebo z jiných veřejně dostupných zdrojů. Společnost IBM tyto produkty netestovala a nemůže potvrdit jejich správnou výkonnost, kompatibilitu ani žádné jiné výroky týkající se produktů jiných výrobců než IBM. Otázky týkající se kompatibility produktů jiných výrobců by měly být směrovány dodavatelům těchto produktů. Tyto informace obsahují ukázky dat a sestav používaných při běžných obchodních operacích. Aby bylo možné ilustrovat je v co nejúplnější formě, jsou v ukázkách uvedena jména osob, společností, značek a produktů. Všechna tato jména jsou smyšlená a jakákoli podobnost se jmény a adresami používanými v podnikání je čistě náhodná. LICENCE - COPYRIGHT: Tyto informace obsahují ukázky aplikačních jazyků ve zdrojovém tvaru ilustrující techniky programování na různých platformách. Tyto ukázkové programy můžete kopírovat, upravovat a šířit v libovolné formě bez nutnosti úhrady společnosti IBM za účelem vývoje, použití, propagace nebo šíření aplikačních programů odpovídajících rozhraní API pro platformu, pro kterou jsou ukázkové programy psány. Tyto ukázky nebyly důkladně testovány za všech podmínek. Společnost IBM tedy nemůže zaručit ani vyvozovat spolehlivost, použitelnost ani funkčnost těchto programů. Tyto ukázkové programy můžete kopírovat, upravovat a šířit v libovolné formě bez nutnosti úhrady společnosti IBM za účelem vývoje, použití, propagace nebo šíření aplikačních programů odpovídajících rozhraním API společnosti IBM. Každá kopie a každá část těchto ukázkových programů a všech odvozených děl musí obsahovat následující upozornění týkající se copyrightu: © (název vaší společnosti) (rok). Části tohoto kódu jsou odvozeny z ukázkových programů společnosti IBM. © Copyright IBM Corp. _zadejte rok nebo roky_. Veškerá práva vyhrazena. Pokud si tyto informace prohlížíte v elektronické formě, může se stát, že se fotografie a barevné ilustrace nezobrazí.
8
IBM Tivoli Directory Server verze 5.2 - soubor README klienta
Ochranné známky Následující názvy jsou ochrannými známkami společnosti International Business Machines Corporation v USA anebo v jiných zemích: v AIX v IBM v iSeries v pSeries v v v v
S/390 SecureWay Tivoli xSeries
Java a všechny obchodní známky a loga odvozené od Java jsou ochrannými známkami nebo registrovanými ochrannými známkami společnosti Sun Microsystems, Inc. v USA anebo v jiných zemích. Microsoft, Windows a Windows NT jsou registrované ochranné známky společnosti Microsoft Corporation. UNIX je registrovaná ochranná známka společnosti Open Group. Jiné názvy společností, výrobků a služeb mohou být ochrannými známkami nebo značkami služeb jiných společností.
Dodatek. Poznámky
9
10
IBM Tivoli Directory Server verze 5.2 - soubor README klienta
Vytištěno v Dánsku společností IBM Danmark A/S.
GI11-2929-00