Utiliser la CLI pour la Console d’accès

L’outil d’interface de ligne de commande (CLI) vous permet de lancer et de gérer des sessions distantes directement à partir de la ligne de commande.

Pour utiliser l’outil CLI, vous devez être connecté à la console d’accès et l’outil CLI doit être installé. Il est installé depuis les Paramètres globaux. Lors de l’installation, vous recevrez peut-être des instructions pour ajouter l’emplacement d’installation au PATH, ou celui-ci peut être ajouté au PATH par le processus d’installation.

Une fois l’installation terminée, saisissez des commandes dans un terminal ou exécutez une boîte de dialogue pour interagir avec l’instance du technicien d’assistance connectée.

pour que les commandes fonctionnent, vous devez être connecté à la console d’accès.

Saisie de commandes

Saisissez une commande CLI unique avec des sous-commandes. 

1bt ssh <user>@<host>

Les sous-commandes prennent la forme suivante :

bt <command>

Lancer une session

Recherchez un compte Vault par son nom (pour les types qui peuvent injecter) et un élément de Jump par son nom. Les recherches d’éléments de Jump sont limitées au type représenté par la commande. Par exemple, bt ssh recherche uniquement les éléments de Shell Jump.

Si un seul des noms recherchés est trouvé, la session démarre avec l’élément de Jump et les informations d’authentification en question. Si plus d’un résultat est trouvé, vous êtes invité à choisir le compte et/ou l’élément de Jump correct.

Il est possible d’activer un indicateur pour afficher les informations du tunnel dans un format utilisable par un autre processus ou script, pour que les appels de session puissent être transmis à d’autres fonctions ou inclus dans des tâches automatisées, telles que les tâches de code VS. Si cet indicateur est activé, les informations du tunnel s’affichent, mais la connexion et l’outil externe ne s’ouvrent pas.

Exécution du rappel onExternalToolClicked()

Pour tous les types sauf SSH, le technicien d’assistance peut tenter d’exécuter le rappel onExternalToolClicked() pour le type donné avant de renvoyer le contrôle à l’outil CLI, plutôt que de transférer ce raisonnement à l’outil CLI lui-même.

Pour le SSH, la session SSH remplace le processus de l’outil CLI.

Utiliser les sous-commandes spécifiques à la session

SSH

Les sous-commandes SSH prennent la forme suivante :

ssh <account>@<host>

Une fois la session établie, le processus SSH est directement lancé pour se connecter au tunnel local et la session est terminée.

Créer une session SSH :
bt ssh <user>@<host>

RDP

Les sous-commandes RDP prennent la forme suivante :

rdp <account>@<host>

Une fois la session établie :

  • le client RDP par défaut est lancé.
  • les informations du tunnel sont affichées dans la CLI à des fins d’information.
  • la session est terminée.
Pour ouvrir l’outil RDP, saisissez :
bt rdp <user>@<host>

DB

Les sous-commandes DB prennent la forme suivante :

db <account>@<host>

Une fois la session établie :

  • le client DB est lancé pour le type de DB sélectionné, si possible. Une partie de la valeur renvoyée doit être le type de DB et/ou la commande à essayer.
  • les informations de connexion DB sont affichées.
  • la session est terminée.

Tunnel par protocole

Les sous-commandes de tunnel par protocole prennent la forme suivante :

pt <host>

Il n’y a pas d’injection d’informations d’authentification pour les tunnels par protocole.

Une fois la session établie, les définitions de tunnel sont affichées et la session est terminée.

Comme le tunnel est générique, il ne peut pas lancer un outil spécifique.

Utiliser d’autres sous-commandes

Liste

Les sous-commandes de liste prennent la forme suivante :

list

La sous-commande de liste affiche les sessions connectées par nom d’élément de Jump.

Fermer

Les sous-commandes de fermeture prennent la forme suivante :

close <session>

La sous-commande de fermeture ferme le tunnel pour la session donnée.