--- sourceDocument: Australie Workflow Data Fabric sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/integrate-applications Release : - australia ft:locale : - fr-FR ft:publication_title : - Australie Workflow Data Fabric ft:clusterId : - crint bundleId : - crint workflow : - Creator --- # Créer une activité SSH # Créer une activité SSH {#ariaid-title1} * Rversion finale: Australia * * Mis à jour 12 mars 2026 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 6 minutes de lecture Créez une activité qui extrait les données d'un hôte cible qui utilise le protocole réseau SSH. ## Avant de commencer Rôle requis : activity_creator ou workflow_admin ## Pourquoi et quand exécuter cette tâche Pour obtenir des instructions sur l'utilisation du flux de processus du modèle d'activité, consultez [Créer des activités personnalisées](https://servicenow-prod.fluidtopics.net/8fMcXxzqX9_ulMMl1iJpXg "Vous pouvez créer et mettre à jour différents types d’activités personnalisées dans l’Éditeur de workflow à l’aide d’un modèle personnalisé."). ## Procédure 1. Créez une [activité personnalisée](https://servicenow-prod.fluidtopics.net/8fMcXxzqX9_ulMMl1iJpXg "Vous pouvez créer et mettre à jour différents types d’activités personnalisées dans l’Éditeur de workflow à l’aide d’un modèle personnalisé."). Cette action crée une activité personnalisée à l'aide d'un modèle. 2. Après avoir configuré les [propriétés générales](https://servicenow-prod.fluidtopics.net/0gDo_2~KCA81l7h1863MYg "Les champs Propriété générale suivants sont communs à tous les modèles du concepteur d’activité.") et [créé des variables d'entrée](https://servicenow-prod.fluidtopics.net/fvDkuvTWTtwpaPa5ll8Q4g#CreateInputVariables "Créez les variables à transmettre dans l’activité dans le formulaire Entrées du concepteur d’activité."), configurez la commande d'exécution SSH. | Option | Description | | [Mapper les variables d'entrée](https://servicenow-prod.fluidtopics.net/fvDkuvTWTtwpaPa5ll8Q4g#t_MapAnInputVariable "Après avoir créé les variables d’entrée, mappez-les aux champs du formulaire Commande d’exécution.") | Utilisez les variables que vous avez créées pour configurer la commande exécutée par Orchestration. | | Hôte cible | Nom d'hôte ou adresse IP du serveur cible pour cette activité. | | Commande | Commande : cette activité s'exécute sur l'hôte cible. Vous pouvez invoquer un script de serveur MID à partir de ce champ en utilisant n'importe quel type de script pris en charge par la ligne de commande SSH. Pour plus d'informations, consultez Options de script SSH avancées sous la table. | | Répertoire | Répertoire sur l'hôte cible sur lequel la commande est exécutée. | | Balise d'informations d'identification | Balise d'informations d'identification Orchestration à utiliser lors de l'exécution de la commande. | | Capacités du serveur MID requises | Serveur MID disposant des options appropriées pour la connexion à l'hôte. Par défaut, le système sélectionne un serveur MID avec les options SSH. | | Exécution longue | Si cette option est activée, le délai d'expiration de la connexion SSH pour les commandes dont l'exécution peut prendre plus de temps que les 60 secondes par défaut. Orchestration vérifie périodiquement le processus en cours pour déterminer son état jusqu'à ce qu'il soit terminé. | | Doit Sudo | Si cette option est activée, active l'utilisation de [sudo](https://www.servicenow.com/docs/access?context=r_SSHCredentialsForm&version=australia&pubname=australia-platform-security&ft:locale=en-US) pour exécuter des commandes. | |-|-| {#t_CreateAnSSHActivity__choicetable_j2l_k2s_d1b} Remarque : Vous pouvez mapper automatiquement les valeurs des paramètres d'une charge utile de test aux variables de l'onglet Sorties . Voir [variables de sortie de mappage automatique](https://servicenow-prod.fluidtopics.net/uMEyrHZXhc5El5pzZ3u4~A "Vous pouvez mapper automatiquement les valeurs des paramètres d’une charge utile de test aux variables de l’onglet Sorties ."). ## 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 table Fichier de script de serveur MID \[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 ## Que faire ensuite * Utiliser [le mappage automatique](https://servicenow-prod.fluidtopics.net/uMEyrHZXhc5El5pzZ3u4~A "Vous pouvez mapper automatiquement les valeurs des paramètres d’une charge utile de test aux variables de l’onglet Sorties .") pour générer des sorties et des règles d'analyse * Si vous n'utilisez pas le mappage automatique, vous pouvez [créer manuellement des variables de sortie](https://servicenow-prod.fluidtopics.net/7ft7SbY6rbkRkSKzg4NOSg#t_CreateAnOutputVariable "Le formulaire Sorties du concepteur contient un générateur de variables permettant de créer des structures de données d’objets et de tableaux.") et [créer des règles d'analyse](https://servicenow-prod.fluidtopics.net/MvPjfPwcbqm1MnFZeco_Tg#t_CreateAParsingRule "Renseignez les variables de sortie définies dans une activité personnalisée avec les données de charge utile renvoyées par un test d’entrées sur un hôte ou un point de terminaison externe.") {#t_CreateAnSSHActivity__ul_u45_vbq_xz} ## Paramètres d'exécution du modèle SSH {#ariaid-title2} Utilisez les paramètres d'exécution pour créer le script de processus d'entrée dans le formulaire de prétraitement du concepteur d'activité. Pour obtenir une description des champs de commande, reportez-vous à la section [Configurer la commande d'exécution SSH](https://servicenow-prod.fluidtopics.net/y_RgKwG3MSpEEShhSbsuhA#t_MapSSHVariablesToExecutionCommand "Utilisez les variables d’entrée que vous avez créées pour configurer la commande qu’Orchestration exécute sur la cible hôte."). Remarque : Vous devez utiliser le préfixe `executionParam.` avec toutes les variables de cette table. {#r_SSHTemplateExecutionParameters__table_wl1_yxc_dr__entry__4} | Nom | Variable | Type | Utilisation | |-|-|-|-| | Source | source | Chaîne | Cible ou hôte prévu. | | Commande | commande | Chaîne | Commentaire à exécuter sur l'hôte. | | Répertoire | répertoire | Chaîne | Répertoire sur l'hôte dans lequel exécuter la commande. | | Balise d'informations d'identification | credential_tag | Chaîne | Balise d'informations d'identification Orchestration à utiliser lors de l'exécution de la commande. | | Capacités moyennes | midCapabilities | Chaîne (séparée par des virgules) | Liste des options de serveur MID requises. | | ValueCapabilities | valueCapabilities | Tableau de la carte de hachage | Valeurs d'aptitude utilisées pour sélectionner le serveur MID. Pour plus d'informations, voir [Options du serveur MID](https://www.servicenow.com/docs/access?context=t_ConfigureCapabilities&version=australia&pubname=australia-servicenow-platform§ion=r_MIDServerCapabilities&ft:locale=en-US). Si des options supplémentaires sont affectées par valeur, utilisez cet exemple pour personnaliser la sélection de serveur MID : var valueCapability = {'NEW_MID_CAPABIILTY':'NEW_MID_CAPABILITY_VALUE'}; executionParam.valueCapabilities.push(valueCapability); | | Exécution longue | long_running | Booléen | Indique si la commande est longue exécution ou non. La valeur vrai indique que l'exécution de la commande est longue. | | Doit sudo | must_sudo | Booléen | Indique si cette activité doit utiliser Sudo pour exécuter les commandes racine. La valeur vrai indique que [les informations d'identification sudo SSH](https://www.servicenow.com/docs/access?context=r_SSHCredentialsForm&version=australia&pubname=australia-platform-security&ft:locale=en-US) doivent être utilisées.[SSH credentials](https://www.servicenow.com/docs/access?context=r_SSHCredentialsForm&version=australia&pubname=australia-platform-security&ft:locale=en-US) | [Tableau 1. Paramètres d'exécution SSH] {#r_SSHTemplateExecutionParameters__table_wl1_yxc_dr} ## Paramètres de post-traitement SSH et analyse de la charge utile {#ariaid-title3} Utilisez ces paramètres pour créer un script de post-traitement, une analyse de charge utile et un balisage. {#SSH-payload-parsing-tags__table_nzv_q1d_dr__entry__4} | Nom | Variable | Type | Utilisation | |-|-|-|-| | Sortie | sortie | Chaîne | Contient la sortie renvoyée par la commande SSH. | | EccSysID | eccSysID | Chaîne | Contient l'ID de référence associé au message d'entrée de file d'attente ECC renvoyé par l'activité. | | Messages d'erreur | errorMessages | Chaîne | Contient les messages d'erreur récupérés à partir de la commande SSH. Cette valeur est nulle en l'absence de message d'erreur. | | Étiquettes | étiquettes | Carte de hachage des valeurs de balises renvoyée à partir de la commande SSH | Contient les balises utilisées pour extraire la sortie à l'aide des commandes SSH. La sortie de la balise est délimitée par des signes de pourcentage doubles, comme dans `%%tagname %% ... %%.` Configurez la commande à l'aide du format suivant : %%tagname1%% output1 line 1 output1 line 2 ... %% %%tagname2%% output2 line 1 output2 line 2 ... %% Les balises renvoyées sont des objets de hashmap JavaScript dans lesquels chaque clé est précédée d'une `balise` accompagnée du tagname. {"__text__": "", "tagtagname1":"output1 line1\noutput1 line2\n", "tagtagname2":"output2 line1\noutput2 line2\n"} | [Tableau 2. Paramètres de post-traitement SSH] {#SSH-payload-parsing-tags__table_nzv_q1d_dr} ## Configurer la commande d'exécution SSH {#ariaid-title4} Utilisez les variables d'entrée que vous avez créées pour configurer la commande qu'Orchestration exécute sur la cible hôte. ### Avant de commencer Créez les variables d'entrée dont vous avez besoin dans le formulaire Entrées avant de passer à l'étape de commande d'exécution . Rôle requis : activity_creator, admin Remarque : Vous pouvez tester la connexion SSH entre le serveur MID et la cible sans avoir à exécuter l'activité dans un contexte de workflow. Pour plus d'informations, consultez Sorties de modèle de test. ### Procédure 1. Faites glisser les variables de la liste des entrées et déposez-les dans les champs de commande. Le système formate la variable dans la syntaxe appropriée pour la commande. Figure 1. Commande d'exécution SSH 2. Renseignez les champs affichés dans la table. {#t_MapSSHVariablesToExecutionCommand__table_xf4_kvc_dr__entry__2} | Champ | Description | |-|-| | Entrée | Générateur de variables d'entrée. [Créer des variables d'entrée](https://servicenow-prod.fluidtopics.net/fvDkuvTWTtwpaPa5ll8Q4g#CreateInputVariables "Créez les variables à transmettre dans l’activité dans le formulaire Entrées du concepteur d’activité.") à mapper aux champs disponibles. | | Hôte cible | Nom d'hôte ou adresse IP du serveur cible pour cette activité. | | Commande | Commande : cette activité s'exécute sur l'hôte cible. Vous pouvez appeler un script de serveur MID à partir de ce champ en utilisant n'importe quel type de script pris en charge par la ligne de commande SSH. Pour plus d'informations, consultez Options de script SSH avancées sous la table. | | Répertoire | Répertoire sur l'hôte cible sur lequel la commande est exécutée. | | Balise d'informations d'identification | [Alias d'informations d'identification pour les activités d'Orchestration](https://www.servicenow.com/docs/access?context=c_AssignCredsOrchActivities&version=australia&pubname=australia-platform-security&ft:locale=en-US) à utiliser lors de l'exécution de la commande. | | Sélectionner un serveur MID par aptitudes | Serveur MID disposant des options appropriées pour la connexion à l'hôte. Par défaut, le système sélectionne un serveur MID avec les options SSH | | Exécution longue | Case à cocher pour désactiver le délai de connexion SSH pour les commandes dont l'exécution peut prendre plus de temps que les 60 secondes par défaut. Orchestration vérifie périodiquement le processus en cours pour déterminer son état jusqu'à ce qu'il soit terminé. | | Doit Sudo | Case à cocher autorisant l'utilisation des [informations d'identification SSH](https://www.servicenow.com/docs/access?context=r_SSHCredentialsForm&version=australia&pubname=australia-platform-security&ft:locale=en-US) pour exécuter des commandes. | [Tableau 3. Entrées d'activité SSH] {#t_MapSSHVariablesToExecutionCommand__table_xf4_kvc_dr} 3. Cliquez sur Enregistrer. 4. Cliquez sur Continuer pour passer à l'étape Sorties . {#t_MapSSHVariablesToExecutionCommand__steps_pr1_jlm_s5}