JAX-RPC visszahívás-kezelő konfiguráció beállításai

Ezen az oldalon meghatározhatja, hogyan szerezhető be a SOAP üzeneten belül a JAX-RPC webszolgáltatás biztonság fejlécébe illesztett biztonsági token. A token beszerzés egy cserélhető keretrendszer, mely a Java Authentication and Authorization Service (JAAS) javax.security.auth.callback.CallbackHandler felületet hasznosítja a biztonsági token megszerzéséhez.

Hiba elkerülése: Mielőtt értékeket ad meg az oldalon lévő Kulcstár és Kulcs tulajdonságokhoz, tisztában kell lennie azzal, hogy az előállítóhoz megadott kulcstár/álnév információk és a fogyasztóhoz megadott kulcstár/álnév információk más célokra lesznek felhasználva. A fő különbség egy X.509 visszahívás-kezelő álnevére vonatkozik: gotcha

Előállító: Ha egy titkosítás-előállítóval együtt van használatban, akkor az előállítóhoz megadott álnév szolgál az üzenet titkosításához használandó nyilvános kulcs lekérésére. Jelszó nem szükséges. A titkosítás-előállítóhoz tartozó visszahívás-kezelőn megadott álnévnek elérhetőnek kell lennie jelszó nélkül. Ez azt jelenti, hogy az álnévhez nem tartozhatnak privát kulcs információk a kulcstárban. Ha egy aláírás-előállítóval együtt van használatban, akkor az előállítóhoz megadott álnév szolgál az üzenet aláírásához használandó privát kulcs lekérésére. Jelszó szükséges.

Az adminisztrációs konzol visszahívás kezelő oldalának megtekintéséhez a cella szinten tegye a következőket:

Kattintson a Biztonság > JAX-WS és JAX-RPC biztonság futási környezet elemre.
A JAX-RPC alapértelmezett előállító kötések alatt kattintson a Token előállítók > token_előállító_neve elemre.
A További tulajdonságok szakaszban kattintson a Visszahívás-kezelő gombra.

Az adminisztrációs konzol visszahívás kezelő oldalának megtekintéséhez a kiszolgáló szinten tegye a következőket:

Kattintson a Kiszolgálók > Kiszolgálótípusok > WebSphere alkalmazáskiszolgálók > kiszolgáló_neve elemre.
A Biztonság alatt kattintson a JAX-WS és JAX-RPC biztonság futási környezet elemre.
Kevert változatú környezet: A Websphere Application Server 6.1 vagy korábbi változatát használó kiszolgálóval rendelkező kevert csomópontos cellában kattintson a Webszolgáltatások: Webszolgáltatás biztonság alapértelmezett kötései elemre.mixv
A JAX-RPC alapértelmezett előállító kötések alatt kattintson a Token előállítók > token_előállító_neve elemre.
A További tulajdonságok szakaszban kattintson a Visszahívás-kezelő gombra.

Az adminisztrációs konzol visszahívás kezelő oldalának megtekintéséhez az alkalmazás szinten tegye a következőket:

Kattintson az Alkalmazások > Alkalmazástípusok > WebSphere nagyvállalati alkalmazások > alkalmazás_neve elemre.
A Modulok alatt kattintson a Modulok kezelése URI_neve elemekre.
A Webszolgáltatás biztonsági tulajdonságok szakaszban a visszahívás kezelő információk az alábbi kötésekre érhetők el:
- A Kéréselőállító (küldő) kötéshez válassza a Webszolgáltatások: ügyfél biztonsági kötések elemet. A Válaszelőállító (küldő) kötés szakaszban kattintson az Egyéni szerkesztés gombra. A További tulajdonságok szakaszban kattintson a Token-előállítók gombra. Kattintson az Új gombra egy új token-előállító konfiguráció létrehozásához, vagy kattintson egy meglévő konfiguráció nevére és módosítsa a beállításait. A További tulajdonságok szakaszban kattintson a Visszahívás-kezelő gombra.
- A Válaszelőállító (küldő) kötéshez válassza a Webszolgáltatások: kiszolgáló biztonsági kötések elemet. A Válaszelőállító (küldő) kötés szakaszban kattintson az Egyéni szerkesztés gombra. A További tulajdonságok szakaszban kattintson a Token-előállítók gombra. Kattintson az Új gombra egy új token-előállító konfiguráció létrehozásához, vagy kattintson egy meglévő konfiguráció nevére és módosítsa a beállításait. A További tulajdonságok szakaszban kattintson a Visszahívás-kezelő gombra.

