164 lines
5 KiB
Markdown
164 lines
5 KiB
Markdown
# Documentation des Modèles d'Intégration UniFi
|
|
|
|
Ce document décrit les modèles de données utilisés dans le module d'intégration UniFi pour Odoo 17.0.
|
|
|
|
## Modèles Principaux
|
|
|
|
### Site UniFi (`udm.site`)
|
|
|
|
Représente un site UniFi géré par un UDM/UDR ou un contrôleur logiciel.
|
|
|
|
**Champs:**
|
|
- `name` (Char): Nom du site
|
|
- `site_id` (Char): Identifiant du site dans UniFi (toujours 'default')
|
|
- `description` (Text): Description du site
|
|
- `address` (Text): Adresse physique
|
|
- `active` (Boolean): Statut actif
|
|
- `controller_type` (Selection): Type de contrôleur (UDM/UDR, Software)
|
|
- `host` (Char): Adresse IP ou nom d'hôte du contrôleur
|
|
- `port` (Integer): Numéro de port (par défaut: 443)
|
|
- `username` (Char): Nom d'utilisateur pour l'authentification
|
|
- `password` (Char): Mot de passe pour l'authentification
|
|
- `mfa_token` (Char): Code d'authentification à deux facteurs
|
|
- `timestamp` (Datetime): Horodatage de la dernière mise à jour
|
|
- `raw_data` (Text): Données de configuration brutes au format JSON
|
|
|
|
**Relations:**
|
|
- `system_info_id` (Many2one): Informations système
|
|
- `network_ids` (One2many): Configurations réseau
|
|
- `vlan_ids` (One2many): Configurations VLAN
|
|
- `device_ids` (One2many): Appareils connectés
|
|
- `user_ids` (One2many): Comptes utilisateur
|
|
- `settings_id` (Many2one): Paramètres généraux
|
|
- `firewall_rule_ids` (One2many): Règles de pare-feu
|
|
- `port_forward_ids` (One2many): Règles de redirection de port
|
|
- `dns_config_id` (Many2one): Configuration DNS
|
|
- `routing_config_id` (Many2one): Configuration de routage
|
|
- `dashboard_ids` (One2many): Métriques du tableau de bord
|
|
- `statistic_ids` (One2many): Statistiques
|
|
|
|
## Modèles de Réseau
|
|
|
|
### Network (`udm.network`)
|
|
|
|
Représente une configuration réseau.
|
|
|
|
**Champs:**
|
|
- `name` (Char): Nom du réseau
|
|
- `purpose` (Selection): Objectif du réseau (entreprise, invité, etc.)
|
|
- `subnet` (Char): Sous-réseau
|
|
- `vlan_enabled` (Boolean): Statut VLAN
|
|
- `vlan_id` (Integer): Identifiant VLAN
|
|
- `dhcp_enabled` (Boolean): Statut DHCP
|
|
- `dhcp_start` (Char): Adresse de début DHCP
|
|
- `dhcp_stop` (Char): Adresse de fin DHCP
|
|
- `domain_name` (Char): Nom de domaine du réseau
|
|
- `raw_data` (Text): Données réseau brutes
|
|
|
|
### VLAN (`udm.vlan`)
|
|
|
|
Stocke la configuration VLAN.
|
|
|
|
**Champs:**
|
|
- `vlan_id` (Integer): Identifiant VLAN
|
|
- `name` (Char): Nom du VLAN
|
|
- `raw_data` (Text): Données VLAN brutes
|
|
|
|
## Modèles de Sécurité
|
|
|
|
### Firewall Rule (`udm.firewall.rule`)
|
|
|
|
Définit les règles du pare-feu.
|
|
|
|
**Champs:**
|
|
- `name` (Char): Nom de la règle
|
|
- `description` (Text): Description de la règle
|
|
- `action` (Selection): Action (accepter, rejeter, bloquer)
|
|
- `protocol` (Char): Protocole réseau
|
|
- `source` (Char): Adresse/réseau source
|
|
- `destination` (Char): Adresse/réseau de destination
|
|
- `enabled` (Boolean): Statut de la règle
|
|
- `raw_data` (Text): Données de règle brutes
|
|
|
|
### Port Forward (`udm.port.forward`)
|
|
|
|
Définit les règles de redirection de port.
|
|
|
|
**Champs:**
|
|
- `name` (Char): Nom de la règle
|
|
- `enabled` (Boolean): Statut de la règle
|
|
- `src_port` (Char): Port source
|
|
- `dst_port` (Char): Port de destination
|
|
- `protocol` (Selection): Protocole (TCP, UDP, les deux)
|
|
- `dst_address` (Char): Adresse de destination
|
|
- `raw_data` (Text): Données de règle brutes
|
|
|
|
## Modèles Système
|
|
|
|
### System Info (`udm.system.info`)
|
|
|
|
Stocke les informations système de l'UDM Pro.
|
|
|
|
**Champs:**
|
|
- `hostname` (Char): Nom d'hôte du système
|
|
- `version` (Char): Version du firmware
|
|
- `model` (Char): Modèle de l'appareil
|
|
- `uptime` (Integer): Temps de fonctionnement
|
|
- `serial` (Char): Numéro de série
|
|
- `mac_address` (Char): Adresse MAC
|
|
- `raw_data` (Text): Données système brutes
|
|
|
|
### Settings (`udm.settings`)
|
|
|
|
Stocke les paramètres généraux de l'UDM Pro.
|
|
|
|
**Champs:**
|
|
- `timezone` (Char): Fuseau horaire du système
|
|
- `ntp_servers` (Char): Liste des serveurs NTP
|
|
- `dns_servers` (Char): Liste des serveurs DNS
|
|
- `raw_data` (Text): Données de paramètres brutes
|
|
|
|
### DNS Config (`udm.dns.config`)
|
|
|
|
Stocke la configuration DNS.
|
|
|
|
**Champs:**
|
|
- `enabled` (Boolean): Statut du service DNS
|
|
- `filters_enabled` (Boolean): Statut du filtrage de contenu
|
|
- `custom_dns` (Char): Serveurs DNS personnalisés
|
|
- `raw_data` (Text): Configuration DNS brute
|
|
|
|
### Routing Config (`udm.routing.config`)
|
|
|
|
Stocke la configuration de routage.
|
|
|
|
**Champs:**
|
|
- `ospf_enabled` (Boolean): Statut OSPF
|
|
- `static_routes` (Text): Liste des routes statiques
|
|
- `raw_data` (Text): Données de routage brutes
|
|
|
|
## Modèles Utilisateur
|
|
|
|
### User (`udm.user`)
|
|
|
|
Représente un compte utilisateur UniFi.
|
|
|
|
**Champs:**
|
|
- `name` (Char): Nom d'utilisateur
|
|
- `email` (Char): Adresse email
|
|
- `role` (Char): Rôle de l'utilisateur
|
|
- `enabled` (Boolean): Statut du compte
|
|
- `raw_data` (Text): Données utilisateur brutes
|
|
|
|
### Device (`udm.device`)
|
|
|
|
Représente un appareil réseau.
|
|
|
|
**Champs:**
|
|
- `name` (Char): Nom de l'appareil
|
|
- `mac` (Char): Adresse MAC
|
|
- `ip` (Char): Adresse IP
|
|
- `device_type` (Char): Type d'appareil
|
|
- `model` (Char): Modèle de l'appareil
|
|
- `last_seen` (Datetime): Dernier horodatage de connexion
|
|
- `raw_data` (Text): Données de l'appareil brutes
|