Créer un audit scripté

Rversion finale: Washingtondc

Mis à jour 1 févr. 2024

8 minutes de lecture

Un audit scripté est un audit dont les conditions sont définies par un script.

Procédure

Accédez à la Tous > Conformité > Audits sous forme de scripts > Audits.

Un type d’audit Scripté filtre la liste.
Cliquez sur Nouveau.
Remplissez le formulaire (consultez la table).
Créez le script d’audit.

Le champ Exécuter ce script comprend un exemple de script contenant des instructions pour effectuer l’audit et générer les tâches de suivi. Ce champ n’apparaît que lorsque vous accédez aux audits à partir du module Audits scriptés.

Cliquez sur Envoyer.

Exemple de script :

/*
/////////////////////////////////////////////////////
/// This script works with Data Center Zones filter //
/////////////////////////////////////////////////////
 
var desiredFloorSpaceUsage = 30;		// Value to audit against
var assignToUser = '46d44a23a9fe19810012d100cca80666';	 // Beth Anglin
var assignToGroup = '8a5055c9c61122780043563ef53438e3';	// Hardware group
var taskMsg = 'See the audit results below for the discrepancies that must be addressed';
 
// API call to retrieve records based on the filter
var gr = new SNC.CertificationProcessing().getFilterRecords(current.filter);
 
// Loop over all records defined by the filter
while(gr.next()) {
	var sysId = gr.getValue('sys_id');	// Sys ID of audited record
	var floorSpaceInUse = gr.getValue('floor_space_in_use');	// Value to audit
 
	// Determine if certification condition passes or fails
	if (floorSpaceInUse < desiredFloorSpaceUsage) {
		var columnNameSpace = gr.floor_space_in_use.getLabel();	// String value of column audited against
 
		// Call create Follow on Task API and save the returned sys_id for use in logging audit result fail
		// Params: 
		// auditId - Sys id of the audit record executed
		// ciId Sys - id of the configuration item.  Empty string if not a cmdb ci
		// assignedTo - Sys id of user to assign task to.  Can be empty
		// assignmentGroup - Sys id of group to assign task to.  Can be empty
		// shortDescr - Short description for the Follow On Task.  Can be empty
		// Return value: Sys id of the created follow on task
		var followOnTask = new SNC.CertificationProcessing().createFollowOnTask(current.sys_id, sysId, assignToUser, '', taskMsg);
 
		// Call log failed result API
		// Params:
		// auditId - Sys id of audit record executed
		// auditedRecordId - Sys id of the record audited
		// followOnTask - Sys id of the follow on task associated with the audited record(@see auditedRecordId). Can be empty
		// columnDisplayName - Label of the column audited(ex. Disk space (GB)).  Can be empty
		// operatorLabel - Label of the operator used to audit the column(ex. is not empty, greater than). Can be empty
		// desiredValue - Desired value of the column.  Can be empty
		// discrepancyValue - Discrepancy value.  Can be empty
		// isCI - True, if audited record is a CI. False, otherwise.
		// domainToUse - Sys domain of the "cert_audit" record.  Can be empty
		new SNC.CertificationProcessing().logAuditResultFail(current.sys_id, sysId, followOnTask, columnNameSpace, 'greater than', desiredFloorSpaceUsage, floorSpaceInUse, true);
	} else { // If certification condition pass, write a Audit Result Pass via API
		// Params:
		// auditId - Sys id of audit record executed
		// auditedRecordId - Sys id of the record audited
		// isCI - True, if audited record is a CI. False, otherwise.  Can be empty.
		// domainToUse - Sys domain of the "cert_audit" record.  Can be empty.
		new SNC.CertificationProcessing().logAuditResultPass(current.sys_id, sysId, true);
	}
}
*/

