--- sourceDocument: Australie : créer des workflows sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/build-workflows Release : - australia ft:locale : - fr-FR ft:publication_title : - Australie : créer des workflows ft:clusterId : - crworkflow bundleId : - crworkflow workflow : - Creator --- # Étape SSH # Étape SSH {#ariaid-title1} * Rversion finale: Australia * * Mis à jour 12 mars 2026 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 6 minutes de lecture L'étape SSH exécute des commandes SSH sur un système \*nix externe via un ServiceNow® Serveur MIDfichier . L'étape stocke également les scripts et les commandes pour les systèmes \*nix. Remarque : * Cette étape exige un Centre d'intégration abonnement. Pour plus d'informations, voir [Calendriers juridiques - Centre d'intégration présentation](https://www.servicenow.com/content/dam/servicenow-assets/public/en-us/doc-type/legal/snc-addendum-integrationhub.pdf). * Centre d'intégration prend uniquement en charge ServiceNow SSH. {#ssh-step-action-designer__ul_idx_5dn_qhb} ## Rôles et disponibilité {#ssh-step-action-designer__section_anz_xst_khb} 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 {#ssh-step-action-designer__section_gqd_cy4_qhb} É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](https://servicenow-prod.fluidtopics.net/CW~YfJ_mFbgbyE~liqDQ4w "Utilisez des fonctions de transformation des arguments Sanitize Shell pour supprimer toute injection de commande potentiellement dangereuse dans les pastilles de données String à utiliser pour le scripting shell Bash."). 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 {#ssh-step-action-designer__section_fls_2tt_khb} {#ssh-step-action-designer__table_qhj_3tt_khb__entry__2} | 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. {#ssh-step-action-designer__ul_bfs_tvt_khb} Pour en savoir plus sur les connexions et les informations d'identification, consultez [Présentation des informations d'identification, des connexions et des alias](https://www.servicenow.com/docs/access?context=credentials-connections-alias&version=australia&pubname=australia-platform-security&ft:locale=en-US). | | 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](https://www.servicenow.com/docs/access?context=credentials-connections-alias&version=australia&pubname=australia-platform-security&ft:locale=en-US). 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](https://www.servicenow.com/docs/access?context=credentials-connections-alias&version=australia&pubname=australia-platform-security&ft:locale=en-US). 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](https://www.servicenow.com/docs/access?context=t_ConfigureAMIDServerCluster&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US). {#ssh-step-action-designer__ul_pxl_vdb_htb} 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](https://servicenow-prod.fluidtopics.net/xJmxnzfXwH~cZ9twoZFLDQ#ssh-step-action-designer__adv-ssh-section_l1v_jqk_phb) 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](https://servicenow-prod.fluidtopics.net/3gM3ddJuKuNNbysYG2SgjA "Ajoutez du JavaScript personnalisé à exécuter dans une action réutilisable. Bien que la plupart des actions et étapes de base correspondent aux cas d’utilisation courants, vous pouvez créer une étape de script pour exécuter un comportement insatisfait par les étapes de base.") prétraitement. Pour plus [d'informations, consultez Nettoyage des arguments à l'aide de la classe et de la fonction d'échappement](https://servicenow-prod.fluidtopics.net/F90~7xcOmjR7TYg0kxIK6A#jdbc-step__section_gqd_cy4_qhb). | | 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. | [ ] {#ssh-step-action-designer__table_qhj_3tt_khb}Pour plus d'informations, consultez [Informations d'identification SSH](https://www.servicenow.com/docs/access?context=r_SSHCredentialsForm&version=australia&pubname=australia-platform-security&ft:locale=en-US). ## Évaluation des erreurs d'action {#ssh-step-action-designer__id_lg2_4s3_15b} 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 [Évaluation des erreurs d'action](https://servicenow-prod.fluidtopics.net/P9G3fb5Smq62oYvl5p06lg "Activez les actions pour intercepter les défaillances d’étapes et continuer l’exécution. Identifiez quand des conditions d’erreur spécifiques se produisent et renvoyez votre propre code de statut de l’action, message d’état et état d’erreur."). ## Options avancées de script SSH {#ssh-step-action-designer__adv-ssh-section_l1v_jqk_phb} 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("")} 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 MIDFichiers de script.