Vue d'ensemble

Personnaliser la source pré-installée

Définition de la source

Le fichier préalablement créé pour la source Active Directory  exemple est : /etc/shinken/sources/active-dir-hosts.cfg. (de la même manière qu'avec le répertoire de configuration, vous pouvez dupliquer ce fichier et effectuer les modifications afin de personnaliser votre source)

C'est ici que vous pouvez changer le nom de votre source via la propriété source_name

Une source Active Directory est caractérisée par son module_type qui doit être : ldap-import

Le module pouvant être utilisé aussi par les sources de type Open LDAP, il est nécessaire de préciser le mode : ad

Pour les autres valeurs, merci de vous référer à la Définition et Utilisation des sources. 

Les fichiers suivants sont utilisés pour configurer votre serveur Active Directory (le chemin peut varier si vous avez personnalisé votre répertoire) :

Configuration de la connexion

Paramètres du fichier

Exemple

Configuration des règles de "mapping"

Il est possible de faire correspondre certaines propriétés Active Directory avec des propriétés ou donnée d'un élément Shinken. Il existe un "mapping" par défaut pour Active Directory, mais il est possible de personnaliser les correspondance.

 Si besoin (facultatif), modifiez le fichier active-directory-mapping.json

Paramètres du fichier

Chaque ligne de ce fichier définit une correspondance entre une propriété ou donnée Shinken avec une propriété LDAP. Les paramètres peuvent donc être nombreux.

Par exemple la ligne suivante définit une correspondance entre le nom de l'hôte dans Shinken et sa propriété dans LDAP:

"host.host_name": "name",

Elle est définit par :

• la propriété shinken entre guillemets découpé en deux parties :
  • le type de l'élément au singulier. Les types disponibles sont : "host", "contact", "hostgroup" et "contactgroup"
  • le point permet de joindre les deux parties
  • la propriété de l'élément. Cette propriété est la "clé d'import" que l'on peut retrouver sur l'interface dans la fenêtre d'aide
• le séparateur "deux points"
• la propriété ldap entre guillemets

Il vous est donc possible de faire correspondre les propriétés ldap avec les propriétés shinken de votre choix. Si vous ne définissez pas ce fichier, un mapping par défaut sera utilisé. Voici ses valeurs.

Exemple

Compatibilité avec les anciennes versions

Pour des raisons de compatibilité avec les versions inférieur à la 02.06.03, les propriétés suivantes sont toujours fonctionnelles :

Règles de configuration

Ce fichier est utilisé pour appliquer des modèles d'hôtes et des modèles d'utilisateurs sur les hôtes et utilisateurs durant l'import, provenant d'OU ciblées.
Ce fichier permet également de filtrer les utilisateurs à importer dans Shinken en se basant sur les membres d'un ou de plusieurs groupes d'utilisateurs de l'annuaire Active Directory ciblé.

Veuillez donc enfin modifier le fichier active-directory-rules.json Attention la modification de ce fichier est obligatoire car certaines propriétés contenant des chemins Active Directory ne permettront pas un import valide si elles ne sont pas modifiées.

Paramètres du fichier

Les règles doivent être définies dans le fichier "rules", encadré par des accolades "{ ... }". Il est possible de définir plusieurs types de règles.

Ajouter un modèle sur tous les éléments

Il est possible d'ajouter un même modèle sur tous les hôtes ou contacts importés par la source. Par exemple pour ajouter le modèle "ldap-host" à tous les hôtes et le modèle "ldap-user" à tous les contacts, il faut configurer les lignes suivantes :

"hosts_template": "ldap-host",
"contacts_template": "ldap-user"

Ajouter un modèle sur tous les éléments présent dans une OU spécifique

Il est possible d'ajouter un modèle pour tous les hôtes ou contacts qui sont dans une OU spécifique. Par exemple pour ajouter le modèle d'hôte WindowsServer à tous les hôtes présent dans l'OU "ou=WindowsServer,ou=Datacenter,dc=shinkendom,dc=local", et le modèle "Bordeaux" à tous les contacts présents dans l'OU "ou=Users,ou=Bordeaux,ou=Datacenter,dc=shinkendom,dc=local", il faut configurer les lignes suivantes :

"hosts_template_WindowsServer": "ou=WindowsServer,ou=Datacenter,dc=shinkendom,dc=local",
"contacts_template_ldapAdmins": "ou=Users,ou=Bordeaux,ou=Datacenter,dc=shinkendom,dc=local"

Ajouter un modèle sur tous les éléments correspondant à une propriété

Il est possible d'ajouter des modèles sur des éléments dont un propriété correspond à une valeur définie.

Cette règle est divisé en 5 parties : un préfixe, un modèle, type d'élément, le nom de la propriété, la valeur de la propriété.

Voici un exemple et son explication :

exemple	:		"AddLast_template_(France)_to_contact_matching_[_COUNTRY]": "France"
explication : 	| Préfixe         |modèle|    type d'élément   |propriété|   valeur |

• Tout d'abord le préfixe peut prendre 3 valeurs :
  • "AddFirst_template_" : permet d'ajouter le modèle en première position du champs use
  • "AddLast_template_" : permet d'ajouter le modèle en dernière position du champs use
  • "Force_template_" : permet d'utiliser uniquement ce modèle. Cette méthode sera prioritaire et effacera les valeurs obtenues par les précédentes règles.
• Le nom du modèle doit être mis entre parenthèses : France dans l'exemple
• Le type d'élément ne peut prendre que deux valeurs
  • "_to_host_matching_" : la règle sera utilisé pour les hôtes
  • "_to_contact_matching_" : la règle sera utilisé pour les contacts
• le nom de la propriété doit être entre crochets : _COUNTRY dans l'exemple
  
  • Cette propriété peut être une propriété ou donnée de l'élément Shinken (présente dans le fichier de mapping)
  • Cette propriété peut être un attribut LDAP
• la valeur de la propriété pour que la règle s'applique : France dans l'exemple
  

Ajouter un modèle sur tous les élément présent dans un groupe

Pour ajouter un modèle sur un élément présent dans un groupe, il faut utiliser la règle précédente avec la propriété memberOf.

"AddLast_template_(bordeaux)_to_host_matching_[l]": "Bordeaux"

Exemple

Dans cet exemple nous allons ligne par ligne :

• ajouter le modèle "linux" à tous les hôtes découverts par la source
• ajouter le modèle "centos" à tous les hôtes découverts dans l'OU "OU=centos,OU=serveurs,dc=shinken,dc=local"
• ajouter le modèle "Datacenter_01_Bordeaux" à la fin du champ "use" aux hôtes ou la propriété "location" vaut "FRBXDC01"
• ajouter le modèle "generic-contact" à tous les contacts découvert par la source
• ajouter le modèle "domain-admins" à tous les contact qui font partie du groupe ldap "cn=Domain Admins,ou=Users,dc=shinken,dc=local"

{
  "hosts_template": "linux",
  "hosts_template_centos": "OU=centos,OU=serveurs,dc=shinken,dc=local",
  "AddLast_template_(Datacenter_01_Bordeaux)_to_host_matching_[location]": "FRBXDC01",

  "contacts_template": "generic-contact",
  "AddFirst_template_(domain-admins)_to_contact_matching_[memberOf]": "cn=Domain Admins,ou=Users,dc=shinken,dc=local",
}

Import des objets

Pour importer des objets, allez sur la page d'accueil de l'UI de configuration, si votre configuration est bonne, vous devriez avoir un message "OK: la source LDAP a été correctement chargée."

Maintenant, faîtes un "Forcer l'import" en cliquant sur  

Dans le panneau "Elements >" vous verrez les nouveaux éléments apparaître (Hôtes et Contacts).

La prochaine étape sera alors d'importer ces nouveaux éléments dans Shinken.

HOW TO

Importer des ordinateurs avec des noms spécifiques

Dans le fichier active-directory-connection.json

Modifiez le paramètre hosts_filter

   "hosts_filter": "(&(objectClass=computer)(sAMAccountName=*SERVER_NAME*))",

Changez SERVER_NAME  par le nom de serveur vous voulez importer.

Importer des utilisateurs issus d'un ou plusieurs groupes

 Avec la source Active Directory, il est donc possible d'importer des utilisateurs de la base contacts_base spécifiée dans le fichier active-directory-connection.json mais on peut aussi les filtrer afin de n'importer que ceux qui sont dans un ou plusieurs groupes différents de l'annuaire LDAP.

Dans le fichier active-directory-connection.json

Dans contacts_filter_with_group, ajouter le Distinguished Name (DN) des différents groupes d'utilisateurs séparés par un pipe ("|")

  "contacts_filter_with_group": "CN=shinken_admins,OU=utilisateurs,DC=shinkendom,DC=local | CN=shinken_users,OU=utilisateurs,DC=shinkendom,DC=local",

Filtrer et appliquer des modèles

Cette source inclut également d'autres paramètres qui permettent d'appliquer des modèles automatiquement suivant le type d'objets :

• hosts_template: chaque hôte chargé aura au moins le modèle défini en valeur
• contacts_template: chaque contact chargé aura au moins le modèle défini en valeur

Il est également possible d'ajouter un modèle sur les hôtes sur leur OU (Organization Unit) en utilisant le paramètre hosts_template_*

Par exemple, si vous voulez ajouter le modèle exchange à tous les serveurs qui sont dans l'OU: OU=Email Collaboration Servers,OU=DataCenter Servers,DC=YOUR,dc=DOMAIN,dc=com, utilisez le paramètre suivant:

"hosts_template_exchange":  "OU=Email Collaboration Servers,OU=DataCenter Servers,DC=YOUR,dc=DOMAIN,dc=com"

Précisions techniques

Clés de synchronisation

Les clés de synchronisation sont des propriétés des objets utilisées pour les identifier dans les sources. Le fonctionnement et l'utilité des clés de synchronisation sont décrits de manière plus détaillée dans la page de documentation dédiée: Précision techniques sur le fonctionnement de l'import des sources.

Dans notre cas le nom de l'élément est automatiquement ajouté dans les clés de synchronization. Les clés supplémentaires suivantes sont ajoutées :

• Pour les hôtes : address,
• pour les contacts : email, le préfixe de l'email (la partie avant le @)