Visszahívás kezelő osztálynév

A biztonsági token keretrendszer beillesztésére szolgáló visszahívás-kezelő megvalósítás osztály nevét határozza meg.

A megadott visszahívás-kezelő osztálynak meg kell valósítania a javax.security.auth.callback.CallbackHandler osztályt. A JAAS javax.security.auth.callback.CallbackHandler felület megvalósításának biztosítania kell egy konstruktort, amely az alábbi szintaxis használja:

MyCallbackHandler(String felhasználónév, char[] jelszó, 
    java.util.Map tulajdonságok)

Ahol:

felhasználónév: Meghatározza a konfigurációnak átadott felhasználói nevet.
jelszó: Meghatározza a konfigurációnak átadott jelszót.
tulajdonságok: Meghatározza a konfigurációnak átadott egyéb beállítási tulajdonságokat.

Az alkalmazáskiszolgáló az alábbi alapértelmezett visszahívás-kezelő megvalósításokat támogatja:

com.ibm.wsspi.wssecurity.auth.callback.GUIPromptCallbackHandler: A visszahívás-kezelő bejelentkezési parancssort használ a felhasználói név és jelszó információk összegyűjtésére. Ha azonban ezen a panelen megadja a felhasználónevet és a jelszót, akkor nem jelenik meg parancssor, és az alkalmazáskiszolgáló visszaküldi a felhasználónevet és a jelszót a token-előállítónak, ha az meg van adva ezen a panelen. Ezt a megvalósítást csak Java Platform, Enterprise Edition (Java EE) alkalmazásügyfél esetén használja.
com.ibm.wsspi.wssecurity.auth.callback.NonPromptCallbackHandler: A visszahívás-kezelő nem ad parancssort, és akkor küldi vissza a felhasználói nevet és jelszót, ha a panelen ez megadott. Akkor használható ez a visszahívás-kezelő, ha a webszolgáltatás ügyfélként működik.
com.ibm.wsspi.wssecurity.auth.callback.StdinPromptCallbackHandler: A visszahívás-kezelő szabványos bejelentkezési parancssort használ a felhasználói név és jelszó információk összegyűjtésére. Ha ezen a panelen adja meg a felhasználói nevet és jelszót, akkor az alkalmazáskiszolgáló nem ad parancssort, de visszaküldi a felhasználói nevet és jelszót a token-előállítónak. Ezt a megvalósítást csak Java Platform, Enterprise Edition (Java EE) alkalmazásügyfél esetén használja.
com.ibm.wsspi.wssecurity.auth.callback.StdinPromptCallbackHandler: A visszahívás-kezelő szabványos bejelentkezési parancssort használ a felhasználói név és jelszó információk összegyűjtésére. Ha ezen a panelen adja meg a felhasználói nevet és jelszót, akkor az alkalmazáskiszolgáló nem ad parancssort, de visszaküldi a felhasználói nevet és jelszót a token-előállítónak. Ezt a megvalósítást csak Java Platform, Enterprise Edition (Java EE) alkalmazásügyfél esetén használja.
com.ibm.wsspi.wssecurity.auth.callback.LTPATokenCallbackHandler: Ez a visszahívás-kezelő kérdezi le az Egyszerűsített külső hitelesítés (LTPA) biztonsági tokent a RunAs hívó Tárgytól. A token az SOAP üzeneten belüli bináris biztonsági tokenként illeszkedik a webszolgáltatás biztonsági fejlécébe. Ha ezen a panelen adja meg a felhasználói nevet és jelszót, akkor az LTPA biztonsági token megszerzése érdekében az alkalmazáskiszolgáló nem a RunAs Tárgytól kérdezi le, hanem hitelesíti a felhasználói nevet és jelszót. Akkor használható ez a visszahívás-kezelő, ha a webszolgáltatás az alkalmazáskiszolgálón ügyfélként működik. Java EE alkalmazásügyfélen nem ajánlott ezt a visszahívás-kezelőt használni.
com.ibm.wsspi.wssecurity.auth.callback.X509CallbackHandler: A visszahívás-kezelő alkalmazásával készül az X.509 tanúsítvány, mely az SOAP üzeneten belüli bináris biztonsági tokenként illeszkedik a webszolgáltatás biztonsági fejlécébe. A visszahívás-kezelő egy kulcstárolót és egy kulcs-meghatározást igényel.
com.ibm.wsspi.wssecurity.auth.callback.PKCS7CallbackHandler: A visszahívás-kezelő segítségével jönnek létre PKCS#7 formátumban kódolt X.509 tanúsítványok. A tanúsítvány az SOAP üzeneten belüli bináris biztonsági tokenként illeszkedik a webszolgáltatás biztonsági fejlécébe. A visszahívás-kezelő egy kulcstárolót igényel. A kollekció tanúsítványtárolóban meg kell adni egy tanúsítvány visszavonási listát (CRL). A CRL az X.509 tanúsítványsal PKCS#7 formátumban kódolt.
com.ibm.wsspi.wssecurity.auth.callback.PkiPathCallbackHandler: A visszahívás-kezelő segítségével jönnek létre PkiPath formátumban kódolt X.509 tanúsítványok. A tanúsítvány az SOAP üzeneten belüli bináris biztonsági tokenként illeszkedik a webszolgáltatás biztonsági fejlécébe. A visszahívás-kezelő egy kulcstárolót igényel. A visszahívás-kezelő nem támogatja a CRL listát; ezért a kollekció tanúsítványtároló nem szükséges és nem használt.

