Le plugin Webappcontainer dispose d'une interface d'administration des sites externes. Cette interface nommée "Gestion des sites externes" permet de créer, modifier et supprimer un site externe.
Pour créer un site externe, se connecter à l'interface d'administration "Gestion des sites externes".
Dans la liste des sites externes, cliquer sur le bouton "Ajouter un site".
La page de création d'un site externe apparaît avec les champs suivants à renseigner :
| Champ | Description |
|---|---|
| Code | Nom du site externe le code ne doit pas comporter de caractères spéciaux (uniquement des lettres ou des chiffres) |
| Url | Url d'accès au site externe |
| Description | Description du site externe |
| Groupe de travail | Restriction de l'administration du site externe pour un groupe de travail |
| Reconstruire la page HTML |
|
| Rediriger le contenu non-HTML |
Pour plus d'informations, se référer à la section "Redirection du contenu non-HTML" ci-dessous |
| Utiliser le proxy | Si cette case est cochée, le conteneur de webapp se connectera au site externe par l'intermédiaire du serveur mandataire dont les paramètres de configuration sont définis dans le fichier "webappcontainer.properties". |
Cliquer sur le bouton "Créer" pour soumettre le formulaire.
Pour accéder à la page de modification d'un site externe, dans la liste des sites externes, cliquer sur le code du site externe à modifier.
La page de modification est identique à celle de création.
Pour supprimer un site externe, cliquer sur l'icone correspondante (poubelle), dans la colonne "Action".
Il est possible de restreindre l'administration d'un site externe par groupe de travail.
Pré requis :
Modifier le site externe et lui affecter un groupe de travail.
Pour vérifier le fonctionnement de la restriction, se connecter à l'interface d'administration avec un utilisateur n'étant pas inscrit à ce groupe de travail.
Cette fonctionnalité permet de rediriger le contenu non-HTML (images, CSS, scripts, flux RSS) d'un site externe vers le conteneur de webapp, ou bien alors d'accéder à tous ces éléments directement à partir du site externe.
Dans les deux cas, le contenu HTML sera toujours traité par le conteneur de webapp.
Lorsque la redirection du contenu non-HTML est activée (case cochée), alors tous les éléments non-HTML (images, CSS, scripts, flux RSS) du site externe transitent par le conteneur de webapp.
Lorsque la redirection du contenu non-HTML est désactivée (case décochée), alors l'accès aux éléments non-HTML (images, CSS, scripts, flux RSS) est réalisé directement depuis le site externe.
Attention :
Le paramétrage du descripteur de déploiement (web.xml) est nécessaire pour rediriger le contenu non-HTML. Cette procédure est disponible dans la page "Installation", section "Paramétrage du descripteur de déploiement (web.xml)".
La configuration du plugin s'effectue dans le fichier de propriétés "WEB-INF/conf/plugins/webappcontainer.properties".
La configuration du serveur mandataire (proxy) s'effectue dans le fichier de configuration du plugin webappcontainer (webappcontainer.properties) grâce aux propriétés suivantes :
| Propriété | Description |
|---|---|
| webappcontainer.httpAccess.proxyHost | Proxy HTTP |
| webappcontainer.httpAccess.proxyPort | Port |
| webappcontainer.httpAccess.proxyUserName | Identifiant utilisateur |
| webappcontainer.httpAccess.proxyPassword | Mot de passe |
| webappcontainer.httpAccess.hostName | Nom complet de l'ordinateur hébergeant le conteneur de webapp |
| webappcontainer.httpAccess.domainName | Domaine de l'ordinateur hébergeant le conteneur de webapp |
| webappcontainer.httpAccess.realm | Gestionnaire de liste d'utilisateurs / mots de passe |
Le timeout peut être configuré à deux niveaux :
| Propriété | Description |
|---|---|
| webappcontainer.httpAccess.timeoutConnection | Paramétrage du timeout au niveau de la connexion |
| webappcontainer.httpAccess.timeoutSocket | Paramétrage du timeout au niveau du socket |
Un timeout défini à la valeur 0 correspond à un timeout infini.
D'autres propriétés sont également paramétrables :
| Propriété | Description |
|---|---|
| webappcontainer.jtidy.parsing.stopWhenError | Permet de stopper le parsing du code HTML dès qu'une erreur est trouvée (par exemple, une balise HTML non fermée) |
| webappcontainer.rebuildHtmlPage.includeCSS | Permet d'inclure les styles CSS (balises <link> et <style>) dans le <body> de la XPage Lutèce. Cette propriété n'est prise en compte que si l'option "Reconstruire la page HTML" est activée. |
Par défaut, il est préférable de laisser ces options à la valeur false.
