Sie können einen JAX-WS-Web-Service (Java API for XML Web Services) mit einer WS-Security-Richtlinie schützen.
Sie müssen keinen WSDL-Kontrakt (Web Services Description Language) erstellen, um eine WS-Security-Richtlinie einem JAX-WS-Web-Service oder -Client zuzuordnen.
Informationen zu diesem Vorgang
Wichtig: Gilt für Liberty
Sie können den Assistenten für die
Richtlinienzuordnung
verwenden, um einen JAX-WS-Web-Service bzw. -Web-Service-Client zu sichern. Sie können diesen Assistenten
auch in einem JAX-WS-Web-Service oder -Web-Service-Client in einem Webprojekt oder einem EJB-Projekt (Enterprise JavaBeans) verwenden.
Vorgehensweise
- Öffnen Sie den Assistenten für die Richtlinienzuordnung, um eine WS-Security-Richtlinie
einem JAX-WS-Web-Service bzw. -Web-Service-Client zuzuordnen.
- Um eine WS-Security-Richtlinie einem JAX-WS-Web-Service zuzuordnen, klicken Sie im Ordner
Services Ihrer Anwendung mit der rechten Maustaste auf den JAX-WS-Serviceknoten und wählen Sie
aus.
- Um ein WS-Security-Richtlinie einem JAX-WS-Web-Service-Client zuzuordnen, klicken Sie im Ordner
Services Ihrer Anwendung mit der rechten Maustaste auf den JAX-WS-Clientknoten und wählen Sie .
- Wenn Sie im Feld Richtliniensubjekte einen oder mehrere Werte aus.
- Geben Sie, falls nötig, in den Feldern der Tabelle Domänenausdrücke eine URL für Endpunktreferenzen auf Services ein.
Der Assistent kann in folgenden Fällen einige Endpunktreferenzen automatisch eintragen:
- Der Web-Service hat eine lokale WSDL-Datei, die die richtigen Endpunkte angibt.
- Die Anwendung ist bereits auf dem Server implementiert.
- Optional: Wenn die Tools alle Richtlinienzuordnungsdateien im Projekt überschreiben sollen, wählen Sie
Richtlinienanhangdatei überschreiben aus.
- Klicken Sie auf Weiter.
- Wählen Sie im Menü Richtlinienschablone eine WS-Security-Richtlinienschablone aus.
Im Feld Beschreibung werden Informationen zur ausgewählten WS-Security-Richtlinienschablone angezeigt.
Weitere Informationen zu WS-Security-Richtlinienschablonen finden Sie unter
WS-Security-Richtlinie und -Schablonen.
Sie können beispielsweise Benutzernamenstoken (UsernameToken) mit asymmetrischem X509Token-Nachrichtenschutz (gegenseitige Authentifizierung) auswählen.
- Klicken Sie auf Fertigstellen.
Ergebnisse
Wenn Sie einen JAX-WS-Web-Service ausgewählt haben, haben die Tools eine Richtlinienzuordnungsdatei mit dem Namen policy-attachments-server.xml erstellt. Wenn Sie einen JAX-WS-Web-Service-Client ausgewählt haben, haben die Tools eine Richtlinienzuordnungsdatei mit dem Namen policy-attachments-client.xml erstellt.
Wenn Sie einen JAX-WS-Web-Service oder -Web-Service-Client in einem Webprojekt ausgewählt haben, haben die Tools eine Richtlinienzuordnungsdatei
im Verzeichnis WEB-INF erstellt. In einem EJB-Projekt erstellen die Tools die Richtlinienzuordnungsdatei im Verzeichnis
META-INF.