====== Utilisation de php-IPAM ======

Tableau de bord affiché lors de la connexion à php-IPAM :

{{:phpipam-dashboard.png?1000|Tableau de bord php-IPAM}}


===== Configuration globale =====

Pour accèder aux paramètres de l'application, ouvrir le menu ''Administration'' :

{{ ::phpipam-config.png?250 |Menu d'administration de php-IPAM}}

Pour paramètrer l'authentification via un annuaire externe (LDAP, Radius, AD...), aller à l'onglet ''Authentication methods'' et cliquer sur ''Create New'':

{{ ::phpipam-configauth.png?400 |Ajouter une méthode d'authentification}}

Pour créer ou importer des utilisateurs, aller dans l'onglet ''Users'' puis cliquer sur ''Create user'' :

{{ ::phpipam-configusers.png?700 |Ajout d'utilisateurs}}

Pour ajouter des groupes, aller dans l'onglet ''Groups''.

Pour configurer l'envoi de mail, renseigner les paramètres SMTP dans l'onglet ''Mail settings'' :

{{ ::phpipam-configsmtp.png?700 |Paramètres SMTP}}

===== Gestion des réseaux et des VLANs =====

Depuis le tableau de bord, afficher les différentes sections en allant dans ''Subnets > All sections'' :

{{ ::phpipam-subnetsmenu.png?300 |Menu des sous-réseaux}}

Les sections permettent d'organiser la gestion des sous-réseaux (par client, par localisation, etc...). On peut créer de nouvelles sections ou les modifier dans ''Administration > Sections'' :

{{ ::phpipam-sectionsedit.png?700 |Modification d'une section}}

Il est conseillé de désactiver le //mode strict// dans le cas où on utiliserai la technique VLSM pour calculer les adresses de sous-réseaux.

Depuis la page d'une section, on peut ajouter des sous-réseaux en cliquant sur ''Add Subnet''. On obtient donc une interface comme celle-ci :

{{ ::phpipam-createsubnet.png?700 |Créer un nouveau sous-réseau}}

  * Dans le cadre rouge, entrer une adresse réseau au format CIDR (xxx.xxx.xxx.xxx/xx)
  * Dans le cadre bleu, séléctionner un VLAN Associé au sous-réseau
  * Dans le cadre vert, séléctionner un sous-réseau parent
  * Ne pas oublier de mettre une description au sous-réseau

On peut créer des VLANs pendant la création d'un sous-réseau, en séléctionnant ''Add VLAN'' dans le menu déroulant //VLAN//. 
La gestion des VLAN se fait sur la page //VLANs// disponible depuis le menu en haut :

{{ ::phpipam-menu2.png?550 |Menu de php-IPAM}}
===== Gestion des hôtes dans l'inventaire =====

Pour ajouter des équipements dans l'inventaire, aller dans le menu des appareils :

{{ ::phpipam-menu.png?550 |Menu de php-IPAM}}

Ensuite cliquer sur ''Manage'' pour modifier la liste : 

{{ ::phpipam-configdevices.png?400 |Liste des hôtes}}

Puis cliquer sur ''Add Device'' pour configurer un nouvel équipement. Ce que cela doit donner :

{{ :phpipam-newdevices.png?400 | Ajout d'un nouvel équipement}}

Attention : les équipements ajoutés de cette manière ne sont pas affectés aux sous-réseau créé dans la partie ''subnets''. Pour cela, voir la section suivante.

===== Affecter des hôtes dans les sous-réseau =====

Pour affecter des hôtes à un sous-réseau, il faudra aller dans ''subnets > All sections'', puis dans la section concernée, cliquer sur un sous-réseau. Descendre pour trouver la liste des adresses IP du sous-réseau :

{{ ::phpipam-visualsubnetdisplay.png?550 |Liste des adresses IP du sous-réseau concerné}}

Enfin, cliquer sur une adresse IP pour lui attribuer un appareil existant dans l'inventaire (champ Device) :

{{ :phpipam-confighost.png?400 | Attribuer un hôte à une adresse IP}}

Le bouton ''Check availability'' permet de lancer un ping à l'hôte pour vérifier qu'il est bien connecté

===== Autres fonctions =====

  * On peut aussi inventorier les racks en allant dans ''Administration > Racks''
  * La gestion des DNS se fait dans ''Administration > Nameservers''
  * La gestion des différents lieux (sites physiques) se fait dans ''Administration > Locations''
  * Un agent php-IPAM peut être déployé sur les machines afin de scanner le réseau et d'inventorier automatiquement les équipements dessus ([[https://github.com/phpipam/phpipam-agent|voir ici]]).