Les déclencheurs

Automatisez les flux de travail à l'aide du système de déclenchement.


Présentation du système de déclenchement

KeePass dispose d'un puissant système de déclenchement événement-condition-action. Avec ce système, les flux de travail peuvent être automatisés. Par exemple, vous pouvez définir un déclencheur qui télécharge automatiquement votre base de données sur un serveur de sauvegarde après avoir enregistré le fichier localement.

Un déclencheur commence à s'exécuter lorsque l'un des événements spécifiés correspond. Lorsque cela se produit, les conditions sont vérifiées. Si toutes les conditions sont remplies, les actions du déclencheur sont exécutées. Les actions sont exécutées consécutivement ; si une action échoue, l'exécution de l'événement est généralement interrompue (c'est-à-dire que toutes les actions suivantes ne sont pas exécutées).

Un déclencheur doit être à la fois activé et amorcé pour être exécuté. L'état activé est défini par l'utilisateur ; un déclencheur désactivé n'a aucune fonction. L'état amorcé dépend de l'état du programme. En activant l'option 'Initialement amorcé', un déclencheur est amorcé par défaut. Si vous activez l'option 'Désamorcé après l'exécution d'actions', le déclencheur sera désamorcé après avoir été exécuté une fois. Il existe des actions pour amorcer et désamorcer les déclencheurs, c'est-à-dire que des déclencheurs peuvent tourner eux-mêmes et d'autres déclencheurs s'amorcer et se désamorcer, ce qui permet de définir un système complexe de déclencheurs dépendant de déclencheurs.

La plupart des chaînes du système de déclenchement sont compilées par Spr, c'est-à-dire que des paramètres substituables (sauf ceux qui changent d'état), des variables d'environnement, etc., peuvent être utilisés.

Les données sensibles :
Certains événements/conditions/actions de déclenchement prennent en charge les champs pour les données potentiellement sensibles (par exemple : le champ mot de passe de l'action 'Ouvrir le fichier de la base de données'). Comme les déclencheurs sont enregistrés dans un fichier de configuration en texte brut, il n'est généralement pas recommandé de saisir directement des données sensibles dans les champs de déclencheur. Si une base de données est ouverte lorsque le déclencheur s'exécute, alors les données sensibles peuvent être stockées dans la base de données et le champ du déclencheur peut pointer vers les données à l'aide d'une référence de champ (que KeePass résout lors de l'évaluation du champ). De cette façon, seule la référence du champ apparaît dans le fichier de configuration et les données sensibles actuelles sont stockées dans le fichier de base de données chiffré.

Propriétés de connexion d'E/S :
La plupart des actions de déclenchement ayant un paramètre chemin/URL du fichier permettent uniquement de spécifier le chemin/l'URL et éventuellement les accréditations (nom d'utilisateur et mot de passe) pour accéder au fichier ; les propriétés de connexion avancées (comme le délai d'attente - timeout - , l'agent utilisateur, le mode passif, etc.) ne peuvent pas être spécifiées ici. Si des propriétés de connexion avancées sont requises, alors ouvrir le fichier une fois (en utilisant 'Fichier' → 'Ouvrir') avec les propriétés de connexion souhaitées. Cela créera un élément dans la liste de fichiers 'Rouvrir' (qui mémorise les propriétés de connexion). Lorsqu'une action de déclenchement est exécutée, KeePass charge les propriétés de connexion à partir de l'élément correspondant (même chemin/URL) dans la liste de fichiers 'Rouvrir'.


