Plik Readme klienta IBM Tivoli Directory Server wersja 5.2

Transkrypt

1 Plik Readme klienta IBM Tivoli Directory Server wersja 5.2 GI

2

3 Plik Readme klienta IBM Tivoli Directory Server wersja 5.2 GI

4 Uwaga Przed korzystaniem z tych informacji oraz z produktu, którego dotyczą, należy przeczytać informacje ogólne znajdujące się w sekcji Uwagi, na stronie 7.

5 Wstęp Ten plik Readme zawiera opis pakietu SDK klienta IBM Tivoli Directory Server wersja 5.2. Dzięki pakietowi SDK możliwe jest tworzenie aplikacji wykorzystujących protokół LDAP w następujących systemach operacyjnych: v Windows NT 4.0 z pakietem serwisowym Service Pack 6 lub nowszym, Windows 2000, Windows XP oraz Windows Server 2003 Standard lub Enterprise v AIX 4.3.3, 5.1 lub 5.2 v xseries Linux: Red Hat Enterprise Linux 3.0, UnitedLinux 1.0, SuSE Linux Enterprise Server 8 v Linux dla S/390: Red Hat Advanced Server 3.0, UnitedLinux 1.0, SuSE Linux Enterprise Server 8 v iseries i pseries Linux: Red Hat Advanced Server 3.0, UnitedLinux 1.0, SuSE Linux Enterprise Server 8 v Solaris 7, 8 lub 9 v HP-UX 11 lub 11i Copyright IBM Corp iii

6 iv Plik Readme klienta IBM Tivoli Directory Server wersja 5.2

7 Spis treści Wstęp iii Opis produktu Aplikacje w języku C Dokumentacja w postaci elektronicznej 3 Uwagi dotyczące ochrony LDAP (przy użyciu protokołu SSL i TLS) Dodatek. Uwagi Znaki towarowe Copyright IBM Corp v

8 vi Plik Readme klienta IBM Tivoli Directory Server wersja 5.2

9 Opis produktu Pakiet SDK klienta IBM Tivoli Directory Server zawiera narzędzia niezbędne do tworzenia aplikacji LDAP. Dostępne są następujące elementy: v biblioteki klienta udostępniające funkcje API języka C, v pliki nagłówkowe C do tworzenia i kompilowania aplikacji LDAP, v dokumentacja zawierająca opis interfejsu API i przykładowe programy, v przykładowe programy w postaci kodu źródłowego, v wersje wykonywalne przykładowych programów: ldapmodrdn.exe: modyfikacja względnych nazw wyróżniających ldapdelete.exe: kasowanie ldapmodify.exe: modyfikacja ldapsearch.exe: wyszukiwanie ldapadd.exe: dodawanie (ldapmodify ze zmienioną nazwą) ldapchangepwd.exe: zmiana hasła ldapexop.exe: operacje rozszerzone Programy przykładowe znajdują się w następujących katalogach: 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 Dla każdego przykładowego programu dostarczony jest plik Makefile wraz z przykładowym plikiem LDIF. Biblioteki LDAP języka C umożliwiają programiście tworzenie aplikacji, które mogą uzyskiwać dostęp do serwera katalogów zgodnego z LDAP, włączając w to m.in. następujące produkty: v IBM Tivoli Directory Server wersja 5.2 v IBM Directory Server wersja 4.1 i wersja 5.1 v IBM SecureWay Directory Server V3.2.2 v enetwork LDAP Directory Server wersja 2.1 v enetwork X.500 Directory Server for AIX v Sun ONE Directory Server Interfejs API LDAP udostępnia typowe funkcje serwera katalogów, takie jak odczyt, zapis i przeszukiwanie. Klient może się samodzielnie uwierzytelnić na serwerze katalogów poprzez proste LDAP Authentication, które używa hasła i nazwy wyróżniającej. Klient może zostać uwierzytelniony również przy użyciu jednego z mechanizmów Simple Authentication and Security Layer (SASL) (CRAM-MD5, DIGEST-MD5, GSSAPI lub EXTERNAL). Copyright IBM Corp

