Sécurisation d'un service Web avec une règle WS-Security sans contrat WSDL

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

  1. 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 Configure Web Service Policy > Add Service Policy Attachments....
    • 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 Configure Web Service Policy > Add Client Policy Attachments....
  2. Sélectionnez une ou plusieurs valeurs dans la zone des objets de règle.
  3. 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.
  4. 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.
  5. Cliquez sur Suivant.
  6. 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).

  7. 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.

Icon that indicates the type of topic Task topic
Timestamp icon Last updated: last_date

File name: tws_securitypolicy_nowsdl.html