Tableau 1. Nouvelle table d’audit scriptée.
Champ	Description
Nom	Nom de cet audit.
Filtre	Filtre à utiliser lorsque le type d’audit est Scripté. Ce champ est obligatoire pour les audits scriptés, mais il est masqué pour tous les autres types d’audit.
Modèle	[Obligatoire] Modèle à utiliser lors de l’exécution de cet audit. Le type d’audit filtre la liste des modèles disponibles et seules les versions actives d’un modèle sont disponibles pour la sélection. Ce champ est masqué lorsque le type d’audit est Scripté.
Table	[Lecture seule] Affiche la table du modèle.
Créer des tâches	Crée des tâches de suivi pour corriger les discordances lorsque cette option est sélectionnée. Dans un audit scripté, vous pouvez créer la logique pour l’un ou l’autre état de tâche en utilisant vrai pour créer une tâche ou faux si aucune tâche n’est créée. Par défaut, cette case est décochée (false) dans un nouvel enregistrement d’audit.
Type d'affectation	Liste de choix permettant de sélectionner la façon dont l’audit affecte les tâches de suivi. Ce champ n’est visible que lorsque la case Créer une tâche est cochée. Les choix possibles sont les suivants : Champ d’utilisateur : sélectionnez un champ de référence utilisateur sur la table en cours d’audit. Par exemple, sélectionnez l’utilisateur nommé dans le champ Géré par de l’enregistrement ayant échoué pour effectuer les tâches. Cette sélection affiche les champs vides Affecté à et Affecter à. Si le champ de référence de l’enregistrement est vide, la valeur du champ vide Affecter à est utilisée. Utilisateur spécifique : sélectionnez un utilisateur spécifique pour effectuer les tâches. Cette sélection affiche le champ Utilisateur. Champ de groupe : sélectionnez un champ de référence de groupe sur la table auditée. Par exemple, sélectionnez le groupe de support à partir de l’enregistrement en échec pour effectuer les tâches. Cette sélection affiche les champs vides Affecter à un groupe et Affecter à. Tous les membres du groupe du champ de référence de l’enregistrement en échec sont affectés aux tâches. Si le champ de référence de l’enregistrement est vide, la valeur du champ vide Affecter à est utilisée. Groupe spécifique : sélectionnez un groupe spécifique pour effectuer les tâches. Cette sélection affiche le champ Groupe. Tous les membres du groupe sélectionné sont affectés aux tâches.
Utilisateur	L’utilisateur spécifique affecté aux tâches de suivi par cet audit. Ce champ est disponible aux conditions suivantes : Le type d’affectation est défini sur Utilisateur spécifique. Attribuer à vide est défini sur Créer une tâche affectée et Type d’affectation est défini sur Champ d’utilisateur. Remarque : Assurez-vous que l’utilisateur spécifié dispose du rôle de certification.
Affecter à un groupe	Le champ de groupe qui définit le groupe affecté par cet audit à la tâche de suivi. Ce champ n’est disponible que lorsque le type d’affectation est Champ de groupe.
Groupe	Groupe spécifique affecté aux tâches de suivi par cet audit. Ce champ n’est disponible que lorsque le type d’affectation est Groupe spécifique et que vous avez sélectionné Champ de groupe comme type d’affectation.
Affecter à	Champ d’utilisateur qui définit l’utilisateur affecté par cet audit à la tâche de suivi. Ce champ n’est disponible que lorsque le type d’affectation est Champ d’utilisateur.
Attribuer à vide	Comportement à utiliser si le champ sélectionné dans Affecter au groupe ou Affecter au groupe est vide sur l’enregistrement en cours d’audit. Par exemple, si une tâche de suivi doit être affectée à un gestionnaire, mais qu’aucun gestionnaire n’est identifié, la valeur de ce champ détermine ce qui se passe. Ce champ s’affiche uniquement lorsque le type d’affectation est Champ d’utilisateur ou Champ de groupe. Les sélections possibles sont les suivantes : Ne pas créer de tâche : aucune tâche de suivi n’est créée lorsque le champ Affecter à un groupe ou Affecter à est vide. Créer une tâche non affectée : créez une tâche de suivi, mais ne l’affectez à aucun utilisateur ou groupe. La tâche peut être affectée manuellement ultérieurement. Créer une tâche affectée : créez une tâche de suivi et affectez-la à l’utilisateur ou au groupe spécifié. Si vous avez sélectionné un type d’affectation Champ d’utilisateur, le champ Utilisateur devient disponible. Si vous avez sélectionné le type Champ de groupe, le champ Groupe devient disponible. L’audit crée automatiquement des tâches de suivi pour tous les enregistrements dont le champ Affecter à est renseigné, quelle que soit la sélection que vous faites pour Affecter à vide.
Description courte	Brève description de l’objectif de l’audit.
Description de tâche	Description générale du travail requis pour les tâches de suivi créées par cet audit. Toutes les tâches de suivi créées par cet audit héritent de cette description.
Actif	Active ce calendrier d’audit et génère les tâches de suivi aux date et heure prévues. Décochez cette case pour masquer les champs de planification sur le formulaire (à l’exception de la date de dernière exécution) et ne pas générer de tâches de suivi.
Exécution	À quelle fréquence exécuter le calendrier qui génère l’audit. Quotidien Hebdomadaire Mensuel Périodiquement Une fois Sur demande
Jour	Si le champ Exécution est défini sur Hebdomadaire, jour de la semaine au cours duquel l’audit s’exécute. Si le champ Exécution est défini sur Mensuel, jour du mois d’exécution de l’audit. Si le jour est le 29, 30 ou 31, pour les mois plus courts, l’audit s’exécute le dernier jour du mois.
Intervalle de répétition	Si l’exécution est périodique, fréquence d’exécution de l’audit saisie en heures, jours ou les deux. Par exemple, définissez Jours sur 10 et Heures sur 14 :00 :00 pour exécuter l’audit tous les 10 jours à 14h00.
En cours de démarrage	Si l’exécution est Périodique ou Une fois, date et heure d’exécution de l’audit.
Heure	Si le champ Exécution est défini sur Quotidien, Hebdomadaire, Mensuel ou Une fois, heure de la journée, sur un format de 24 heures, au cours de laquelle l’audit s’exécute.
Date de dernière exécution	[Lecture seule] La date et l’heure de la dernière exécution de l’audit, soit selon son calendrier habituel, soit manuellement. Les aperçus d’audit ne mettent pas à jour ce champ.
Prochaine exécution planifiée	[Lecture seule] Date et heure de la prochaine exécution de l’audit. Le système recalcule ce champ lorsque vous modifiez le calendrier.
Type d'audit	[Lecture seule] Type affecté à cet audit. Le système sélectionne le type d’audit en fonction de l’application à partir de laquelle l’audit a été créé. Il peut être : État souhaité Conformité d'architecture Conformité Scripté
Exécuter ce script	Script d’audit à exécuter. Ce champ n’est disponible que lorsque le type d’audit est Scripté. Le formulaire d’audit comprend un exemple de script contenant des instructions pour effectuer l’audit et générer les tâches de suivi. Reportez-vous à la section Méthodes de script pour obtenir la liste des méthodes fournies et des paramètres acceptés.