A visszahívás-kezelő megvalósítás megszerzi a kívánt biztonsági tokent és átadja a token-előállító számára. A token előállító a biztonsági tokent beilleszti a SOAP üzeneten belül a webszolgáltatás biztonsági fejlécébe. A token-előállító szintén bedolgozó pont a cserélhető biztonsági token keretrendszer számára. A szolgáltatás szolgáltatói megadhatják a saját megvalósításukat, de a megvalósításnak a com.ibm.websphere.wssecurity.wssapi.token.SecurityToken felületet kell használnia. A Java hitelesítési és jogosultsági szolgáltatás (JAAS) bejelentkezési modul megvalósításával történik a biztonsági token előállítása az előállítói oldalon, illetve értelemszerűen a biztonsági token ellenőrzése (hitelesítése) a felhasználói oldalon.

Azonosságellenőrzés alkalmazása

Akkor válassza ezt a lehetőséget, ha azonosság kijelentés van meghatározva az IBM® kiterjesztett telepítésleíróban.

Azt jelzi, hogy csak a kezdeti küldő azonossága szükséges és illesztett az SOAP üzeneten belül a webszolgáltatás biztonsági fejlécébe. Például az alkalmazáskiszolgáló a felhasználónév token-előállító (Username TokenGenerator) számára csak az eredeti hívó felhasználói nevét küldi el. X.509 token-előállító esetén az alkalmazáskiszolgáló csak az eredeti aláíró tanúsítványt küldi el.

RunAs azonosság alkalmazása

Akkor válassza ezt a lehetőséget, ha az IBM kiterjesztett telepítésleírójában létezik meghatározott azonosság kijelentés, és a kezdeti hívó azonosság helyett RunAs azonosságot kíván használni azonosság kijelentésre egy lefelé irányuló hívásban.

A lehetőség csak token-előállítóként beállított meglévő felhasználói név token-előállító esetén érvényes.

Alapszintű hitelesítési felhasználói azonosító

Meghatározza a visszahívás-kezelő megvalósítás konstruktorai számára átadott felhasználónevet.