10 Aplikacje w języku C Pakiet SDK klienta zawiera narzędzia do tworzenia aplikacji LDAP (w wersji 2 lub 3). Należy zauważyć, że pakiet SDK klienta dla języka C umożliwia również obsługę protokołu SSL (Secure Sockets Layer) oraz TSL (Transport Layer Security), które zapewniają poufność danych (szyfrowanie) w połączeniach chronionych przez protokół SSL i TLS. Obsługa SSL jest aktywna, gdy zainstalowany jest pakiet IBM Global Security Kit (GSKit) wersja 7a. Pakiet GSKit jest oprogramowaniem opcjonalnym, dołączonym do produktu IBM Tivoli Directory Server. Uwaga: Sekcja Uwagi dotyczące ochrony LDAP (przy użyciu protokołu SSL i TLS) na stronie 5 zawiera istotne informacje szczegółowe dotyczące używania SSL z pakietem SDK klienta IBM Tivoli Directory Server wersja Plik Readme klienta IBM Tivoli Directory Server wersja 5.2

11 Dokumentacja w postaci elektronicznej Poza plikiem Readme w postaci elektronicznej (jako pliki w formacie PDF i HTML) dostarczane są m.in. podręcznik administrowania oraz podręcznik programowania. IBM Tivoli Directory Server wersja 5.2 obsługuje korzystanie z klienta JNDI (Java Naming and Directory Interface) firmy Sun Microsystems. Informacje na temat klienta JNDI znajdują się w serwisie WWW firmy Sun Microsystems Uwaga: Aby wyświetlić lub wydrukować dokumentację PDF, można pobrać darmową kopię programu Adobe Acrobat Reader z serwisu WWW firmy Adobe dostępnego pod adresem W systemach Windows: Podręcznik administrowania file:\katalog instalacyjny\doc\język\admin_gd.pdf lub admin_gd.htm Podręcznik programowania w języku C pakietu SDK klienta file:\katalog instalacyjny\doc\język\progref.pdf lub progref.htm W systemach AIX: Podręcznik administrowania file:/usr/ldap/doc/język/admin_gd.pdf lub admin_gd.htm Podręcznik programowania w języku C pakietu SDK klienta file:/usr/ldap/doc/język/progref.pdf lub progref.htm W systemach Linux: Podręcznik administrowania file:/usr/ldap/doc/język/admin_gd.pdf lub admin_gd.htm Podręcznik programowania w języku C pakietu SDK klienta file:/usr/ldap/doc/język/progref.pdf lub progref.htm W systemach Solaris: Podręcznik administrowania file:/opt/ibmldaps/doc/język/admin_gd.pdf lub admin_gd.htm Podręcznik programowania w języku C pakietu SDK klienta file:/opt/ibmldaps/doc/język/progref.pdf lub progref.htm W systemach HP-UX: Podręcznik administrowania file:/usr/ibmldap/doc/język/admin_gd.pdf lub admin_gd.htm Podręcznik programowania w języku C pakietu SDK klienta file:/usr/ibmldap/doc/język/progref.pdf lub progref.htm Wszystkie publikacje dotyczące niniejszego produktu dostępne są w Internecie w formacie PDF (Portable Document Format) lub HTML (Hypertext Markup Language) w bibliotece oprogramowania Tivoli pod adresem: Copyright IBM Corp

12 4 Plik Readme klienta IBM Tivoli Directory Server wersja 5.2

13 Uwagi dotyczące ochrony LDAP (przy użyciu protokołu SSL i TLS) Wersja 5.2 pakietu SDK klienta wymaga do obsługi protokołu SSL zainstalowania pakietu GSKit w wersji 7a. Narzędzia i biblioteki LDAP dostarczane wraz z SDK klienta mogą wykorzystywać biblioteki SSL, jeśli są one zainstalowane. Biblioteki SSL stanowią część pakietu IBM GSKit 7a. Jeśli zainstalowano pakiet GSKit, biblioteka LDAP dynamicznie ładuje biblioteki SSL i używa ich w celu włączenia obsługi dla połączeń chronionych. Jeśli pakiet GSKit nie jest zainstalowany i biblioteki SSL nie są dostępne, biblioteka LDAP jest w pełni funkcjonalna za wyjątkiem obsługi SSL. Dzięki SSL aplikacje LDAP mogą używać prostego uwierzytelniania w serwerze (podanie identyfikatora użytkownika i hasła) przez bezpieczny, zaszyfrowany kanał komunikacyjny. Tak więc SSL zapewnia możliwość uzyskania bezpiecznego połączenia między aplikacją kliencką LDAP i serwerem LDAP. Dodatkowo zapewniana jest poufność danych (szyfrowanie) w połączeniach chronionych przez SSL. Uwierzytelnianie serwerów przez klientów jest realizowane za pomocą certyfikatów X.509. Uwaga: Serwer IBM Tivoli Directory Server także wykorzystuje pakiet GSKit do obsługi protokołu SSL. Informacje na temat pakietu GSKit można znaleźć w podręcznikach: IBM Tivoli Directory Server Version 5.2 C-Client SDK Programming Reference oraz IBM Tivoli Directory Server wersja 5.2: Podręcznik instalacji i konfiguracji. Copyright IBM Corp

