8
0
Fork 0
mirror of https://gitlab2.federez.net/re2o/re2o synced 2024-11-05 01:16:27 +00:00
No description
Find a file
chirac 7b73f5a63b Merge branch 'hotfix-mail-field-in-user-forms' into 'dev'
Remet le field email dans UserForm et AdherentForm

See merge request federez/re2o!219
2018-08-05 22:57:24 +02:00
api serialization des finfos pour créer les home 2018-08-05 17:24:26 +02:00
cotisations Fix shit 2018-07-23 21:41:30 +00:00
docs_utils Graph re2o sources dia (archi) 2017-10-12 20:03:38 +02:00
freeradius_utils Placement des machines sur un vlan en fonction de leur classe type 2018-08-03 18:08:33 +02:00
install_utils Add token authentication with expiration of tokens 2018-06-20 11:38:58 +00:00
logs Passage par flags plutôt que par valeurs 2018-07-20 19:54:03 +02:00
machines Merge branch 'firewall_export' into 'dev' 2018-08-05 21:07:12 +02:00
preferences [preferences/EditAssoOptionForm] commits c1f55e797 and 78b950c39 removed references to payment. This form was forgotten. 2018-08-03 10:24:42 +02:00
re2o login handler: Use constant-time comparaison for hashes. 2018-08-04 22:57:03 +02:00
search Fix langue et 802.X radius + divers 2018-08-02 20:43:35 +02:00
static mise en page pour les longues fingerpint ssh 2018-07-29 19:15:28 +00:00
templates fichiers oubliés 2018-08-01 18:52:42 +02:00
test_utils Add tests for details of instances of every models 2018-06-22 00:48:45 +00:00
topologie Suppression des migrations précédemment fusionnées. 2018-08-04 09:54:17 +02:00
users Merge branch 'hotfix-mail-field-in-user-forms' into 'dev' 2018-08-05 22:57:24 +02:00
.gitignore Stockage en BDD des identifiants comnpay. 2018-01-28 08:55:37 +01:00
.gitlab-ci.yml Update .gitlab-ci.yml 2017-12-17 16:31:21 +01:00
apt_requirements.txt Fix #127 and remove duplicate migration 2018-05-28 10:03:15 +00:00
CHANGELOG.md TODO : offrir des cours d'anglais au cr@ns. 2018-08-02 23:29:58 +02:00
install_re2o.sh Utilise des fichiers de requirements 2018-05-23 15:31:58 +00:00
LICENSE Add license file (GPLv2) 2017-01-15 18:00:42 -05:00
manage.py initial comit 2016-06-30 01:39:31 +02:00
pip_dev_requirements.txt Pip requirements for dev are in a separate file 2018-06-23 16:02:58 +00:00
pip_requirements.txt Pip requirements for dev are in a separate file 2018-06-23 16:02:58 +00:00
README.md Update changelog and readme 2018-05-23 15:31:58 +00:00

Re2o

Gnu public license v2.0

Avant propos

Re2o est un logiciel d'administration développé initiallement au rezometz. Il se veut agnostique au réseau considéré, de manière à être installable en quelques clics.

Il utilise le framework django avec python3. Il permet de gérer les adhérents, les machines, les factures, les droits d'accès, les switchs et la topologie du réseau. De cette manière, il est possible de pluguer très facilement des services dessus, qui accèdent à la base de donnée en passant par django (ex : dhcp), en chargeant la liste de toutes les mac-ip, ou la liste des mac-ip autorisées sur le réseau (adhérent à jour de cotisation).

Installation

Un tutoriel pour installer le projet est disponible sur le wiki.

Installations Optionnelles

Générer le schéma des dépendances

Pour cela :

  • apt install python3-django-extensions
  • python3 manage.py graph_models -a -g -o re2o.png

Fonctionnement interne

Fonctionnement général

Re2o est séparé entre les models, qui sont visible sur le schéma des dépendances. Il s'agit en réalité des tables sql, et les fields etant les colonnes. Ceci dit il n'est jamais nécessaire de toucher directement au sql, django procédant automatiquement à tout cela. On crée donc différents models (user, right pour les droits des users, interfaces, IpList pour l'ensemble des adresses ip, etc)

Du coté des forms, il s'agit des formulaire d'édition des models. Il s'agit de ModelForms django, qui héritent des models très simplement, voir la documentation django models forms.

Enfin les views, générent les pages web à partir des forms et des templates.

Fonctionnement avec les services

Les services dhcp.py, dns.py etc accèdent aux données via des vues rest. Celles-ci se trouvent dans machines/views.py. Elles sont générées via machines/serializers.py qui génère les vues. IL s'agit de vues en json utilisées par re2o-tools pour récupérer les données. Il est nécessaire de créer un user dans re2o avec le droit serveur qui permet d'accéder à ces vues, utilisé par re2o-tools.

Requète en base de donnée

Pour avoir un shell, il suffit de lancer '''python3 manage.py shell''' Pour charger des objets, example avec User, faire : ''' from users.models import User''' Pour charger les objets django, il suffit de faire User.objects.all() pour tous les users par exemple. Il est ensuite aisé de faire des requètes, par exemple User.objects.filter(pseudo='test') Des exemples et la documentation complète sur les requètes django sont disponible sur le site officiel.