Activation et configuration du capteur Automation Action Script

Avant d'activer ce capteur, procédez comme suit :

1. Consultez les informations fournies dans la section « Utilisation sécurisée du cadre d'automatisation ».
2. Si le capteur est utilisé dans un environnement auto-hébergé (sur site), assurez-vous que l 'indicateur de fonctionnalité d'automatisation est activé.

Par défaut, le détecteur est désactivé. Pour activer le capteur, modifiez le fichier de configuration de l'agent comme indiqué dans l'exemple suivant :

com.instana.plugin.action.script:
  enabled: true # by default is false
 

Par défaut, le détecteur de script d'action crée et exécute les scripts à partir du répertoire temporaire par défaut de l'agent *instanaAgentDir*/data/tmp. Pour modifier cet emplacement, ajoutez les attributs scriptExecutionHome à la configuration du détecteur de script dans le fichier de configuration de l'agent. La valeur scriptExecutionHome ne doit pas contenir d'espace. Si le répertoire temporaire par défaut de l'agent *instanaAgentDir*/data/tmp contient un caractère espace, vous devez indiquer une valeur pour scriptExecutionHome.

com.instana.plugin.action.script:
  enabled: true
  scriptExecutionHome: '/myExecutionDir' # The path used for action script executions.
 

Par défaut, le capteur Action Script exécute les scripts sous l'identité de l'utilisateur qui a lancé l'agent d' Instana. Sur les systèmes d'exploitation Linux, AIX et Solaris, les scripts d'action ne peuvent pas s'exécuter en tant qu'administrateur. De même, sous Windows Windows, les scripts ActionScript ne peuvent pas s'exécuter en tant qu'administrateur. Pour configurer le détecteur de script d'action afin qu'il exécute les scripts d'action avec d'autres données d'identification, ajoutez les attributs runAs et scriptExecutionHome à la configuration du détecteur de script dans le fichier de configuration de l'agent. L'utilisateur runAs requiert des droits read, writeet execute dans le répertoire scriptExecutionHome . Pour l' Windows e, vous devez également indiquer le mot de passe de runAs l'utilisateur dans runAsUserPassword l'attribut. Utilisez le coffre-fort comme runAsUserPassword indiqué dans la configuration suivante d' YAML. Avant de choisir un nom d'utilisateur pour runAs l'utilisateur, consultez les informations fournies dans la section « Création d'un utilisateur dédié pour les actions de script ».

com.instana.plugin.action.script:
  enabled: true
  runAs: 'aUser'
  scriptExecutionHome: '/myExecutionDir' # The path used for action script executions.
  runAsUserPassword: # Required on Windows operating system.
    configuration_from:
      type: vault
      secret_key:
        path: <secret_path>
        key: <secret_key>
 

Par défaut, le détecteur de script exécute au maximum 10 actions de script simultanées. Si vous souhaitez modifier le nombre maximal d'actions de script simultanées, ajoutez l'attribut maxConcurrentActions à la section de configuration du détecteur de script dans le fichier de configuration de l'agent comme suit:

com.instana.plugin.action.script:
  enabled: true
  maxConcurrentActions: 5  # optional, default value is 10
 

Lorsque vous créez une action de script, vous pouvez définir le délai d'attente maximal, en secondes, avant que l'action de script ne se termine. Si vous ne définissez pas le délai d'attente de l'action de script lors de la création de l'action de script, une action de script expire par défaut au bout de 300 secondes. Si vous souhaitez modifier ce délai d'attente par défaut pour l'exécution du script d'action, ajoutez l'attribut defaultTimeout à la section de configuration du détecteur de script dans le fichier de configuration de l'agent comme suit:

com.instana.plugin.action.script:
  enabled: true
  defaultTimeout: 600 # optional, default timeout is 300 seconds
 

chroot est utilisé pour créer un sandbox limité dans lequel le script d'action doit s'exécuter. Par conséquent, le script ne peut pas modifier de manière malveillante les données en dehors de l'arborescence du répertoire scriptExecutionHome . La prise en charge chroot d'ActionScript est disponible pour les agents fonctionnant sous les systèmes d'exploitation AIX, Linux et Solaris. Lorsque chroot est activé, scriptExecutionHome est utilisé comme répertoire racine pour le processus de script d'action. Vous devez copier dans le répertoire scriptExecutionHome toutes les commandes système, interpréteurs, binaires, bibliothèques et exécutables requis pour l'invocation du script d'action. Au minimum, vous devez copier la commande su utilisée en interne par le capteur pour remplacer l'utilisateur. Pour activer le chroot pour ActionScript, modifiez le fichier de configuration de l'agent comme indiqué dans l'exemple suivant :

com.instana.plugin.action.script:
  enabled: true
  chrootEnabled: true # by default, chroot support is disabled
  scriptExecutionHome: '/home/test' # The path used for action script executions
 

Si l'action de script de votre catalogue d'actions utilise des paramètres de type « Vault », vous devez intégrer l'agent hôte à un gestionnaire de secrets.

Lorsque vous exécutez les actions de script sur des systèmes d'exploitation d' Windows, vous devez tenir compte des conditions préalables et des restrictions suivantes.