14 6 Plik Readme klienta IBM Tivoli Directory Server wersja 5.2

15 Dodatek. Uwagi Niniejsza publikacja została przygotowana z myślą o produktach i usługach oferowanych w Stanach Zjednoczonych. IBM może nie oferować w innych krajach produktów, usług lub opcji omawianych w tej publikacji. Informacje o produktach i usługach dostępnych w danym kraju można uzyskać od lokalnego przedstawiciela IBM. Odwołanie do produktu, programu lub usługi IBM nie oznacza, że można użyć wyłącznie tego produktu, programu lub usługi IBM. Zamiast nich można zastosować ich odpowiednik funkcjonalny, pod warunkiem, że nie narusza to praw własności intelektualnej IBM. Jednakże cała odpowiedzialność za ocenę przydatności i sprawdzenie działania produktu, programu lub usługi pochodzących od producenta innego niż IBM spoczywa na użytkowniku. IBM może posiadać patenty lub złożone wnioski patentowe na towary i usługi, o których mowa w niniejszej publikacji. Przedstawienie niniejszej publikacji nie daje żadnych uprawnień licencyjnych do tychże patentów. Pisemne zapytania w sprawie licencji można przesyłać na adres: IBM Director of Licensing IBM Corporation North Castle Drive Armonk, NY U.S.A. Zapytania w sprawie licencji na informacje dotyczące zestawów znaków dwubajtowych (DBCS) należy kierować do lokalnych działów własności intelektualnej IBM (IBM Intellectual Property Department) lub zgłaszać na piśmie pod adresem: IBM World Trade Asia Corporation Licensing 2-31 Roppongi 3-chome, Minato-ku Tokyo 106, Japan Poniższy akapit nie obowiązuje w Wielkiej Brytanii a także w innych krajach, w których jego treść pozostaje w sprzeczności z przepisami prawa miejscowego: INTERNATIONAL BUSINESS MACHINES CORPORATION DOSTARCZA TĘ PUBLIKACJĘ W STANIE, W JAKIM SIĘ ZNAJDUJE ( AS IS ), BEZ UDZIELANIA JAKICHKOLWIEK GWARANCJI (W TYM TAKŻE RĘKOJMI), WYRAŹNYCH LUB DOMNIEMANYCH, A W SZCZEGÓLNOŚCI DOMNIEMANYCH GWARANCJI PRZYDATNOŚCI HANDLOWEJ ORAZ PRZYDATNOŚCI DO OKREŚLONEGO CELU LUB GWARANCJI, ŻE PUBLIKACJA TA NIE NARUSZA PRAW OSÓB TRZECICH. Ustawodawstwa niektórych krajów nie dopuszczają zastrzeżeń dotyczących gwarancji wyraźnych lub domniemanych w odniesieniu do pewnych transakcji; w takiej sytuacji powyższe zdanie nie ma zastosowania. Informacje zawarte w niniejszej publikacji mogą zawierać nieścisłości techniczne lub błędy typograficzne. Informacje te są okresowo aktualizowane, a zmiany te zostaną ujęte w kolejnych wydaniach tej publikacji. IBM zastrzega sobie prawo do wprowadzania ulepszeń i/lub zmian w produktach i/lub programach opisanych w tej publikacji w dowolnym czasie, bez wcześniejszego powiadomienia. Wszelkie wzmianki w tej publikacji na temat stron internetowych innych firm zostały wprowadzone wyłącznie dla wygody użytkowników i w żadnym wypadku nie stanowią zachęty do ich odwiedzania. Materiały dostępne na tych stronach nie są częścią materiałów opracowanych do tego produktu IBM, a użytkownik korzysta z nich na własną odpowiedzialność. Copyright IBM Corp

