3,054
edits
Changes
Jump to navigation
Jump to search
Line 1:
Line 1: − + + + + + + + + + + + + + + + Line 8:
Line 22: + + + − + Line 17:
Line 34: − + − + − − === Pré-requis === − − * SME Server 8 ou 9 (non testé et non supporté sur SME 7) − * Vous devez configurer les dépôts [[Epel]] et [[Fws]] Line 32:
Line 44: − + − + − Executez simplement les commandes suivantes pour lancer l'installation :+ + + + + + + + + + + + + + − + − + Line 49:
Line 74: − + − + Line 56:
Line 81: − + − + − + Line 68:
Line 93: − Pour desactiver cette mise à jour automatique :+ − + − + − + − + − + Line 89:
Line 114: − + − + − + Line 117:
Line 142: − + − + Line 137:
Line 162: − + + + − Vous pouvez trouver la SRPM dans notre dépôt ici : http://repo.firewall-services.com/centos/5/SRPMS/+ − Vous pouvez aussi consulter les sources et cloner la contrib sur notre dépôt GIT ici : https://gitweb.firewall-services.com/?p=smeserver-webfilter;a=summary − + + − L'interface de contrôle est traduit en Anglais, Français, Allemand et Italien.+ − Pour l'instant, cette contrib n'est pas disponible pour la traduction en pootle (parce qu'elle est dans notre propre repo GIT). − Si vous voulez aider à la traduction, traduisez le fichier [https://gitweb.firewall-services.com/?p=smeserver-webfilter;a=blob_plain;f=root/etc/e-smith/locale/en-us/etc/e-smith/web/functions/webfilter /etc/e-smith/locale/en-us/etc/e-smith/web/functions/webfilter] et renvoyez nous directement le fichier à l'adresse '''tech @ firewall-services . com'''+ − {{#bugzilla:columns=id,product,version,status,summary |sort=id|order=desc |component=smeserver-webfilter|noresultsmessage="No open bugs found."}}+ −
no edit summary
{{Languages|WebFiltering}}
{{Languages|WebFilter}}
{{#vardefine:contribname| {{lc: {{#titleparts: {{BASEPAGENAME}} |1}} }} }} {{#vardefine:smecontribname| smeserver-{{lc: {{#titleparts: {{BASEPAGENAME}} |1}} }} }} {{#vardefine:lang| {{lc: {{#titleparts: {{PAGENAME}} | | -1}} }} |en }}{{Infobox contribs
|name={{#var:contribname}}
|image={{#var:contribname}}.png
|description_image= {{#var:contribname}} logo
|maintainer=Unnilennium
|url=http://www.squidguard.org/
|licence={{#show: {{PAGENAME}}
|?Rpm licence
}}
|category= filtering
|tags=squid,proxy,cache,filter,http,https
}}The rpm summary indicates: {{#show: {{PAGENAME}}
|?Rpm summary
}}
=== Mainteneur ===
=== Mainteneur ===
=== Version ===
=== Version ===
{{ #smeversion: smeserver-webfilter }}
{{ #smeversion: smeserver-webfilter }}
{{ #smeversion: squidGuard }}
{{ #smeversion: squidclamav }}
[[Version::contrib9|fws]][[Has SME9::true| ]]
=== Description ===
=== Description ===
Cette contribs apporte 3 nouvelles fonctionnalités au proxy squid et fournit une interface pour en contrôler la plus part:
Cette contribution apporte 3 nouvelles fonctionnalités au proxy squid et fournit une interface pour en contrôler la plupart :
*Filtrage d'URL (avec [http://squidguard.org/ squidGuard])
*Filtrage d'URL (avec [http://squidguard.org/ squidGuard])
*Filtrage Antivirus (avec [http://squidclamav.darold.net/ squidclamav])
*Filtrage Antivirus (avec [http://squidclamav.darold.net/ squidclamav])
Lorsque cette fonction est activée, tout le trafic web sera analysé avant d'être envoyé au client.
Lorsque cette fonction est activée, tout le trafic web sera analysé avant d'être envoyé au client.
*Log des requêtes dans une base de données MySQL.
*Log des requêtes dans une base de données MySQL
Toutes les requêtes passant par Squid sont journalisées dans une base de données, ce qui rend l'analyse plus facile. Il n'y a pas d'interface pour consulter ces journaux, mais vous pouvez utiliser votre client MySQL préféré pour voir quels domaines sont les plus visités, l'utilisateur qui utilise toute votre bande passante, etc ...
Toutes les requêtes passant par Squid sont journalisées dans une base de données, ce qui rend l'analyse plus facile. Il n'y a pas d'interface pour consulter ces journaux, mais vous pouvez utiliser votre client MySQL préféré pour voir quels domaines sont les plus visités, l'utilisateur qui utilise toute votre bande passante, etc ...
Cette contrib peut remplacer Dansguardian si vous avez des besoins simples en terme de filtrage. Elle est vraiment facile à configurer, mais également moins puissante. Dansguardian filtre le contenu (il scan le contenu des pages pour déterminer si elle doit être bloquée ou non), alors que squidGuard ne regarde que l'URL par exemple.
Cette contribution peut remplacer Dansguardian si vous avez des besoins simples en terme de filtrage. Elle est vraiment facile à configurer, mais également moins puissante. Dansguardian filtre le contenu (il scanne le contenu des pages pour déterminer si elle doit être bloquée ou non), alors que squidGuard ne regarde que l'URL par exemple.
=== Captures d'écrans ===
=== Captures d'écrans ===
[[File:Webfilter_2.png|webfilter panel]]
[[File:Webfilter_2.png|webfilter panel]]
=== Installation 8.x et 9.x===
=== Installation===
<tabs container><tab name="Pour SME 10">
yum install --enablerepo=smecontribs smeserver-webfilter
</tab><tab name="Pour SME 9 ">
Pour installer la contribution, exécutez simplement les commandes suivantes :
yum install smeserver-extrarepositories-fws smeserver-extrarepositories-epel -y
signal-event yum-modify
yum --enablerepo=epel --enablerepo=fws install smeserver-webfilter
signal-event http-proxy-update
expand-template /etc/httpd/conf/httpd.conf
sv t /service/httpd-e-smith
</tab><tab name="Pour SME 8">
first install [[fws]] and [[epel]] repo
Pour installer la contribution, exécutez simplement les commandes suivantes :
yum --enablerepo=epel --enablerepo=fws install smeserver-webfilter
yum --enablerepo=epel --enablerepo=fws install smeserver-webfilter
signal-event http-proxy-update
signal-event http-proxy-update
expand-template /etc/httpd/conf/httpd.conf
expand-template /etc/httpd/conf/httpd.conf
sv t /service/httpd-e-smith
sv t /service/httpd-e-smith
</tab>
</tabs>
Vous pouvez à présent avoir accès à la nouvelle interface de contrôle dans le Server-Manager.
Vous pouvez à présent avoir accès à la nouvelle interface de contrôle dans le gestionnaire du serveur.
Lors de votre premier accès, vous remarquerez que la liste des catégories est vide. Cliquez juste sur le bouton '''Enregistrer''' en bas de la page, attendez quelques minutes et recommencez (la liste est vide car les categories n'ont pas encore été téléchargées).
Lors de votre premier accès, vous remarquerez que la liste des catégories est vide. Cliquez seulement sur le bouton '''Enregistrer''' en bas de la page, attendez quelques minutes et recommencez (la liste est vide car les categories n'ont pas encore été téléchargées).
A présent, vous devriez être en mesure d'activer le filtrage d'URL et le filtrage AV, ainsi que les categories que vous souhaitez bloquer.
A présent, vous devriez être en mesure d'activer le filtrage d'URL et le filtrage AV, ainsi que les categories que vous souhaitez bloquer.
=== Logithèques et filtrage AV ===
=== Logithèques et filtrage AV ===
Quand le filtrage AV est activé, le moteur de l'antivirus remplace le UserAgent du client par le sien, ce qui peut empêcher l'accès à certainees sites, comme l'appStore pour iOS ou le Google Play pour Android.
Quand le filtrage AV est activé, le moteur de l'antivirus remplace le UserAgent du client par le sien, ce qui peut empêcher l'accès à certains sites, comme l'appStore pour iOS ou le Google Play pour Android.
Pour regler ce problème, rajouter simplement ces lignes dans la liste blanche:
Pour régler ce problème, rajouter simplement ces lignes dans la liste blanche :
clients.google.com
clients.google.com
*.phobos.apple.com
*.phobos.apple.com
Une fois dans la liste blanches, ces sites ne seront plus soumis an scan antivirus
Une fois dans la liste blanche, ces sites ne seront plus soumis au scan antivirus.
=== Personalisation de la liste des catégories ===
=== Personnalisation de la liste des catégories ===
Les listes des catégoies sont de simples fichiers texte stockés dans /var/squidGuard/blacklists. Chaque catégorie étant un dossier contenant un fichier '''domains''' et un '''urls'''.
Les listes des catégoies sont de simples fichiers texte stockés dans /var/squidGuard/blacklists. Chaque catégorie étant un dossier contenant un fichier '''domains''' et un '''urls'''.
Chaque catégorie apparaîtra dans le panel du server-manager, sauf si elle est listée dans la clé DisabledCategories. Vous pouvez voir les categories desactivées avec la commande :
Chaque catégorie apparaîtra dans le paneau du gestionnaire du serveur, sauf si elle est listée dans la clé DisabledCategories. Vous pouvez voir les catégories desactivées avec la commande :
db configuration getprop squidguard DisabledCategories
db configuration getprop squidguard DisabledCategories
La configuration par defaut met à jour toutes les catégories chaque nuit. Cette mise à jour est lancée par la tâche cron /etc/cron.daily/squidGuard qui appelle le script /etc/e-smith/events/actions/squidguard-update-databases.
La configuration par defaut met à jour toutes les catégories chaque nuit. Cette mise à jour est lancée par la tâche cron /etc/cron.daily/squidGuard qui appelle le script /etc/e-smith/events/actions/squidguard-update-databases.
Si vous ne voulez pas des mises à jour automatiques de ces listes, vous pouvez désactiver cette fonctionnalité :
db configuration setprop squidguard AutoUpdate disabled
db configuration setprop squidguard AutoUpdate disabled
Vous pouvez ajouter vos propres categories. Si elles n'existes pas encore, elles ne seront pas supprimées ou modifiées par la mise à jour automatique.
Vous pouvez ajouter vos propres catégories. Si elles n'existent pas encore, elles ne seront pas supprimées ou modifiées par la mise à jour automatique.
=== Page "Accès refusé" ===
=== Page « Accès refusé »===
La configuration par défaut redirige les accès refusés sur la page https://sme.domain.tld/squidGuard/cgi-bin/blocked.cgi avec des paramètres variés (Adresse IP, Nom d'utilisateur, Groupe, Categorie, etc ...).
La configuration par défaut redirige les accès refusés sur la page https://sme.domain.tld/squidGuard/cgi-bin/blocked.cgi avec des paramètres variés (Adresse IP, Nom d'utilisateur, Groupe, Categorie, etc ...).
Le nom d'utilisateur ne sera pas connu (remplacé par -) si l'authentification Squid est désactivée (ce qui est le cas par défaut). Si vous activez l'authentification Squid (avec un templates-custom), vous serez en mesure d'afficher le nom d'utilisateur. L'inconvénient est que vous aurez à configurer tous vos navigateurs à utiliser Squid comme serveur mandataire, car l'authentification n'est pas compatible avec le proxy transparent.
Le nom d'utilisateur ne sera pas affiché (remplacé par -) si l'authentification Squid est désactivée (ce qui est le cas par défaut). Si vous activez l'authentification Squid (avec un templates-custom), vous serez en mesure d'afficher le nom d'utilisateur. L'inconvénient est que vous aurez à configurer tous vos navigateurs à utiliser Squid comme serveur mandataire, car l'authentification n'est pas compatible avec le proxy transparent.
Vous pouvez personnaliser la page d'accès interdit, pour commencer, copiez la page par defaut :
Vous pouvez personnaliser la page d'accès refusé, pour commencer, copiez la page par defaut :
cp -a /usr/share/squidGuard/cgi-bin/blocked.cgi /usr/share/squidGuard/cgi-bin/custom.cgi
cp -a /usr/share/squidGuard/cgi-bin/blocked.cgi /usr/share/squidGuard/cgi-bin/custom.cgi
Maintenant, vous pouvez editer cette nouvelle page en fonction de vos besoins. Ensuite, il vous faut selectionner cette nouvelle page dans la configuration :
Maintenant, vous pouvez éditer cette nouvelle page en fonction de vos besoins. Ensuite, il vous faut selectionner cette nouvelle page dans la configuration :
db configuration setprop squidguard RedirectURL \
db configuration setprop squidguard RedirectURL \
signal-event http-proxy-update
signal-event http-proxy-update
=== Logs MySQL ===
=== Journaux MySQL ===
La journalisation des accès dans la base MySQL est assurée par un démon indépendant appelé squid-db-logd. Il surveille le journal des accès Squid et Squidguard en temps réel, l'analyse et enregistre les entrées dans la base squid_log.
La journalisation des accès dans la base MySQL est assurée par un démon indépendant appelé squid-db-logd. Il surveille le journal des accès Squid et Squidguard en temps réel, l'analyse et enregistre les entrées dans la base squid_log.
Dans cette base de données, la table access_log liste tous les accès tandi que le deny_log ne liste que les accès bloqués. Cette fonctionnalité peut nécessiter beaucoup d'espace disque. Sur un serveur à forte charge, vous pouvez facilement atteindre 3 Go/mois seulement pour la base de données (et plus pour les dumps quand vous sauvegardez votre serveur). Pour limiter l'espace nécessaire, une tâche cron permet de supprimer les entrées les plus anciennes. La configuration par défaut conserve un an de journaux. Vous pouvez modifier ce réglage avec la commande suivante (la valeur par defaut est de 365 jours) :
Dans cette base de données, la table access_log liste tous les accès tandis que la deny_log ne liste que les accès bloqués. Cette fonctionnalité peut nécessiter beaucoup d'espace disque. Sur un serveur à forte charge, vous pouvez facilement atteindre 3 Go/mois seulement pour la base de données (et plus pour les dumps quand vous sauvegardez votre serveur). Pour limiter l'espace nécessaire, une tâche cron permet de supprimer les entrées les plus anciennes. La configuration par défaut conserve un an de journaux. Vous pouvez modifier ce réglage avec la commande suivante (la valeur par defaut est de 365 jours) :
db configuration setprop squid-db-logd Retention 180
db configuration setprop squid-db-logd Retention 180
Si vous souhaitez desactiver complétement cette fonction, vous pouvez stoper ce service :
Si vous souhaitez désactiver complétement cette fonction, vous pouvez stoper ce service :
db configuration setprop squid-db-logd status disabled
db configuration setprop squid-db-logd status disabled
FROM access_log WHERE client_ip='192.168.7.50' AND date_day='2012-10-08' AND date_time>'22:00:00' AND date_time<'23:00:00';" mysql squid_log
FROM access_log WHERE client_ip='192.168.7.50' AND date_day='2012-10-08' AND date_time>'22:00:00' AND date_time<'23:00:00';" mysql squid_log
=== Désintalation ===
=== Désinstallation ===
Pour désinstaler cette contribs, executez les commandes suivantes :
Pour désinstaller cette contribution, exécutez les commandes suivantes :
yum remove squidGuard squidclamav
yum remove squidGuard squidclamav
rm -f /etc/squidclamav.conf
rm -f /etc/squidclamav.conf
=== Sources ===
===Bogues===
Merci de faire parvenir les problèmes à la section SME-Contribs sur [http://bugs.contribs.org/enter_bug.cgi bugzilla]
en sélectionnant le composant {{#var:smecontribname}} ou en utilisant {{BugzillaFileBug|product=SME%20Contribs|component={{#var:smecontribname}}|title=ce lien.}}
Un aperçu des problèmes en cours pour cette contribution figure ci-dessous :{{#bugzilla:columns=id,product,version,status,summary|sort=id|order=desc|component={{#var:smecontribname}} |noresultsmessage=No open bugs found.}}
=== Traduction ===
= Journal des modifications =
Seules les versions publiées dans smecontrib sont listées ici.
{{#smechangelog:{{#var:smecontribname}}}}
[[Category:Contrib/fr]]
[[Category:Contrib:webfiltering]]
[[Category:Contrib]]