Étape SSH

Remarque :

Cette étape exige un Centre d'intégration abonnement. Pour plus d’informations, voir Calendriers juridiques - Centre d'intégration présentation.
Centre d'intégration prend uniquement en charge ServiceNow SSH.

Rôles et disponibilité

L’étape SSH est disponible en tant qu’étape d’action Studio de workflow . Les utilisateurs disposant du rôle action_designer peuvent créer une action personnalisée avec une ou plusieurs étapes d’action.

Nettoyage des entrées

Échappez toutes les entrées utilisateur pour éliminer la possibilité qu’un utilisateur malveillant exécute des commandes arbitraires sur votre serveur cible. Échappez et validez les pastilles de données avant que le champ de commande ne les utilise en assainissant les arguments à l’aide des fonctions de transformation des arguments Sanitize shell. Cette catégorie de fonction de transformation s’affiche automatiquement lorsqu’une pastille de données est déposée dans l’entrée de commande .

Champs


Champ	Description
Détails de la connexion
Connexion	Type de connexion à utiliser. Définir l’inline de la connexion : Définissez les informations de connexion dans l’étape d’action. Utiliser des alias de connexion : Définissez les informations de connexion à l’aide de la table Alias de connexion. L’utilisation d’un alias élimine la nécessité de configurer plusieurs informations d’identification et profils d’informations de connexion lors de l’utilisation d’une action dans plusieurs environnements. De même, si les informations de connexion changent, vous n’avez pas besoin de mettre à jour votre action personnalisée. Pour en savoir plus sur les connexions et les informations d’identification, consultez Présentation des informations d’identification, des connexions et des alias.
Alias de connexion	Enregistrement d’alias de connexion et d’informations d’identification que le système utilise pour exécuter l’étape d’action. Les utilisateurs disposant du rôle flow_designer ou admin peuvent créer ou sélectionner un enregistrement de connexion associé. L’utilisation d’un alias élimine la nécessité de configurer plusieurs informations d’identification et profils d’informations de connexion lors de l’utilisation d’une action dans plusieurs environnements. De même, si les informations de connexion changent, vous n’avez pas besoin de mettre à jour votre action personnalisée. Pour en savoir plus sur les connexions et les informations d’identification, consultez Informations d’identification, connexions et alias. La valeur d’informations d’identification s’affiche sous la forme d’une pastille de données de mot de passe (chiffré dans 2 sens) sur le panneau de données. Ce champ est disponible lorsque l’option Utiliser l’alias de connexion est sélectionnée dans la liste Connexion.
Alias d'informations d'identification	Alias d’informations d’identification que le système utilise pour exécuter l’étape d’action. Les utilisateurs disposant du rôle flow_designer ou admin peuvent créer ou sélectionner un enregistrement de connexion associé. L’utilisation d’un alias élimine la nécessité de configurer plusieurs informations d’identification lors de l’utilisation d’une action dans plusieurs environnements. De même, si les informations d’identification changent, vous n’avez pas besoin de mettre à jour votre action personnalisée. Pour en savoir plus sur les connexions et les informations d’identification, consultez Informations d’identification, connexions et alias. La valeur d’informations d’identification s’affiche sous la forme d’une pastille de données de mot de passe (chiffré dans 2 sens) sur le panneau de données. Ce champ est disponible lorsque l’option Définir l’inline de la connexion est sélectionnée dans la liste Connexion. Remarque : L’étape SSH nécessite un enregistrement d’informations d’identification qui prend en charge soit les informations d’identification par clé privée SSH, soit les informations d’identification SSH. Cette étape ne prend pas en charge les informations d’identification Windows dans lesquelles l’option Compte de service Utiliser un serveur MID est sélectionnée.
Hôte	Nom d’hôte ou adresse IP du serveur cible. Ce champ est disponible lorsque l’option Définir l’inline de la connexion est sélectionnée dans la liste Connexion.
Port	Numéro de port pour communiquer avec le serveur. Ce champ est disponible lorsque l’option Définir l’inline de la connexion est sélectionnée dans la liste Connexion. Remarque : Indiquez une valeur valide comprise entre `1` et `65 535`. Si vous indiquez une autre valeur, la valeur est définie sur `22` par défaut.
Sélection de MID	Option permettant de sélectionner un serveur MID ou une grappe MID spécifique. Choisissez l’une des options suivantes. Sélection automatique d’un serveur MID : votre ServiceNow instance sélectionne l’sans Serveur MID entrée manuelle. Serveur MID spécifique : votre ServiceNow instance utilise ce Serveur MID que vous spécifiez. Grappe MID spécifique : votre ServiceNow instance utilise la grappe MID que vous spécifiez. Une grappe MID est un groupe de serveurs MID qui permet à votre ServiceNow instance de gérer plusieurs intégrations et d’améliorer la vitesse d’intégration. Pour plus d'informations, consultez Configure a MID Server cluster. Ce champ est disponible lorsque l’option Définir l’inline de la connexion est sélectionnée dans la liste Connexion.
Application MID	Option permettant d’utiliser un Serveur MID pour exécuter l’étape SSH. Ce champ est disponible lorsque l’option Définir l’inline de la connexion est sélectionnée dans la liste Connexion et que Sélectionner automatiquement Serveur MID est sélectionnée dans la liste Sélection MID.
Options	Aptitude du Serveur MID. Sélectionnez SSH. Ce champ est disponible lorsque l’option Définir l’inline de la connexion est sélectionnée dans la liste Connexion et que Sélectionner automatiquement Serveur MID est sélectionnée dans la liste Sélection MID.
Serveur MID	Pastille de données du requis Serveur MID. Ce champ est disponible lorsque l’option Définir l’inline de la connexion est sélectionnée dans la liste Connexion et qu’un Serveur MID spécifique est sélectionné dans la liste Sélection MID.
Grappe MID	Pastille de données pour la grappe MID que vous souhaitez utiliser. Ce champ est disponible lorsque l’option Définir l’inline de la connexion est sélectionnée dans la liste Connexion et que la grappe MID spécifique est sélectionnée dans la liste de sélection MID.
Configuration SSH
Répertoire de travail	Répertoire cible facultatif sur l’hôte cible sur lequel la commande est exécutée.
Commande	Commande qui s’exécute sur le répertoire cible. La commande peut également inclure des Serveur MID scripts. Voir Options de script SSH avancées pour plus d’informations. Remarque : Échappez et validez les pastilles de données avant que le champ de commande ne les utilise en nettoyant les arguments à l’aide d’une étape de script de prétraitement. Pour plus d’informations, consultez Nettoyage des arguments à l’aide de la classe et de la fonction d’échappement.
Exécution longue	Option permettant de désactiver le délai de connexion SSH pour les commandes dont l’exécution peut prendre plus de temps que la durée par défaut de 120 secondes. Lorsque cette option est sélectionnée, le moteur se détache du thread d’exécution jusqu’à son achèvement.
Sudo Mode	Option permettant d’élever les privilèges d’exécution du script.

