IBM Tivoli Directory Server 5.2 Client Readme - Fontos tudnivalók az ügyfélszoftverről
GI22-0055-00
IBM Tivoli Directory Server 5.2 Client Readme - Fontos tudnivalók az ügyfélszoftverről
GI22-0055-00
Megjegyzés Mielőtt az itt leírtakat és a terméket használná, olvassa el az általános tudnivalókat: “Megjegyzések”, oldalszám: 7.
Bevezető Ebben a fájlban az IBM Tivoli Directory Server Client SDK 5.2-es verziójának leírása található. Ez a szoftverfejlesztő készlet (SDK) az alábbi operációs rendszereken támogatja az LDAP alkalmazások fejlesztését: v Windows NT 4.0 Service Pack 6 vagy újabb javítókészlettel, Windows 2000, Windows XP, vagy Windows Server 2003 Standard vagy Enterprise. v AIX 4.3.3, 5.1 és 5.2 v xSeries Linuxon: Red Hat Enterprise Linux 3.0, UnitedLinux 1.0, SuSE Linux Enterprise Server 8 v Linux for S/390-en: Red Hat Advanced Server 3.0, UnitedLinux 1.0, SuSE Linux Enterprise Server 8 v iSeries és pSeries Linuxon: Red Hat Advanced Server 3.0, UnitedLinux 1.0, SuSE Linux Enterprise Server 8 v Solaris 7, 8 és 9 v HP-UX 11 vagy 11i
© Szerzői jog IBM 2003
iii
iv
IBM Tivoli Directory Server 5.2 Client Readme - Fontos tudnivalók az ügyfélszoftverről
Tartalom Bevezető . . . . . . . . . . . . . . iii
. Megjegyzések . . . . . . . . . . . . 7 Védjegyek
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 9
A termék leírása . . . . . . . . . . . 1 C nyelvű alkalmazások .
.
.
.
.
.
.
.
.
.
.
. 2
Online dokumentáció . . . . . . . . . 3 A biztonságos LDAP címtárral kapcsolatos szempontok (SSL és TLS használata) . . . . . . . . . . . . . 5
© Szerzői jog IBM 2003
v
vi
IBM Tivoli Directory Server 5.2 Client Readme - Fontos tudnivalók az ügyfélszoftverről
A termék leírása Az IBM Tivoli Directory Server Client SDK rendelkezik LDAP alkalmazások fejlesztésére alkalmas eszközökkel. Ezek az eszközök a következők: v C-nyelvű API-kat tartalmazó ügyfélkönyvtárak v C fejlécfájlok LDAP alkalmazások felépítéséhez és fordításához v A programozási felület és a mintaprogramok leírása v A mintaprogramok forráskódja v A mintaprogramok futtatható verziói: – ldapmodrdn.exe: LDAP viszonylagos megkülönböztető név módosítása – ldapdelete.exe: LDAP törlés – ldapmodify.exe: LDAP módosítás – ldapsearch.exe: LDAP keresés – ldapadd.exe: LDAP felvétel (az ldapmodify átnevezett verziója) – ldapchangepwd.exe: LDAP jelszóváltoztatás – ldapexop.exe: LDAP kiterjesztett műveletek A mintaprogramok a következő helyen találhatók: v AIX esetén: /usr/ldap/examples v HP-UX: /usr/IBMldap/examples v Solaris esetén: /opt/IBMldapc/examples v Linux: /usr/ldap/examples v Windows esetén: ldaphome\examples A minták mellett található egy, a mintaprogramokkal használatos előállítási fájl (makefile) és egy minta LDIF fájl. Az LDAP C könyvtárak lehetővé teszik a programozó számára olyan alkalmazások fejlesztését, amelyek hozzáférnek az LDAP-kompatibilis címtárakhoz, így a következőkhöz is: v IBM Tivoli Directory Server V5.2 v IBM Directory Server 4.1, 5.1 v IBM SecureWay Directory Server V3.2.2 v eNetwork LDAP Directory Server 2.1-es verzió v eNetwork X.500 Directory Server for AIX v Sun ONE Directory Server Az LDAP API biztosítja a szokásos Directory Server szolgáltatásokat, mint amilyen az olvasás, az írás és a keresés. Az ügyfél azonosíthatja magát a címtárkiszolgálóak egyszerű LDAP azonosítás révén, amely egy jelszavat és egy megkülönböztető nevet (DN-t) használ. Az ügyfél hitelesítheti magát valamelyik Simple Authentication and Security Layer (SASL) mechanizmus (CRAM-MD5, DIGEST-MD5, GSSAPI vagy EXTERNAL) használatával.
© Szerzői jog IBM 2003
1
C nyelvű alkalmazások Az ügyfél SDK a saját LDAP alkalmazás (LDAP 2-es vagy 3-as verzió) fejlesztéséhez szükséges eszközöket tartalmazza. Ne felejtse el, hogy a C nyelvű ügyfél-SDK támogatja a Secure Sockets Layer (SSL) réteget valamint a Transport Layer Security (TLS) réteget is, amelyekkel az SSL-lel illetve TLS-sel védett kapcsolatok esetén biztosítja az adatok titkosságát. Az SSL-támogatás engedélyezéséhez telepíteni kell az IBM Global Security Kit 7a (GSKit) terméket. A GSKit olyan választható szoftver, amely az IBM Tivoli Directory Server csomag részét képezi. Megjegyzés: Az IBM Tivoli Directory Server 5.2 Client SDK SSL réteggel történő használatához itt találhat fontos részleteket: “A biztonságos LDAP címtárral kapcsolatos szempontok (SSL és TLS használata)” oldalszám: 5.
2
IBM Tivoli Directory Server 5.2 Client Readme - Fontos tudnivalók az ügyfélszoftverről
Online dokumentáció A Readme fájlok mellett online dokumentumok is elérhetők PDF és HTML formátumban, például az Adminisztrációs útmutató (Administration Guide) és a Programozási kézikönyv (Programming Reference). Az IBM Tivoli Directory Server 5.2-es verziója támogatja a Java Naming and Directory Interface (JNDI) ügyfél használatát, amelyet a Sun Microsystems fejlesztett. A JNDI ügyfélről a Sun Microsystems webhelyén talál bővebb tájékoztatást: http://java.sun.com/products/jndi/1.2/index.html Megjegyzés: A PDF dokumentáció megtekintéséhez illetve kinyomtatásához az Adobe Acrobat Reader szabadon letölthető az Adobe webhelyéről: http://adobe.com. Windows rendszerek esetében: Adminisztrációs kézikönyv (Administration Guide) file:\telepítés útvonala\doc\nyelv\admin_gd.pdf vagy admin_gd.htm C-Client SDK Programozási kézikönyv (Programming Reference) file:\telepítés útvonala\doc\nyelv\progref.pdf vagy progref.htm AIX rendszerek esetében: Adminisztrációs kézikönyv (Administration Guide) file:/usr/ldap/doc/nyelv/admin_gd.pdf vagy admin_gd.htm C-Client SDK Programozási kézikönyv (Programming Reference) file:/usr/ldap/doc/nyelv/progref.pdf vagy progref.htm Linux rendszerek esetében: Adminisztrációs kézikönyv (Administration Guide) file:/usr/ldap/doc/nyelv/admin_gd.pdf vagy admin_gd.htm C-Client SDK Programozási kézikönyv (Programming Reference) file:/usr/ldap/doc/nyelv/progref.pdf vagy progref.htm Solaris rendszerek esetében: Adminisztrációs kézikönyv (Administration Guide) file:/opt/IBMldaps/doc/nyelv/admin_gd.pdf vagy admin_gd.htm C-Client SDK Programozási kézikönyv (Programming Reference) file:/opt/IBMldaps/doc/nyelv/progref.pdf vagy progref.htm HP-UX rendszerek esetében: Adminisztrációs kézikönyv (Administration Guide) file:/usr/IBMldap/doc/nyelv/admin_gd.pdf vagy admin_gd.htm C-Client SDK Programozási kézikönyv (Programming Reference) file:/usr/IBMldap/doc/nyelv/progref.pdf vagy progref.htm A termékhez tartozó minden dokumentáció elérhető online PDF (Portable Document Format), HTML (Hypertext Markup Language) formátumban, vagy mindkettőben a Tivoli szoftver könyvtárban: http://www.ibm.com/software/tivoli/library.
© Szerzői jog IBM 2003
3
4
IBM Tivoli Directory Server 5.2 Client Readme - Fontos tudnivalók az ügyfélszoftverről
A biztonságos LDAP címtárral kapcsolatos szempontok (SSL és TLS használata) A Client SDK 5.2-es verziójához telepíteni kell a GSKit 7a programot az SSL támogatás engedélyezéséhez. Az ügyfél SDK verzió LDAP-könyvtárai és segédprogramjai használják az SSL-könyvtárakat, ha azok jelen vannak. Az SSL könyvtárak az IBM GSKit 7a részét képezik. Ha a GSKit telepítve van, az LDAP címtár dinamikusan betölti és használja az SSL-könyvtárakat a biztonságos kapcsolat engedélyezéséhez. Ha a GSKit nem lett telepítve és az SSL könyvtárak nem érhetőek el, az LDAP címtár az SSL-támogatástól eltekintve teljesen működőképes. Ha az SSL-t kiszolgálóhitelesítéssel használja, akkor az LDAP-alkalmazás egyszerű LDAP-hitelesítést (azonosító és jelszó) használhat biztonságos, titkosított kommunikációs kapcsolaton keresztül. Az SSL így biztosítja a biztonságos összeköttetés létrejöttét az LDAP ügyfélalkalmazás és az LDAP-kiszolgáló között. Emellett az SSL biztosítja az adatok bizalmasságát (titkosítását) az SSL által védett összeköttetéseknél. A kiszolgálók hitelesítése az ügyfelek felé X.509-es igazolásokkal történik. Megjegyzés: Az IBM Tivoli Directory Server kiszolgáló-összetevője ugyancsak a GSKit terméket használja az SSL-támogatás engedélyezéséhez. A GSKit termékkel kapcsolatos információkat az IBM Tivoli Directory Server Version 5.2 C-Client SDK Programming Reference (Programozási kézikönyv) és az IBM Tivoli Directory Server 5.2 Installation and Configuration Guide (Telepítési és konfigurálási útmutató) című kiadványokban találhat.
© Szerzői jog IBM 2003
5
6
IBM Tivoli Directory Server 5.2 Client Readme - Fontos tudnivalók az ügyfélszoftverről
. Megjegyzések Az itt közölt adatok és információk a Magyarországon kínált termékekre és szolgáltatásokra vonatkoznak. Előfordulhat, hogy a dokumentumban szereplő termékeket és szolgáltatásokat az IBM más országokban nem forgalmazza. Adott országban rendelkezésre álló termékekről és szolgáltatásokról az IBM helyi képviseletei szolgálnak felvilágosítással. A hivatkozások az IBM termékeire, programjaira vagy szolgáltatásaira sem állítani, sem sugallni nem kívánják, hogy az adott helyzetben csak ezek az IBM termékek, programok vagy szolgáltatások használhatók. Minden olyan működésében azonos termék, program vagy szolgáltatás alkalmazható, amely nem sérti az IBM szellemi tulajdonjogát. Az ilyen egyéb termékek, programok és szolgáltatások működésének megítélése és ellenőrzése azonban a felhasználó felelőssége. A dokumentum tartalmával kapcsolatban az IBM rendelkezhet bejegyzett vagy bejegyzés alatt álló szabadalmakkal. Jelen dokumentum nem ad semmiféle licencet ezen szabadalmakhoz. A licenckérelmeket írásban kell jelezni a következő címen: IBM Director of Licensing IBM Corporation North Castle Drive Armonk, NY 10504-1785 U.S.A. A kétbájtos (DBCS) adatokra vonatkozó licenckérelmekkel kapcsolatban az IBM megfelelő helyi képviseletét kell megkeresni, vagy írásban a következő címen lehet érdeklődni: IBM World Trade Asia Corporation Licensing 2-31 Roppongi 3-chome, Minato-ku Tokyo 106, Japan A következő bekezdés nem vonatkozik az Egyesült Királyságra, valamint azokra az országokra, amelyek jogi szabályozása ellentétes a bekezdés tartalmával: AZ IBM A JELEN DOKUMENTUMOT “AHOGY VAN”, BÁRMIFÉLE KIFEJEZETT VAGY VÉLELMEZETT GARANCIA NÉLKÜL BIZTOSÍTJA, IDEÉRTVE, DE NEM KIZÁRÓLAG A JOGSÉRTÉS KIZÁRÁSÁRA, A KERESKEDELMI ÉRTÉKESÍTHETŐSÉGRE ÉS AZ ADOTT CÉLRA ALKALMAZHATÓSÁGRA VONATKOZÓ VÉLELMEZETT GARANCIÁKAT. Bizonyos államok nem engedélyezik egyes tranzakciók kifejezett vagy vélelmezett garanciáinak kizárását, így elképzelhető, hogy az előző nyilatkozat Önre nem vonatkozik. Jelen dokumentum technikai pontatlanságokat, illetve sajtóhibákat tartalmazhat. Az itt közölt adatokat rendszeres időközönként frissítik, ezeket a változtatásokat az új kiadások tartalmazzák. Az IBM külön értesítés nélkül továbbfejlesztheti és/vagy módosíthatja az itt ismertetett termékeket és/vagy programokat. A leírásban található nem IBM webhelyekre mutató hivatkozások csak a teljesebb tájékoztatást szolgálják, és semmi módon sem jelentik ezek minősítését vagy elismerését. Az ezeken webhelyeken található anyagok nem részei ennek az IBM terméknek, és használatuk az olvasó saját felelősségére történik. Az IBM az Ön által közölt adatokat mindenféle fennálló kötelezettség nélkül saját belátása szerint használhatja és terjesztheti.
© Szerzői jog IBM 2003
7
A program jogosult felhasználói, akik adatokat szeretnének beszerezni (i) a függetlenül létrehozott programok és más programok (beleértve ezt is) közötti adatcseréről, valamint (ii) a kicserélt adatok kölcsönös használatáról, a következő címre írhatnak: IBM Corporation Department MU5A46 11301 Burnet Road Austin, TX 78758 U.S.A. Előfordulhat, hogy az ilyen jellegű információk csak bizonyos előírások és feltételek elfogadása esetén, esetenként díjfizetés ellenében érhetők el. Az ebben a dokumentum leírt engedélyezett program és a hozzátartozó valamennyi engedélyezett anyag az IBM Customer Agreement, az IBM International Program License Agreement vagy egyéb, egyenértékű megállapodás feltételei alapján áll rendelkezésre. Az itt közölt teljesítményre vonatkozó adatokat szabályozott körülmények között állapították meg. A más működési környezetben kapott eredmények ezektől lényegesen eltérhetnek. Egyes mérések fejlesztési szintű rendszereken történtek, így nem garantálható, hogy ezek a mérési eredmények megegyeznek az általánosan rendelkezésre álló rendszereken kapott adatokkal. Néhány mérési adat megállapítása extrapolációval történt, a tényleges adatok ezektől eltérőek lehetnek. A dokumentum felhasználóinak ellenőrizniük kell az adott környezetben érvényes adatokat. A nem IBM termékekre vonatkozó adatok a termékek gyártóitól, a kiadott dokumentációkból és egyéb nyilvános forrásokból származnak. Az IBM nem vizsgálta ezeket a termékeket, így ezek esetében nem tudja megerősíteni a teljesítményre, a kompatibilitásra és az egyéb területekre vonatkozó állítások pontosságát. A más gyártók termékeivel kapcsolatos kérdésekkel az adott termék szállítóihoz kell fordulni. Ebben a tájékoztató anyagban a napi üzleti életben használatos mintaadatok és -jelentések szerepelnek. A teljeskörű szemléltetés érdekében a példák személyek, vállalatok, márkák és termékek nevét is tartalmazzák. Minden név kitalált, a valódi üzleti vállalkozások nevével vagy címével fennálló bármilyen hasonlóság teljes mértékben a véletlen műve. SZERZŐI JOGI ENGEDÉLY: A tájékoztatóban forrásnyelvű alkalmazásprogram-minták is szerepelnek, amelyek a programozási módszereket különféle operációs rendszereken mutatják be. Ezen mintaprogramok az IBM irányában fennálló díjfizetési kötelezettség nélkül másolhatók, módosíthatók és terjeszthetők bármilyen formában, amennyiben ez az adott operációs rendszerhez tartozó alkalmazásprogramozási illesztőfelületnek megfelelő alkalmazásprogramok fejlesztése, használata, piaci megjelenése, illetve terjesztése céljából történik. A példaprogramokat teljes körű tesztelése nem történt meg. Ezért az IBM nem szavatolja ezen programok megbízhatóságát, helyes működését és javíthatóságát. Ezen mintaprogramok az IBM irányában fennálló díjfizetési kötelezettség nélkül másolhatók, módosíthatók és terjeszthetők bármilyen formában, amennyiben ez az IBM alkalmazásprogramozási illesztőfelületeinek megfelelő alkalmazásprogramok fejlesztése, használata, piaci megjelenése, illetve terjesztése céljából történik. A példaprogramok minden példányán vagy azok bármely felhasznált részén, illetve bármilyen abból származó terméken fel kell tüntetni az alábbi szerzői jogi figyelmeztetést: © (a felhasználó vállalatának neve) (év). A kód egyes részei az IBM Corp. példaprogramjaiból származnak. © Copyright IBM Corp. _adja meg az éve(ke)t_. Minden jog fenntartva.
8
IBM Tivoli Directory Server 5.2 Client Readme - Fontos tudnivalók az ügyfélszoftverről
Ha elektronikus formában olvassa ezt a tájékoztatót, előfordulhat, hogy a fényképek és az ábrák nem jelennek meg.
Védjegyek A következő nevek az International Business Machines Corporation védjegyei az Egyesült Államokban és/vagy egyéb országokban: v AIX v IBM v iSeries v pSeries v S/390 v SecureWay v Tivoli v xSeries A Java, valamint az összes Java alapú védjegy és embléma a Sun Microsystems, Inc. védjegye vagy bejegyzett védjegye az Egyesült Államokban és más országokban. A Microsoft, a Windows és a Windows NT a Microsoft Corporation bejegyzett védjegyei. A UNIX az Open group bejegyzett védjegye. Más cégnevek, terméknevek és szolgáltatásnevek mások védjegyei vagy szolgáltatás védjegyei lehetnek.
. Megjegyzések
9
10
IBM Tivoli Directory Server 5.2 Client Readme - Fontos tudnivalók az ügyfélszoftverről
Nyomtatva Dániában
GI22-0055-00