Vous pouvez sécuriser une API JAX-WS (API Java for XML Web Services) à l'aide d'une règle de sécurité WS-Security. Vous n'avez pas besoin de
créer de contrat WSDL (Web Services Description Language) pour associer une règle WS-Security à un service Web ou à un client JAX-WS.
Pourquoi et quand exécuter cette tâche
Important : Applicable à Liberty
Vous pouvez utiliser l'assistant d'
association de règle pour sécuriser un service Web JAX-WS ou un client de service Web.
Vous pouvez également utiliser cet assistant pour un service Web JAX-WS ou un client de service Web dans un projet Web ou un projet EJB (Enterprise JavaBeans).
Procédure
- Ouvrez l'assistant d'association de règle pour joindre une règle WS-Security à un service Web ou à un client JAX-WS.
- Pour joindre une règle WS-Security à un service Web JAX-WS, cliquez avec le bouton droit de la souris sur le noeud du service JAX-WS dans le dossier Services de votre application et sélectionnez .
- Pour joindre une règle WS-Security à un client de service Web JAX-WS, cliquez avec le bouton droit de la souris sur le noeud du client JAX-WS dans le dossier Services de votre application et sélectionnez .
- Sélectionnez une ou plusieurs valeurs dans la zone des objets de règle.
- Si nécessaire, entrez une URL dans les zones de table des expressions de domaine pour toute référence de noeud final aux services.
L'assistant peut automatiquement remplir certaines références de noeud final dans les cas suivants :
- Le service Web comporte un fichier WSDL local qui indique les noeuds finaux appropriés.
- L'application est déjà déployée sur le serveur.
- Facultatif : Si vous souhaitez que les outils remplacent un fichier d'association de règle dans le projet, sélectionnez l'option pour remplacer le fichier d'association de règle.
- Cliquez sur Suivant.
- Sélectionnez un modèle de règle WS-Security dans le menu Modèle de règle.
La zone Description affiche des informations sur le modèle de règle WS-Security sélectionné. Pour plus d'informations sur les modèles de règle WS-Security, voir
WS-SecurityPolicy
et modèles.
Vous pouvez, par exemple, sélectionner Jeton de nom d'utilisateur avec une protection de message asymétrique X509Token (authentification mutuelle).
- Cliquez sur Terminer.
Résultats
Si vous sélectionnez un service Web JAX-WS, les outils génèrent un fichier d'association de règle nommé policy-attachments-server.xml. Si vous sélectionnez un client de service Web JAX-WS, les outils génèrent un fichier d'association de règle nommé policy-attachments-client.xml.
Si vous sélectionnez un service Web ou un client de service Web JAX-WS dans un projet Web, les outils génèrent le fichier d'association de règle dans le répertoire WEB-INF.
Dans un projet EJB, les outils génèrent le fichier d'association de règle dans le répertoire META-INF.