Pour plus d’informations, consultez Informations d’identification SSH.

Évaluation des erreurs d’action

En cas d'échec de cette étape: Type de données : Choice
Option permettant de continuer à exécuter l’étape suivante ou d’accéder à l’évaluation des erreurs. Pour utiliser le code d’état d’étape ou le message pour une condition d’erreur d’action personnalisée, reportez-vous à la section .

Options avancées de script SSH

Pour exécuter un Serveur MID script sur l’hôte cible, spécifiez le type de script et transmettez le nom du script dans le paramètre ${syncFile()}. Le système utilise ce paramètre pour localiser le script nommé dans la Serveur MID table Fichier de script [ecc_agent_script_file] et l’exécuter sur l’hôte cible. Par exemple, un script bash peut être exprimé comme suit :

bash ${syncFile("<MID script name>")} argument1 argument2 argument3

Un script de base (main_script.bash) peut référencer un autre script (my_include.bash) ainsi qu’un fichier distinct (.my_profile) situé sur l’hôte cible. Les deux scripts et le fichier référencé doivent être synchronisés avec le , à l’aide du paramètre ${syncFile()}, pour s’exécuter Serveur MID correctement.

source ${syncFile(".my_profile")}
cp ${syncFile("my_include.bash")} /usr/ssmith/my_include.bash
bash ${syncFile("main_script.bash")} one two three four five six 
rm /usr/ssmith/my_include.bash

Un exemple Python avec des commentaires en ligne pourrait ressembler à ceci :

set $LIB_DIR=/usr/bin;. 
# Sync a file that is referenced inside myF5CreateLBPool.py 
cp ${syncFile("specialFunctions.py")} ~/specialFunctions.py 
# set up environment variables 
source ${syncFile(".python_profile")} 
# call script that sets up dependencies on the box from remote package repos 
python ${syncFile("setupPythonDependencies.py")} pycontrol 
# call a script that requires functions from the package as well as a function from myIncludedFile 
python ${syncFile("myF5CreateLBPool.py")} snow_pool myActualValue 
# user is responsible for their own cleanup 
rm ~/specialFunctions.py

Pour afficher la liste des scripts disponibles Serveur MID , accédez à Serveur MID > Fichiers de script.