Az alapvető hitelesítési felhasználónév és jelszó kerül felhasználásra a termék által biztosított alábbi alapértelmezett visszahívás-kezelő megvalósítások egyikének választása esetén:

com.ibm.wsspi.wssecurity.auth.callback.GUIPromptCallbackHandler
com.ibm.wsspi.wssecurity.auth.callback.LTPATokenCallbackHandler
com.ibm.wsspi.wssecurity.auth.callback.NonPromptCallbackHandler
com.ibm.wsspi.wssecurity.auth.callback.StdinPromptCallbackHandler

Ezeknek a megvalósításoknak a részletes leírását a Visszahívás-kezelő osztályneve mezőleírásban találhatja meg.

Alapszintű hitelesítési jelszó

A visszahívás-kezelő konstruktorának átadott jelszót határozza meg.

A kulcstároló és az ahhoz kapcsolódó beállítások kerülnek felhasználásra a termék által biztosított alábbi alapértelmezett visszahívás-kezelő megvalósítások egyikének választása esetén:

com.ibm.wsspi.wssecurity.auth.callback.PKCS7CallbackHandler: A kulcstároló segítségével épül fel az X.509 tanúsítvány és a tanúsítvány elérési út.
com.ibm.wsspi.wssecurity.auth.callback.PkiPathCallbackHandler: A kulcstároló segítségével épül fel az X.509 tanúsítvány és a tanúsítvány elérési út.
com.ibm.wsspi.wssecurity.auth.callback.X509CallbackHandler: A kulcstároló segítségével valósul meg az X.509 tanúsítvány lekérése.

Kulcstároló

Válassza a Nincs lehetőséget, ha nem szükséges kulcstároló a konfigurációhoz.

válassza az előre meghatározott kulcstároló lehetőséget a választáshoz a kulcstároló konfiguráció névvel rendelkező előre meghatározott kulcstárolók közül.

Válassza a Felhasználó által megadott kulcstároló lehetőséget, ha felhasználó által megadott kulcstárolót kíván használni.

Az alábbi információkat kell megadni:

Kulcstároló konfiguráció neve

A kulcstároló konfiguráció nevét határozza meg, amely a biztonságos kommunikációk kulcstároló beállításaiban van megadva.

Kulcstároló jelszó

A kulcstároló fájlhoz történő hozzáféréshez használt jelszót adja meg.

Kulcstároló elérési út

A kulcstároló fájl helyét határozza meg.

Az elérési út nevében használja a ${USER_INSTALL_ROOT} elemet, mert ez a változó kibontódik a számítógép termék útvonalára. A változó által használt elérési út módosításához bontsa ki a Környezet > WebSphere változók ágat, majd válassza a USER_INSTALL_ROOT elemet.

Kulcstároló típusa

A kulcstároló fájlformátum típusát határozza meg.

Válassza ki a következő értékek valamelyikét a mező számára:

JKS: A kulcstároló a Java Keystore (JKS) formátumot használja.
JCEKS: A Java Cryptography Extension a szoftver fejlesztőkészletben (SDK) van beállítva. Az alapértelmezett IBM JCE az alkalmazáskiszolgálón van beállítva. Ez a lehetőség erősebb védelmet nyújt a tárolt privátkulcsok számára a Triple DES titkosítás alkalmazásával.
JCERACFKS: A JCERACFKS lehetőség használt a tanúsítványok SAF kulcscsomóban történő tárolása esetén (csak z/OS rendszerben).
PKCS11KS (PKCS11): Ez a beállítás a PKCS#11 fájlformátumú kulcstároló esetén. Az ilyen formátumot alkalmazó kulcstárolók RSA kriptográfiai hardverkulcsokat tartalmazhatnak, vagy kriptográfiai hardvert alkalmazó kulcsokat titkosíthatnak a védelem biztosítása érdekében.
PKCS12KS (PKCS12): Ez a beállítás a PKCS#12 fájlformátumú kulcstároló fájl esetén.

Fájlnév: uwbs_callback.html