Configuration d'un serveur de prévisualisation Web

Vous pouvez configurer le serveur de prévisualisation Web et le fichier proxy-config.xml.

Procédure

  1. Dans la vue Serveurs, cliquez deux fois sur le serveur de prévisualisation Web pour ouvrir l'éditeur du serveur. Vous pouvez utiliser les pages Présentation et Sécurité pour configurer le serveur de prévisualisation Web.
  2. Dans la section Informations générales de la page Présentation, modifiez le nom du serveur, le nom de l'hôte et l'environnement d'exécution.
  3. Dans la section Paramètres de communication, spécifiez le numéro de port par défaut à utiliser pour le serveur de prévisualisation Web.
    Remarque : Si le numéro de port par défaut est déjà utilisé, le serveur de prévisualisation Web affecte automatiquement un autre numéro de port disponible.
  4. Dans la section Publication, sélectionnez l'un des paramètres suivants :
    Option Description
    Ne jamais publier automatiquement Le plan de travail ne publie jamais les fichiers sur le serveur.
    Publier automatiquement lorsque les ressources changent Le plan de travail procède à la publication lorsque les modifications apportées à un fichier associé au serveur sont enregistrées et après écoulement total de l'intervalle de publication indiqué. Il s'agit du paramètre par défaut.
    Publier automatiquement après un événement de génération Le plan de travail procède à la publication lorsque les modifications apportées à un fichier qui requiert une génération et qui est associé au serveur sont enregistrées et après écoulement total de l'intervalle de publication indiqué.
    Intervalle de publication (en secondes) Nombre de secondes qui s'écoulent avant la publication des fichiers sur le serveur par le plan de travail. Cependant, si vous apportez des modifications aux fichiers avant que cet intervalle de temps se soit écoulé, la publication est différée en raison de la réinitialisation du minuteur. Le plan de travail ne procède à la publication sur le serveur qu'après écoulement total de l'intervalle indiqué. Si vous indiquez 0 comme intervalle de publication, un fichier est publié dès que les modifications apportées à un fichier sont enregistrées.
  5. Dans la section Délais d'expiration, définissez le délai nécessaire à l'exécution des demandes.
  6. La section Proxy Ajax contient un tableau qui présente les URL d'accès associées aux URL cible résolues correspondantes. Elle comporte une règle de proxy par défaut pour les caractères génériques qui sont répertoriés dans la colonne URL d'accès (proxy/http/*) que vous pouvez utiliser pour associer une URL à un proxy. Par exemple, vous pouvez utiliser l'URL http://localhost:8080/proxy/http/google.com dans le navigateur Web afin de charger la page Web Google. Cette demande qui est mappée via le proxy a le même résultat que le lancement d'une demande directe sur http://www.google.com.
    Conseil : Vous pouvez cliquer à l'aide du bouton droit de la souris sur une ligne du tableau d'URL de proxy Ajax et copier l'URL d'accès, par exemple proxy/us/en afin de la coller dans le code JavaScript.
  7. Cliquez sur le lien Configurer les URL du proxy pour modifier le fichier proxy-config.xml.
  8. Dans l'éditeur de configuration de proxy Ajax, ajoutez des règles de proxy pour le mappage vers des domaines distants. Sélectionnez le noeud Règles de proxy et cliquez sur Ajouter.
  9. Dans la fenêtre Ajouter un élément, sélectionnez l'un des éléments suivants et modifiez ses attributs dans l'éditeur :
    Option Description
    Mappage Mappe les demandes entrantes vers une URL cible en fonction de leur chemin de contexte.

    Spécifiez un attribut Chemin de contexte et un attribut URL facultatif. Par exemple, vous pouvez définir le chemin de contexte /ibmproducts sur l'URL http://www.ibm.com/products.

    Si l'URL du proxy entrant est http://mywebsite.com/ibmproducts/us/en, le proxy transmet la demande à http://www.ibm.com/products/us/en. Le proxy résout les mappages de chemin de contexte avant d'appliquer la règle d'accès correspondante. Deux mappages de proxy par défaut, http/* et us/en, sont fournis pour prendre en charge le prototypage rapide.

    Métadonnées Spécifie les propriétés de configuration générales du proxy, par exemple, les paramètres liés à HTTP. L'éditeur de proxy fournit des options de métadonnées communes avec des paires nom-valeur par défaut :
    forward-http-errors
    Par défaut, le proxy Ajax transmet uniquement les codes d'état HTTP supérieurs ou égaux à 200 et inférieurs à 400. Les codes d'état en dehors de cette fourchette sont automatiquement convertis en erreur 404 File Not Found. Vous pouvez transmettre des codes HTTP supérieurs ou égaux à 400 avec un message en attribuant au paramètre forward-http-errors la valeur true.
    unsigned_ssl_certificate_support
    Les certificats non signés sont souvent utilisés dans des services REST protégés. Lorsque unsigned_ssl_certificate_support est activé, le proxy Ajax accepte tous les certificats SSL. Cette option est utile pour le test et le débogage. Ne l'utilisez pas dans un environnement de production.
    basic-auth-support
    Affectez à cette option la valeur true si le service cible utilise l'authentification de base. Le code d'état HTTP 401 (non autorisé) donne lieu à une erreur 403 Forbidden, sauf si l'attribut basic-auth-support est activé pour la demande concernée.
    maxconnectionsperhost
    maxconnectionperhost est une valeur globale qui indique le nombre maximal de connexions à l'état actif pour une combinaison d'hôte ou de port. Par défaut, la valeur est de 2. Vous pouvez augmenter cette valeur si votre application accède à plus de deux sites distants.
    maxtotalconnections
    Le paramètre maxtotalconnections correspond au nombre maximal de connexions prises en charge par le proxy. La valeur par défaut est de 5. Choisissez une valeur suffisamment élevée pour prendre en charge le nombre de connexions que vous pourriez recevoir simultanément. Tenez compte de la façon dont le conteneur Web est configuré et du nombre de connexions qu'il peut lui-même prendre en charge simultanément.
    socket-timeout
    Le paramètre socket-timeout définit la durée par défaut, en millisecondes, pendant laquelle le socket peut attendre des données une fois la connexion établie. La valeur par défaut est 0, qui est à interpréter comme l'absence de délai imparti (le socket peut attendre indéfiniment).
    retries
    Le paramètre retries définit le nombre de réessais que le proxy Ajax doit effectuer avant d'abandonner l'établissement d'une connexion. La valeur par défaut est 2.
    connection-timeout
    Le paramètre connection-timeout définit la durée, en millisecondes, avant l'établissement d'une connexion. Si aucune valeur n'est spécifiée, la valeur par défaut appliquée est 60000. Si la valeur 0 est spécifiée, celle-ci est interprétée comme l'absence de délai d'attente.
    Règle Définit une règle d'accès pour un masque d'URL donné.
    1. Dans la zone ACF, activez ou désactivez le filtrage de contenu actif. Le filtrage de contenu actif supprime le contenu actif potentiellement malveillant de l'application qui s'affiche dans un navigateur.
    2. Spécifiez le masque dans la zone d'attribut URL. Pour chaque demande entrante, le proxy applique la règle qui contient la meilleure correspondance d'adresse URL. Si aucune règle correspondante n'est trouvée, le proxy rejette la demande. Si une règle est trouvée, les sous-éléments de l'élément de règle sont appliqués pour vérifier si la demande doit être acceptée.
    3. Activez ou désactivez la prise en charge des questions d'authentification.
    Vous pouvez modifier les sous-éléments de règle suivants :
    Méthodes d'action
    Spécifiez au moins une méthode HTTP prise en charge. Le proxy Ajax prend en charge les demandes GET, POST, PUT, HEAD ou DELETE.
    Cookies
    Définissez une liste de noms de cookie qui identifient les cookies que le proxy doit transmettre au domaine cible. Pour transmettre des cookies, le proxy filtre la valeur de l'en-tête du cookie en fonction des noms de cookie définis.
    En-têtes HTTP
    Définissez la liste de noms d'en-tête que le proxy doit transmettre au domaine cible. Les noms d'en-tête peuvent comporter des caractères génériques.
    Types MIME
    Spécifiez la liste des types MIME acceptés. Les types mime désignent la réponse que le proxy reçoit du serveur cible. Si au moins un type MIME est spécifié, le proxy accepte uniquement les réponses comportant l'en-tête de réponse Content-Type qui correspond à l'un des types MIME indiqués. Si aucun type mime n'est indiqué, le proxy accepte toutes les réponses.
    Utilisateurs
    Spécifiez une liste d'utilisateurs ou de groupes d'utilisateurs. Par exemple, si vous spécifiez AllAuthenticatedUsers, le proxy vérifie que la demande a été envoyée par un utilisateur authentifié.
  10. La section Magasin de clés du proxy Ajax contient des informations concernant le magasin de clés qui sont utilisées par le proxy Ajax, comme le chemin et le type du magasin de clés. Vous pouvez ajouter ou supprimer des certificats SSL du magasin de clés afin d'utiliser le proxy Ajax pour extraire des informations des URL pour lesquelles le serveur cible utilise des certificats SSL non sécurisés. Après avoir importé le certificat SSL d'une URL qui pointe vers un serveur avec un certificat non sécurisé, vous pouvez utiliser le proxy Ajax pour accéder à cette URL sans recevoir un message d'erreur.
    1. Facultatif : Si le mot de passe du magasin de clés a été modifié à l'aide du logiciel acquis auprès d'un autre fournisseur, mettez à jour le mot de passe dans la zone Mot de passe du magasin de clés.
    2. Ajoutez ou supprimez les certificats du serveur SSL du magasin de clés qui est spécifié dans la zone Chemin d'accès au magasin de clés.
      1. Cliquez sur Gérer les entrées du magasin de clés. La fenêtre Gérer les entrées du magasin de clés s'affiche et contient une liste des entrées de magasin de clés en cours, identifiées par leur alias.
      2. Pour supprimer une entrée de magasin de clés, sélectionnez-la dans la liste des entrées du magasin de clés et cliquez ensuite sur Supprimer l'entrée.
      3. Pour ajouter une entrée de magasin de clés, cliquez sur Ajouter une entrée. La fenêtre Importer un certificat s'affiche.
      4. Dans la zone Alias d'entrée, spécifiez un alias pour la nouvelle entrée de magasin de clés.
      5. Indiquez si vous voulez importer les certificats SSL à partir d'un serveur ou d'un système local.
        Importer des certificats d'un serveur dans le magasin de clés
        Entrez l'URL du serveur à partir duquel vous voulez importer les certificats SSL.
        Importer un certificat local dans le magasin de clés
        Cliquez sur Rechercher un certificat pour localiser le certificat SSL que vous voulez importer sur le système local.
      6. Cliquez sur OK pour enregistrer vos modifications et fermer la fenêtre Importer un certificat. Dans la fenêtre Gérer le magasin de clés, cliquez sur OK pour enregistrer toutes vos modifications dans le magasin de clés.
  11. Dans la page Sécurité, configurez les paramètres ci-dessous.
    Section Description
    Général Activez ou désactivez la sécurité des applications Web. Examinez les projets déployés sur le serveur de prévisualisation Web.
    Remarque : Vous devez activer la sécurité des applications Web qui sont déployées sur le serveur de prévisualisation Web. Vous pouvez configurer la sécurité dans le fichier WebContent/WEB-INF/web.xml contenu dans le projet Web que vous voulez déployer sur le serveur.
    Utilisateurs et groupes Gérez les utilisateurs et les groupes qui sont enregistrés sur le serveur de prévisualisation Web.
    • Enregistrez les nouveaux utilisateurs sur le serveur.
    • Supprimez les utilisateurs du serveur.
    • Enregistrez de nouveaux groupes sur le serveur.
    • Ajoutez ou supprimez des utilisateurs des groupes enregistrés.
    • Supprimez des groupes du serveur.
    Rôles de sécurité Gérez les rôles de sécurité qui sont enregistrés sur le serveur de prévisualisation Web.
    • Enregistrez les rôles de sécurité sur le serveur.
    • Supprimez les rôles de sécurité du serveur.
    • Mappez des rôles de sécurité à des utilisateurs.
    • Supprimez les rôles de sécurité des utilisateurs.
    • Mappez des rôles de sécurité à des groupes.
    • Supprimez des rôles de sécurité des groupes.
  12. Sauvegardez les modifications.
Icône indiquant le type de rubrique Rubrique de tâche
Dispositions pour les centres de documentation | Commentaires en retour

Icône d'horodatage Dernière mise à jour: May 29, 2014 10:11

Nom de fichier : tconfigajaxtestserver.html