Conventions de nommage

Noms de fichiers dans Github

Nous attendons une certaine structure de fichiers et de noms dans le répertoire partagé de runbooks. RealmJoin importera ces dossiers et fichiers depuis GitHub dans le compte Azure Automation du client.

Les tirets ("-") seront convertis en espaces. Les dossiers servent à séparer les runbooks en « contexte » et « catégorie », par ex. user\general. Les noms de fichiers doivent décrire la finalité du script.

Tous les runbooks importés ont un préfixe de préfixe rjgit-, suivi du contexte, soit organisation, groupe, utilisateur puis de la catégorie, par exemple _general_, _security_, _mail_ et du nom du script lui-même comme add-additional-alias.

Exemple :

Un runbook dans Github dans user\general nommé add-additional-alias.ps1 sera affiché comme :

• rjgit-user_general_add-additional-alias dans le compte Azure Automation

• "Ajouter un alias supplémentaire" dans le portail RealmJoin sur un objet Utilisateur dans la catégorie de runbooks "Général".

Catégories courantes

• Général

• Sécurité

• Courrier

• Informations utilisateur

Vous pouvez définir des catégories supplémentaires, mais pas des contextes.

Quel est l'objectif de ceci ?

Cela permet de remplir et de nommer automatiquement les runbooks dans le portail RealmJoin. De plus, le préfixe rjgit- préfixe permet d'éviter les conflits de noms avec les runbooks locaux/clients. Les runbooks n'ayant pas ce préfixe ne seront pas touchés par la logique d'importation de RealmJoin.

Runbooks privés / spécifiques au client

Vous pouvez héberger des runbooks privés (locaux) dans votre compte Azure Automation. Ces runbooks apparaîtront dans le portail RealmJoin comme les runbooks partagés. Les runbooks locaux ne seront pas modifiés par notre processus de synchronisation et ne seront pas visibles par d'autres clients.

Pour créer un runbook local, supprimez le préfixe rjgit- préfixe de la convention de nommage tout en conservant le reste de la structure de nommage intact.

Exemple : vous voulez proposer un runbook « Runbook privé » dans le contexte des groupes Azure AD et la catégorie « Général ». Vous le nommeriez group_general_private-runbook dans votre compte Azure Automation.

Cela apparaîtra ainsi dans Azure Automation :

Noms de runbooks dans GitHub / Azure Automation

Il sera présenté dans le portail RealmJoin comme :

Noms de runbooks dans le portail RealmJoin