Événements

  • Application initialisée :
    cet événement se produit lorsque KeePass a terminé l'initialisation, mais n'a pas encore effectué d'automatisation de la fenêtre principale (comme l'ouverture d'une base de données par défaut).
    • Paramètres : Aucun.
  • Application démarrée et prête :
    cet événement se produit lorsque KeePass a démarré, a effectué des automatisations de la fenêtre principale (comme l'ouverture d'une base de données par défaut) et est prêt pour les actions de l'utilisateur.
    • Paramètres : Aucun.
  • Sortie de l'application :
    cet événement se produit lorsque KeePass est sur le point de quitter. Les bases de données ont déjà été fermées, mais les ressources (comme les polices, etc.) sont toujours valides.
    • Paramètres : Aucun.
  • Le fichier de la base de données est ouvert :
    cet événement se produit juste après qu'un fichier de base de données a été ouvert avec succès.
    • Fichier/adresse (URL) : un filtre d'événement facultatif. Si un filtre est spécifié (c'est-à-dire que quelque chose est entré dans 'Fichier/adresse (URL) - Filtre'), le déclencheur n'est évalué que si le filtre correspond au chemin du fichier de la base de données en cours. Par exemple : si vous entrez F:\ comme chaîne de filtre et spécifiez 'Commence par' comme méthode de comparaison, alors le déclencheur ne sera évalué que si le chemin de la base de données (qui vient juste d'être ouverte) commence par F:\.
  • Juste avant l'enregistrement du fichier de la base de données :
    cet événement se produit juste avant l'enregistrement d'un fichier de base de données.
    • Paramètres : voir l'événement 'Le fichier de la base de données est ouvert'.
  • Le fichier de la base de données a été enregistré :
    cet événement se produit juste après qu'un fichier de base de données a été enregistré avec succès.
    • Paramètres : voir l'événement 'Le fichier de la base de données est ouvert'.
  • Juste avant la synchronisation du fichier de la base de données :
    cet événement se produit juste avant qu'un fichier de base de données ne soit synchronisé avec un autre fichier de base de données.
    • Paramètres : voir l'événement 'Le fichier de la base de données est ouvert'.
  • Le fichier de la base de données vient juste d'être synchronisé :
    cet événement se produit juste après qu'un fichier de base de données a été synchronisé avec un autre fichier de base de données.
    • Paramètres : voir l'événement 'Le fichier de la base de données est ouvert'.
  • Fermeture du fichier de la base de données (avant l'enregistrement) :
    cet événement se produit juste avant la fermeture du fichier de la base de données. Cela se produit avant que KeePass enregistre automatiquement la base de données ou demande à l'utilisateur s'il souhaite enregistrer les modifications non enregistrées.
    • Paramètres : voir l'événement 'Le fichier de la base de données est ouvert'.
  • Fermeture du fichier de la base de données (après l'enregistrement) :
    cet événement se produit juste avant la fermeture d'un fichier de base de données. Le fichier de base de données était déjà enregistré automatiquement ou les modifications non enregistrées étaient enregistrées/abandonnées selon le choix de l'utilisateur.
    • Paramètres : Voir 'Fichier de la base de données est ouvert'
  • Les données de l'entrée sont copiées dans le presse-papiers :
    cet événement se produit lorsque les données de l'entrée (nom d'utilisateur, mot de passe, etc.) sont copiées dans le presse-papiers de Windows.
    • Valeur : un filtre de valeur facultatif (données copiées).
  • Temps - Périodique :
    cet événement se produit à des intervalles définis par l'utilisateur. L'événement n'est déclenché que si KeePass n'est pas occupé par une tâche différente (comme afficher une sous-boîte de dialogue).
    • Intervalle : Intervalle de temps entre les événements, en secondes.
    • Redémarrer le timer sur l'activité KeePass : si cette option est activée, une activité KeePass (interaction utilisateur, automatisation, sous-dialogue, activité de greffon, etc.) provoque un redémarrage du timer, c'est-à-dire qu'un intervalle complet doit s'écouler pour le prochain événement.
  • Clic sur un bouton personnalisé de la barre d'outils :
    cet événement se produit lorsque l'utilisateur clique sur un bouton personnalisé de la barre d'outils. Des boutons personnalisés de la barre d'outils peuvent être créés à l'aide de l'action du déclencheur 'Ajouter un bouton personnalisé à la barre d'outils'.
    • ID : ID du bouton de la barre d'outils sur lequel il a fallu cliquer (voir Actions).


Conditions

  • Variable d'environnement :
    • Nom : nom de la variable d'environnement à vérifier. Le nom ne doit pas être entouré par des caractères pourcentage (%).
    • Valeur : la valeur que la variable d'environnement spécifiée doit avoir pour que la condition soit vraie.
  • Chaîne de caractères :
    • Chaîne de caractères : une chaîne (KeePass Spr-compile cela, c'est-à-dire que vous pouvez, par exemple, utiliser des paramètres substituables)).
    • Valeur : la valeur que la chaîne évaluée spécifiée doit avoir pour que la condition soit vraie.
  • Le fichier existe :
    • Fichier : le fichier qui doit exister pour que la condition soit vraie.
  • L'hôte distant est joignable (ping) :
    • Hôte : l'hôte à qui envoyer le ping.
  • La base de données a des modifications non sauvegardées :
    évalue à vrai, si la base de données spécifiée a des modifications non sauvegardées.
    • Base de données : la base de données pour vérifier les modifications non sauvegardées.


Actions

  • Exécuter la ligne de commande ou l'adresse (URL) :
    Le fichier/l'URL et les arguments sont analysés par le moteur Spr avant d'être envoyés au shell, c'est-à-dire que des paramètres substituables génériques et dépendants de la base de données peuvent être utilisés. Si vous souhaitez utiliser des commandes shell intégrées, comme COPY, alors veuillez consulter : L'exécution de commandes Shell intégrées.
    • Fichier/adresse (URL) : la chaîne qui doit être exécuter par le shell.
    • Arguments : facultatif. Si 'Fichier/adresse (URL)' pointe vers un fichier exécutable, alors cette chaîne est envoyée à l'exécutable en tant qu'argument(s) de ligne de commande.
    • Attendre pour quitter : si cette option est cochée, alors KeePass attend indéfiniment la fin du processus démarré.
    • Style de fenêtre : spécifie comment la fenêtre principale du fichier/adresse (URL) exécuté(e) doit être affichée. Toutes les applications ne respectent pas ce paramètre.
    • Verbe : Spécifie l'action à effectuer. Une chaîne vide signifie utiliser le verbe par défaut. Certaines applications prennent en charge des verbes supplémentaires (par exemple : "Imprimer" pour imprimer le document spécifié). Lors de l'utilisation du verbe "RunAs", l'application est exécutée avec les droits d'administration (cela peut nécessiter une confirmation via la boîte de dialogue UAC).
  • Activer ou désactiver le déclencheur :
    • Nom du déclencheur : nom du déclencheur cible dont l'état activé/désactivé doit être modifié. Si ce champ est laissé vide, alors le déclencheur cible est le déclencheur courant.
    • Nouvel état : spécifie le nouvel état du déclencheur cible.
  • Ouvrir le fichier de la base de données :
    ouvre un fichier de base de données KDBX (dans un nouvel onglet). Si le fichier de base de données donné est déjà ouvert, alors KeePass le place au premier plan.
    • Fichier/adresse (URL) : le chemin du fichier de la base de données à ouvrir. S'il s'agit d'une adresse, alors le protocole (préfixe) doit être spécifié.
    • Connexion d'entrée/sortie - Nom d'utilisateur/Mot de passe : accréditation facultative utilisée pour la connexion au système de fichiers cible (par exemple : nom d'utilisateur/mot de passe du compte FTP). Cette accréditation n'est pas utilisée pour déchiffrer la base de données.
    • Mot de passe/Fichier clé/Compte utilisateur Windows : accréditation facultative qui est utilisée pour déchiffrer le fichier de la base de données.
  • Enregistrer la base de données active :
    enregistre la base de données actuellement active. Cette action enregistre toujours la base de données, même s'il n'y a pas de modifications non enregistrées. Pour n'enregistrer que s'il y a des modifications non enregistrées, alors utilisez la condition du déclencheur 'La base de données a des modifications non sauvegardées'.
    • Paramètres : Aucun.
  • Synchroniser la base de données active avec un fichier ou une adresse (URL) :
    synchronise la base de données actuellement ouverte et active avec un fichier.
    • Fichier/adresse (URL) : le chemin du fichier de la base de données avec lequel synchroniser. S'il s'agit d'une URL, alors le protocole (préfixe) doit être spécifié.
    • Connexion d'entrée/sortie - Nom d'utilisateur/Mot de passe : accréditation facultative utilisée pour la connexion au système de fichiers cible (par exemple : nom d'utilisateur/mot de passe du compte FTP). Cette accréditation n'est pas utilisée pour déchiffrer la base de données.
  • Importer dans la base de données active :
    importe un fichier dans la base de données actuellement ouverte et active.
    • Fichier/adresse (URL) : le chemin du fichier source à importer. S'il s'agit d'une URL, alors le protocole (préfixe) doit être spécifié.
    • Format de fichier : spécifie le format d'importation (voir la boîte de dialogue d'importation pour les valeurs possibles).
    • Méthode : spécifie le comportement des groupes/entrées qui existent à la fois dans la base de données actuellement active et dans le fichier en importation.
    • Mot de passe/Fichier clé/Compte utilisateur Windows : accréditation facultative qui est utilisée pour déchiffrer le fichier d'importation, si nécessaire. Si aucune accréditation n'est spécifiée, mais que le fichier d'importation est chiffré, alors KeePass affiche une boîte de dialogue d'invite de clé.
  • Exporter la base de données active :
    exporte la base de données actuellement ouverte et active vers un fichier.
    • Fichier/adresse (URL) : chemin du fichier cible vers lequel exporter. S'il s'agit d'une URL, alors le protocole (préfixe) doit être spécifié.
    • Format de fichier : spécifie le format d'exportation (voir la boîte de dialogue d'exportation pour les valeurs possibles).
    • Filtre - Groupe : spécifie le chemin du groupe à exporter (facultatif ; une chaîne vide signifie toute la base de données). Le chemin doit commencer par le caractère utilisé comme séparateur, et le nom du groupe racine de la base de données ne doit pas être spécifié. Par exemple : pour exporter un groupe 'B' qui est un sous-groupe du groupe 'A', alors spécifiez /A/B comme chemin de groupe.
    • Filtre - Balise (tag) : exporte uniquement les entrées qui ont la balise spécifiée (paramètre facultatif).
  • Fermer la base de données active :
    Fermez la base de données actuellement active.
    • Paramètres : Aucun.
  • Activer la base de données (sélectionner l'onglet) :
  • Fichier/adresse (URL) : le chemin de la base de données à activer. Il peut s'agir d'une sous-chaîne du chemin réel de la base de données. Par exemple : la spécification de MaBaseDeDonnées correspondrait à une base de données C:\Documents\KeePass\MaBaseDeDonnées.kdbx.
  • Filtre : spécifie les bases de données qui sont prises en compte. Si 'Déclenchement' est sélectionné et que le champ 'Fichier/adresse (URL)' est vide, alors la base de données qui a déclenché l'événement est activée.

Attendre :
attend le laps de temps spécifié.

  • Intervalle de temps : nombre de millisecondes à attendre.

Afficher la boîte de message :
Affiche une boîte de message.

  • Instruction principale : première ligne du texte du message (qui s'affiche éventuellement avec une police plus forte).
  • Texte : texte du message.
  • Icône : l'icône qui s'affiche à côté du texte du message.
  • Boutons : spécifie les boutons disponibles.
  • Bouton par défaut : le bouton qui a initialement le focus.
  • Action - Condition : spécifie la condition qui doit être remplie pour que l'action suivante soit exécutée. Par exemple : si 'Bouton OK/Oui' est sélectionné, alors l'action n'est effectuée que si l'utilisateur clique sur le bouton 'OK' ou 'Oui' de la boîte de message.
  • Action : l'action à effectuer après l'affichage de la boîte de message.
  • Action - Paramètres : paramètres de l'action spécifiée. Par exemple : si l'exécution d'une ligne de commande/adresse (URL) est spécifiée comme action, alors ce champ doit contenir la ligne de commande/adresse (URL).

Exécuter la saisie automatique globale :
exécute la saisie automatique globale (comme en appuyant sur la touche de raccourci clavier de la saisie automatique globale).

  • Paramètres : Aucun.

Exécuter la saisie automatique avec l'entrée sélectionnée :
exécute la saisie automatique avec l'entrée actuellement sélectionnée comme contexte.

  • Séquence : la séquence de frappes à envoyer. Si ce champ est vide, alors la séquence par défaut est utilisée.

Afficher les entrées par balise (tag) :
recherche toutes les entrées ayant la balise spécifiée et les affiche dans la liste des entrées de la fenêtre principale.

  • Balise (tag) : balise que les entrées doivent avoir.

Ajouter un bouton personnalisé à la barre d'outils  :
ajoute un bouton personnalisé à la barre d'outils de la fenêtre principale.

  • ID : ID du bouton de la barre d'outils (voir le gestionnaire d'événements).
  • Nom : texte qui est affiché sur le bouton de la barre d'outils.
  • Description : texte qui s'affiche dans l'info-bulle du bouton.

Enlever le bouton personnalisé de la barre d'outils :
supprime le bouton personnalisé de la barre d'outils de la fenêtre principale.

  • ID: ID du bouton de la barre d'outils (voir le gestionnaire d'événements).


Exemples

Consulter la page Trigger Examples page.