---
sourceDocument: Xanadu : créer des intégrations avec des applications
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/integrate-applications

 Release :

    - xanadu

ft:locale :

    - fr-FR

ft:publication_title :

    - Xanadu : créer des intégrations avec des applications

ft:clusterId :

    - crint

bundleId :

    - crint

workflow :

    - Creator


---

# Créer une activité SSH

# Créer une activité SSH {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](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/T2pGceRbxk7xJXCuw~~JMg "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/T2pGceRbxk7xJXCuw~~JMg "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/3xmC9XyMMIf1gdmQ9kDmMA "Les champs de propriété générale suivants sont communs à tous les modèles de concepteur d’activité.") et [créé des variables d'entrée](https://servicenow-prod.fluidtopics.net/mc11vJNMoF0xm~vlBu3~gg#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/mc11vJNMoF0xm~vlBu3~gg#t_MapAnInputVariable "Une fois les variables d’entrée créées, 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 que cette activité 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, reportez-vous à la section Options de script SSH avancées sous le tableau. |
   | Répertoire | Répertoire sur l'hôte cible sur lequel la commande est exécutée. |
   | Balise d'informations d'identification | La balise d'informations d'identification Orchestration à utiliser lors de l'exécution de la commande. |
   | Options de Serveur MID requises | Serveur MID avec les options appropriées pour se connecter à l'hôte. Par défaut, le système sélectionne un Serveur MID avec des options SSH. |
   | Exécution longue | Si cette option est activée, le délai de connexion SSH est désactivé 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, l'utilisation de [sudo](https://www.servicenow.com/docs/access?context=r_SSHCredentialsForm&version=xanadu&pubname=xanadu-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 . Reportez-vous à [la section Variables de sortie de mappage automatique](https://servicenow-prod.fluidtopics.net/J2q7zgyq8NuisRVW~q5RuQ "Vous pouvez mapper automatiquement les valeurs des paramètres d’une charge utile de test aux variables de l’onglet Sorties .").

## Options de script SSH avancées

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 du 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("<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 Serveur MID, en utilisant le paramètre `${syncFile()}` , pour s'exécuter 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/J2q7zgyq8NuisRVW~q5RuQ "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/ccY~Tvf40Pqd4FRccPJnFQ#t_CreateAnOutputVariable "Le formulaire Sorties du concepteur contient un générateur de variables pour 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/f~2LcS_ZTX6IwV3tWKLd1Q#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 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/mQuHup_eFpmYMvFvUIllyQ#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 MID | Capacités MID | Chaîne (séparée par des virgules) | Liste des options de Serveur MID requises. |
| Options de valeur | valueCapabilities (en anglais seulement) | Tableau de la carte de hachage | Valeurs d'aptitude utilisées pour sélectionner le serveur MID. Pour plus d'informations, consultez [Options de Serveur MID](https://www.servicenow.com/docs/access?context=t_ConfigureCapabilities&version=xanadu&pubname=xanadu-servicenow-platform&section=r_MIDServerCapabilities&ft:locale=en-US). Si des options supplémentaires sont affectées par valeur, utilisez cet exemple pour personnaliser la sélection du 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 ou non. La valeur vrai indique que la commande a une exécution 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 SSH](https://www.servicenow.com/docs/access?context=r_SSHCredentialsForm&version=xanadu&pubname=xanadu-platform-security&ft:locale=en-US)[Sudo](https://www.servicenow.com/docs/access?context=r_SSHCredentialsForm&version=xanadu&pubname=xanadu-platform-security&ft:locale=en-US) doivent être utilisées. |
[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 la 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 (en anglais seulement) | eccSysID | Chaîne | Contient l'ID de référence associé au message d'entrée File d'attente ECC renvoyé par l'activité. |
| Messages d'erreur | Messages d'erreur | Chaîne | Contient les messages d'erreur récupérés à partir de la commande SSH. Cette valeur est nulle s'il n'y a pas de messages d'erreur. |
| Balises | balises | Carte de hachage des valeurs de balises renvoyées par 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 carte de hachage JavaScript dans lesquels chaque clé est préfixée par 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 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 les sorties des modèles 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/mc11vJNMoF0xm~vlBu3~gg#CreateInputVariables "Créez les variables à transmettre dans l’activité dans le formulaire Entrées du concepteur d’activité.") pour mapper aux champs disponibles. |
   | Hôte cible | Nom d'hôte ou adresse IP du serveur cible pour cette activité. |
   | Commande | Commande que cette activité exécute sur l'hôte cible. Vous pouvez invoquer un script de Serveur MID à partir de ce champ à l'aide de n'importe quel type de script pris en charge par la ligne de commande SSH. Pour plus d'informations, reportez-vous à la section Options de script SSH avancées sous le tableau. |
   | 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 Orchestration](https://www.servicenow.com/docs/access?context=c_AssignCredsOrchActivities&version=xanadu&pubname=xanadu-platform-security&ft:locale=en-US) à utiliser pendant l'exécution de la commande. |
   | Sélectionner Serveur MID par capacités | Serveur MID avec les options appropriées pour se connecter à l'hôte. Par défaut, le système sélectionne un Serveur MID avec des 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=xanadu&pubname=xanadu-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}