16 IBM ma prawo do używania i rozpowszechniania informacji przysłanych przez użytkownika w dowolny sposób, jaki uzna za właściwy, bez żadnych zobowiązań wobec ich autora. Licencjobiorcy tego programu, którzy chcieliby uzyskać informacje na temat programu w celu: (i) wdrożenia wymiany informacji między niezależnie utworzonymi programami i innymi programami (łącznie z tym opisywanym) oraz (ii) wykorzystywania wymienianych informacji, powinni skontaktować się z: IBM Corporation Department MU5A Burnet Road Austin, TX U.S.A. Informacje takie mogą być udostępnione, o ile spełnione zostaną odpowiednie warunki, w tym, w niektórych przypadkach, uiszczenie odpowiedniej opłaty. Licencjonowany program opisany w tej publikacji i wszystkie inne licencjonowane materiały dostępne dla tego programu są dostarczane przez IBM na warunkach określonych w Umowie IBM z Klientem, Międzynarodowej Umowie Licencyjnej IBM na Program lub w innych podobnych umowach zawartych między IBM i użytkownikami. Wszelkie dane dotyczące wydajności zostały zebrane w kontrolowanym środowisku. W związku z tym rezultaty uzyskane w innych środowiskach operacyjnych mogą się znacząco różnić. Niektóre pomiary mogły być dokonywane na systemach będących w fazie rozwoju i nie ma gwarancji, że pomiary te wykonane na ogólnie dostępnych systemach dadzą takie same wyniki. Niektóre z pomiarów mogły być estymowane przez ekstrapolację. Rzeczywiste wyniki mogą być inne. Użytkownicy powinni we własnym zakresie sprawdzić odpowiednie dane dla ich środowiska. Informacje dotyczące produktów innych firm pochodzą od dostawców tych produktów, z opublikowanych przez nich zapowiedzi lub innych powszechnie dostępnych źródeł. Firma IBM nie testowała tych produktów i nie może potwierdzić dokładności pomiarów wydajności, kompatybilności ani żadnych innych danych związanych z tymi produktami. Pytania dotyczące produktów firm innych niż IBM należy kierować do dostawców tych produktów. Niniejsze informacje zawierają przykłady danych i raportów używanych w codziennych czynnościach służbowych. W celu możliwie najpełniejszej ich ilustracji w przykładach tych używane są nazwiska osób, nazwy firm, marki i nazwy produktów. Wszystkie te nazwy są fikcyjne i jakiekolwiek ich podobieństwo do nazwisk, nazw i adresów używanych w rzeczywistych przedsiębiorstwach jest całkowicie przypadkowe. LICENCJA NA PRAWA AUTORSKIE: Niniejsze informacje zawierają przykładowe aplikacje w postaci kodu źródłowego, ilustrujące techniki programowania w różnych systemach operacyjnych. Użytkownik może kopiować, modyfikować i dystrybuować te programy przykładowe w dowolnej formie bez uiszczania opłat na rzecz IBM, w celu projektowania, używania, sprzedaży lub dystrybucji aplikacji zgodnych z aplikacyjnym interfejsem programowym dla tego systemu operacyjnego, dla którego napisane zostały programy przykładowe. Programy przykładowe nie zostały gruntownie przetestowane. IBM nie może zatem gwarantować ani sugerować niezawodności, użyteczności i funkcjonalności tych programów. Użytkownik może kopiować, modyfikować i dystrybuować te programy przykładowe w dowolnej formie bez uiszczania opłat na rzecz IBM, w celu projektowania, używania, sprzedaży lub dystrybucji aplikacji zgodnych z aplikacyjnym interfejsem programowym IBM. 8 Plik Readme klienta IBM Tivoli Directory Server wersja 5.2

17 Znaki towarowe Każda kopia programu przykładowego lub jakikolwiek jego fragment, jak też jakiekolwiek prace pochodne muszą zawierać następujące uwagi dotyczące praw autorskich: (nazwa przedsiębiorstwa użytkownika) (rok). Fragmenty niniejszego kodu pochodzą z IBM Corp. Programy przykładowe. Copyright IBM Corp. (wpisać rok lub lata). Wszelkie prawa zastrzeżone. W przypadku przeglądania niniejszych informacji w formie elektronicznej, zdjęcia i kolorowe ilustracje mogą nie być wyświetlane. Następujące nazwy są znakami towarowymi International Business Machines Corporation w Stanach Zjednoczonych i innych krajach: v v v v AIX IBM iseries pseries v S/390 v v v SecureWay Tivoli xseries Java i wszystkie oparte na Java znaki towarowe lub logo są znakami towarowymi lub zastrzeżonymi znakami towarowymi Sun Microsystems, Inc. w Stanach Zjednoczonych i innych krajach. Microsoft, Windows oraz Windows NT są zastrzeżonymi znakami towarowymi Microsoft Corporation. UNIX jest zastrzeżonym znakiem towarowym The Open Group. Nazwy innych firm, produktów i usług mogą być znakami towarowymi lub znakami usług innych podmiotów gospodarczych. Dodatek. Uwagi 9

18 10 Plik Readme klienta IBM Tivoli Directory Server wersja 5.2

19

20 Drukowane w USA GI