Page History

Présentation

L'onglet de configuration affiché les paramètres de configuration définie dans le fichier de configuration de votre module peut être consultés dans cet onglet ( voir la page Collecteur de type ldap-import ( pour Active Directory ) ) :

Elle est divisée en 5 chapitres :

• Configuration générale.
• Options de mélange des sources.
• Choix de l'espace où seront placé les éléments importés.
• Paramètres spécifiques à la source.
• Clé de synchronisation ( sync_key ).

Remarque : Cet onglet ne permet pas encore d'éditer la configuration ( => Sera implémenté dans une prochaine version )

Configuration générale

Ce chapitre contient tous les paramètres pour le chargement et le fonctionnement des sources en général.

source_name

Nom de la source affichée dans l'interface de configuration en page d'accueil.

 module_type

Type de module chargé par le Synchroniser. Pour cette source le module_type est "ldap-import".

import_interval

Délai écoulé entre les imports automatiques de la source. 

• Un nombre ( en minutes )
• Si 0, la source ne sera jamais exécutée automatiquement.

order

module_type 

order

import_interval

Options de mélange des sources

Mode de mélange des sources

Grace au paramètre "Mode de mélange des sources" ( merge_mode dans le fichier de configuration de la source ), il est possible de modifier la gestion d'une source lors de l'étape du mélange des sources .Voir ( voir la page Concept général et utilisation des sources ).

La valeur par défaut est : all

Les valeurs possibles sont : 

merge_mode

Détecter les nouveaux éléments

Les éléments proposés par la source sont soumis au calcul des nouveautés ( voir la page Modules de Sources ( imports ) et de Taggers ( qualification ) ).

compute_new_element

Calculer les différences

Les éléments proposés par la source sont soumis au calcul des différences ( voir la page Modules de Sources ( imports ) et de Taggers ( qualification ) ).

compute_element_difference

Suppression des éléments absents

Détecter les éléments qui ne sont plus présent dans la source

Permets de proposer en suppression, les éléments qui ne sont plus présents dans la ou les source/s.

compute_deleted_element_not
_in_source

delete_if_missing_in_this_source

Choix de l'espace où seront placé les éléments Choix de l'espace où seront placé les éléments importés

Mettre dans l'espace

Permets d'appliquer les différences et d'importer les nouveaux éléments de cette source directement en Staging ou Production ou bien de les laisser dans l'espace de calcul des sources comme par défaut.

put_in

Utilisateur utilisé pour la sauvegarde des changements

Option qui permet de choisir l'utilisateur qui apparaîtra comme étant le dernier à avoir mis à jour les éléments.

put_in_user

Clés spécifiques à la source

Ce chapitre liste tous les paramètres qui sont spécifiques au fonctionnement de cette source.

Format des fichiers JSON chargés par le module

Dans cette source, plusieurs fichiers JSON seront à configurer. Ils respectent tous le même format que voici :

• Le fichier débute par une ligne avec seulement une accolade ouvrante : {
• Toute ligne commençant par un dièse ( # ) sera considérée comme un commentaire et ne sera pas interprétée par la source
• Chaque ligne valide ( lue par la source ) est constituée de
  • le nom du paramètre entre guillemets : "nom_du_paramètre"
  • le symbole deux-points ( : ) séparant le nom du paramètre de sa valeur
  • la valeur du paramètre entre guillemets : "valeur du paramètre"
  • le symbole virgule ( , ) s'il ne s'agit pas de la dernière ligne de définition d'un paramètre.
• Le fichier se termine par une ligne avec seulement une accolade fermante : }

Accès au serveur et arborescence des données

Implémentation du protocole LDAP

Le module implémentant le protocole LDAP, il est nécessaire de lui préciser que notre source va fonctionner avec l'implémentation de Microsoft : Active Directory. Le paramètre mode doit donc être configuré sur ad pour notre source Collecteur Active Directory.

mode

Définition de l'accès au serveur

L'accès au serveur Active Directory se configure dans le fichier indiqué par le paramètre connection_configuration_file.

connection_configuration_file

Le fichier indiqué dans ce paramètre ( par défaut /etc/shinken-user/source-data/source-data-active-directory-sample/_configuration/active-directory-connection.json ) doit respecter le format des fichiers Json ( voir la page JavaScript Object Notation ). Voici les paramètres obligatoires à renseigner dans le fichier, qui permettent de définir la connexion au serveur Active Directory :

Arborescence et filtrage des données

Import des hôtes et groupes d'hôtes

Afin d'importer des hôtes et des groupes d'hôtes, il faut spécifier au module ou rechercher ces éléments dans le serveur Active Directory.

Import des contacts et groupes de contacts

Exemples

Voici un exemple de ce fichier

{
  # Mandatory
  "url": "ldap://192.168.1.240",
  "ldap_protocol":3,
  "base": "dc=shinkendom,dc=local",
  "username": "shinkendom/administrateur",
  "password": "P@ssword1",

  # Optionnal
  "hosts_base": "OU=Serveurs,dc=shinkendom,dc=local",
  "hosts_filter": "(|(objectClass=device)(objectClass=computer))",
  "hosts_filter_with_group":"",
  
  "contacts_base": "OU=Users,dc=shinkendom,dc=local",
  "contacts_filter": "(|(objectClass=InetOrgPerson)(objectClass=user))",
  "contacts_filter_with_group": "",
  
  "hostgroups_base": "OU=Serveurs,dc=shinkendom,dc=local",
  "hostgroups_filter": "(|(objectclass=group)(objectclass=groupofnames)(objectclass=groupofuniquenames))",
  
  "contactgroups_base": "OU=Users,dc=shinkendom,dc=local",
  "contactgroups_filter": "(|(objectClass=groupOfUniqueNames)(objectClass=groupOfNames)(objectClass=posixGroup))"
 }

Le mapping des informations collectées

Le mapping des informations collectées par la source se configure dans le fichier indiqué par le paramètre mapping_configuration_file ( voir la page Le mapping des informations collectées des champs du serveur Active Directory vers les propriétés et les données Shinken ).

mapping_configuration_file

Les règles d'application des modèles

Les règles d'application des modèles par la source se configurent dans le fichier indiqué par le paramètre rules_configuration_file. 
Voir la page Les règles d'application des modèles par rapport aux champs collectés du serveur Active Directory.

rules_configuration_file

Précisions techniques

Clés de synchronisation

Clés de synchronisation

Les clés de synchronisation sont des valeurs utilisées lors de l'étape du mélange des sources ( voir la page Modules de Sources ( imports ) et de Taggers ( qualification ) ) qui permet de choisir quel élément de cette source se mélange avec quel élément d'une autre source ( voir la page Le mélange des sources & les clés de synchronisation (sync-key) ).

Les paramètres properties_used_as_synckey_for_hosthosts, properties_used_as_synckey_for_hostgrouphostgroups, properties_used_as_synckey_for_contact contacts et properties_used_as_synckey_for_contactgroup contactgroups de la source permettent d'ajouter les propriétés qui serviront à créer les clés de synchronisation ( voir la page Collecteur de type ldap-import ( pour Active Directory ) ).

Propriétés par défaut utilisé pour la construction des clés de synchronisation