PHPackages                             edno/kleis - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Admin Panels](/categories/admin)
4. /
5. edno/kleis

AbandonedArchivedProject[Admin Panels](/categories/admin)

edno/kleis
==========

Squid Guard Basic Front End

1.2(9y ago)3282[10 issues](https://github.com/edno/kleis/issues)[5 PRs](https://github.com/edno/kleis/pulls)MITJavaScriptPHP &gt;=5.5.9

Since Oct 16Pushed 6y ago1 watchersCompare

[ Source](https://github.com/edno/kleis)[ Packagist](https://packagist.org/packages/edno/kleis)[ RSS](/packages/edno-kleis/feed)WikiDiscussions develop Synced yesterday

READMEChangelog (3)Dependencies (10)Versions (10)Used By (0)

Kleːs - ![Release](https://camo.githubusercontent.com/4e6e920daf00c36ff76109603d087de7bc0dce8ca4cff2c51acb3f2aaf4b53b6/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f65646e6f2f6b6c6569732e7376673f7374796c653d666c61742d737175617265) [![Build Status](https://camo.githubusercontent.com/7f7f0c3f7843825e23a31111a5c3b5237a711899b99a5f2e1ebac74955813925/68747470733a2f2f696d672e736869656c64732e696f2f7472617669732f636f6d2f65646e6f2f6b6c6569732e7376673f7374796c653d666c61742d737175617265)](https://travis-ci.com/edno/kleis) [![Code Quality](https://camo.githubusercontent.com/2e1f1b84be23664f18bc534b81c863b09002ca6aa7c2d11d32e7c80babc96a75/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f672f65646e6f2f6b6c6569732e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/edno/kleis/) [![FOSSA Status](https://camo.githubusercontent.com/1c7a49d136d1bcd4de4ddf0c4e10bfec9a53826d7b43430a54dc61ce3491f840/68747470733a2f2f6170702e666f7373612e696f2f6170692f70726f6a656374732f6769742532426769746875622e636f6d25324665646e6f2532466b6c6569732e7376673f747970653d736869656c64)](https://app.fossa.io/projects/git%2Bgithub.com%2Fedno%2Fkleis?ref=badge_shield)
=======================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================

[](#kleːs------)

Kleis est un gestionnaire d'utilisateurs et groupes pour proxy de type Squid. Il permet aussi de gérer une liste blanche pour le filtre SquidGuard. Kleis maintient à jour la liste de vos utilisateurs et leur appartenance à un groupe, dans une base de données. Il est ensuite possible d'exporter ces informations sous forme de fichiers plats pour être intégrés à la configuration de Squid et de SquidGuard.

Ainsi, pour une gestion évoluée d'un ensemble d'utilisateurs de votre proxy, vous n'avez pas la nécessité d'utiliser un annuaire LDAP.

Kleis exporte les fichiers suivants :

- Fichier de mot de passe, de type htaccess, tel qu'utilisé par Squid dans ce mode d'authentification
- Fichiers de categories (par exemple, mineur, majeur, salarié, professeur...), pour être utilisés dans SquidGuard
- Fichiers de groupes (les groupes sont gérés par des gestionnaires de groupes), pouvant également être utilisés dans SquidGuard
- Fichiers de liste blanche (domaines complets ou URLs), destiné à être ajoutés aux listes que vous utilisez avec SquidGuard

Il n'est pas nécessaire de disposer de Squid et SquidGuard sur le même serveur que Kleis. Peu importe votre mise en oeuvre, il vous faudra à un moment positionner les fichiers générés par Kleis aux bons endroits. Un exemple d'intégration est donné dans la documentation de Kleis.

Installation
------------

[](#installation)

Voir [installation](https://github.com/edno/kleis/wiki/Installation) dans le Wiki.

Intégration avec Squid et SquidGuard
------------------------------------

[](#intégration-avec-squid-et-squidguard)

Ce qui suit suppose que vous disposiez d'une installation Squid, couplée à SquidGuard fonctionnelle. Vous devriez avoir quelque chose comme `auth\_param basic program /usr/lib/squid3/basic\_ncsa\_auth /etc/squid3/passwords`` dans votre fichier squid.conf.

### Exporter les fichiers

[](#exporter-les-fichiers)

**Kleis** permet d'exporter les fichiers utiles par le lancement d'une commande. Les commandes suivantes :

```
cd /var/www/kleis
php artisan export:accounts
php artisan export:categories
php artisan export:groups
php artisan export:whitelist
```

génèrent respectivement les comptes utilisateurs, les catégories, les groupes, et les fichiers de liste blanche. Ces fichiers sont générés dans `/var/www/kleis/storage/app/export/`, vous devez donc rendre ce repertoire modifiable par l'utilisateur. Dans la suite de l'exemple nous n'utilisons pas les groupes.

Il faut ensuite déplacer les fichiers aux bons endroits :

```
cp /var/www/kleis/storage/app/export/accounts/accounts.txt /etc/squid3/passwords
cp /var/www/kleis/storage/app/export/categories/*.txt /var/lib/squidguard/db/
cp /var/www/kleis/storage/app/export/proxylists/*.txt /var/lib/squidguard/db/
```

Vous devriez à ce moment là mettre à jour les blacklists de SquidGuard. Une fois cela fait, regénérez les bases de SquidGuard puis relancez Squid :

```
squidGuard -C all
/usr/sbin/service squid3 restart
```

### Points d'attention

[](#points-dattention)

Que vous fassiez l'intégration manuellement ou que vous utilisiez un ordonanceur (la crontable ou jenkins par exemple), vous devez veiller aux droits des différents fichiers :

- Le fichier password doit appartenir à l'utilisateur proxy. Pour ne pas changer cela, vous pouvez ajouter l'utilisateur de votre ordonanceur au groupe proxy, et rendre le fichier des mots de passe modifiable par le groupe.
- Les fichiers de groupe et whitelist ont les mêmes besoins. Cela est particulièrement important : si l'utilisateur du proxy ne peut pas correctement lire les fichiers, alors SquidGuard entrera en mode "Emergency", laissant passer l'intégralité du trafic.
- Pour redémarer squid3 via la commande service, vous devriez utiliser sudo. L'usage d'autres scripts pour relancer Squid pourrait modifier les propriétaires et les droits de fichiers, et empêcher une mise à jour par votre utilisateur d'ordonnanceur.

License
-------

[](#license)

[![FOSSA Status](https://camo.githubusercontent.com/85114bd5c1ce90d0ac373028bff0879727535105e915e480aee6a64506444956/68747470733a2f2f6170702e666f7373612e696f2f6170692f70726f6a656374732f6769742532426769746875622e636f6d25324665646e6f2532466b6c6569732e7376673f747970653d6c61726765)](https://app.fossa.io/projects/git%2Bgithub.com%2Fedno%2Fkleis?ref=badge_large)

Thanks for support
------------------

[](#thanks-for-support)

[![BrowserStack](public/images/browserstack-logo.png)](https://live.browserstack.com)

###  Health Score

25

—

LowBetter than 35% of packages

Maintenance0

Infrequent updates — may be unmaintained

Popularity12

Limited adoption so far

Community15

Small or concentrated contributor base

Maturity64

Established project with proven stability

 Bus Factor1

Top contributor holds 80.5% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~59 days

Total

3

Last Release

3427d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/bac1c0fc36754df981413489651483354aff2a059923108338a64f0a62405980?d=identicon)[edno](/maintainers/edno)

---

Top Contributors

[![edno](https://avatars.githubusercontent.com/u/324670?v=4)](https://github.com/edno "edno (103 commits)")[![dependabot-support](https://avatars.githubusercontent.com/u/112581971?v=4)](https://github.com/dependabot-support "dependabot-support (12 commits)")[![dependabot-preview[bot]](https://avatars.githubusercontent.com/in/2141?v=4)](https://github.com/dependabot-preview[bot] "dependabot-preview[bot] (8 commits)")[![ValentinGuerlesquin](https://avatars.githubusercontent.com/u/22875745?v=4)](https://github.com/ValentinGuerlesquin "ValentinGuerlesquin (3 commits)")[![fossabot](https://avatars.githubusercontent.com/u/29791463?v=4)](https://github.com/fossabot "fossabot (1 commits)")[![scrutinizer-auto-fixer](https://avatars.githubusercontent.com/u/6253494?v=4)](https://github.com/scrutinizer-auto-fixer "scrutinizer-auto-fixer (1 commits)")

---

Tags

frontendkleisproxysquidguarduser-managementwhitelistmanagementUsers

###  Code Quality

TestsCodeception

### Embed Badge

![Health badge](/badges/edno-kleis/health.svg)

```
[![Health](https://phpackages.com/badges/edno-kleis/health.svg)](https://phpackages.com/packages/edno-kleis)
```

###  Alternatives

[backpack/crud

Quickly build admin interfaces using Laravel, Bootstrap and JavaScript.

3.4k3.7M223](/packages/backpack-crud)[jeremykenedy/laravel-users

Laravel Users Management CRUD Package

45593.8k1](/packages/jeremykenedy-laravel-users)[statamic-rad-pack/runway

Eloquently manage your database models in Statamic.

135224.7k7](/packages/statamic-rad-pack-runway)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
