Aide PhishTrainer : mise en place
Complément Outlook pour Windows : guide administrateur
L’icône du bouton PhishTrainer dans votre messagerie
Sur cette page
Présentation
Le complément PhishTrainer Report pour Outlook pour Windows ajoute un groupe « PhishTrainer by Bexxo » dans Outlook. Vos collaborateurs l’utilisent pour transmettre un email suspect (phishing ou spam) à l’équipe de sécurité de votre organisation, via PhishTrainer.
Il s’agit d’un complément VSTO, installé sur chaque poste par un programme d’installation MSI. L’éditeur affiché est « Bexxo by tesweb SA ». PhishTrainer est un logiciel Bexxo, le pôle cybersécurité de Tesweb SA. Ce guide décrit la version 2.2.2 du complément.
Versions prises en charge
- Outlook 2016, Outlook 2019 et Outlook 2021 ;
- Outlook Microsoft 365, application de bureau classique ;
- sur Windows 64 bits. Outlook peut être en 32 ou en 64 bits : le complément est inscrit pour les deux.
Outlook pour Windows (VSTO) ou complément Microsoft 365 ?
PhishTrainer propose deux compléments Outlook, à choisir selon le client Outlook de vos collaborateurs :
| Client Outlook | Complément à utiliser |
|---|---|
| Outlook classique installé sur les postes Windows, notamment les versions sans abonnement (2016, 2019, 2021) | Ce complément : Outlook pour Windows (VSTO) |
| Outlook sur le web, nouvel Outlook pour Windows, Outlook mobile | Le complément Outlook Microsoft 365, décrit dans un guide séparé |
Les deux peuvent être combinés : chacun est une source de signalement distincte dans PhishTrainer.
Prérequis du poste
- Windows 64 bits ;
- .NET Framework 4.7.2 ou plus récent ;
- Visual Studio 2010 Tools for Office Runtime ;
- droits d’administrateur du poste pour l’installation : le MSI installe le complément pour tous les utilisateurs de la machine, dans
C:\Program Files\PhishTrainer\Report; - accès https sortant vers
app.phishtrainer.com. Le complément passe par le proxy système de Windows, avec les identifiants Windows de l’utilisateur.
Sans .NET Framework 4.7.2 ou sans Visual Studio 2010 Tools for Office Runtime, le MSI refuse de s’installer et affiche le composant manquant (message en anglais).
Données traitées
Lors d’un signalement
- l’email signalé complet (format .msg, pièces jointes comprises, sauf si le collaborateur choisit de l’envoyer sans elles) ;
- le type choisi (phishing ou spam) et les cases cochées par le collaborateur (lien cliqué, pièce jointe ouverte, mot de passe ou informations saisis, réponse ou appel) ;
- la langue du complément ;
- l’adresse de la boîte aux lettres qui contient l’email.
Si le collaborateur indique avoir saisi un mot de passe ou ouvert une pièce jointe, et que l’email n’est pas une simulation PhishTrainer, une alerte est envoyée par email aux administrateurs PhishTrainer. L’alerte ne bloque jamais le signalement.
Lors de l’activation d’un poste
- le nom du poste, l’utilisateur Windows et la version du complément ;
- les adresses des boîtes aux lettres reliées (voir plus loin) : le serveur n’en garde que des empreintes.
Le poste est ensuite identifié par un jeton d’appareil, chiffré localement pour l’utilisateur Windows. Le collaborateur n’a ni compte ni mot de passe PhishTrainer.
Sur le poste
Le complément tient un journal local, sans jeton, sans adresse email et sans contenu de message, dans %LOCALAPPDATA%\PhishTrainer\Report\logs (un fichier par jour, conservé 7 jours).
Les données sont hébergées exclusivement en Suisse. La durée de conservation des emails signalés est fixée par le contrat conclu entre votre organisation et Bexxo.
1Créer la source dans PhishTrainer
- Dans PhishTrainer, ouvrez Réception des signalements, puis cliquez sur Ajouter une source.
- Dans le groupe « Un bouton « Signaler » dans la messagerie », choisissez Outlook pour Windows (VSTO).
- Dans l’onglet Réglages :
- Nom de la source : nom libre, affiché dans PhishTrainer.
- Réception activée : laisser coché pour accepter les signalements.
- Supprimer l’email après le signalement : « Une fois le signalement accepté par le serveur, le complément place l’email signalé dans les Éléments supprimés du collaborateur, d’où il reste récupérable. »
- Enregistrez. Le code d’activation s’affiche dans l’onglet Réglages, et les onglets Installation, Message aux collaborateurs et Appareils enrôlés apparaissent.
- Dans l’onglet Installation, récupérez le MSI (Télécharger le MSI) ou son lien direct (Copier le lien). Le fichier se nomme
PhishTrainer-Report-<version>.msi.
Code d’activation : il relie un poste à votre organisation. Traitez-le comme une information interne : ne le publiez pas. En cas de fuite, régénérez-le (voir « Gérer les postes »). Le lien de téléchargement du MSI, lui, est public.
2Installer et activer le complément
Le code d’activation peut être fourni de trois façons. Les deux premières activent les postes sans action des collaborateurs.
| Méthode | Usage |
|---|---|
| Stratégie de groupe (GPO) | Valeur de registre posée sur les postes. Elle l’emporte sur les autres méthodes. |
| Installation silencieuse avec code | Intune, SCCM, script. |
| Saisie par le collaborateur | Installation poste par poste, petits parcs. |
Poste par poste
- Lancez le MSI sur le poste, avec un compte administrateur du poste. L’assistant, en anglais, ne demande aucune saisie : Bienvenue, Installer, Terminer.
- Redémarrez Outlook. Le groupe « PhishTrainer by Bexxo » apparaît dans l’onglet Accueil. Office peut demander une fois de faire confiance à l’éditeur : acceptez.
- Dans ce groupe, cliquez sur Paramètres, collez le code d’activation (bouton Coller), puis cliquez sur Activer.
L’installation ne demande aucun code : vous pouvez installer le complément et l’activer plus tard. Tant qu’il n’est pas activé, un clic sur un bouton de signalement ouvre la fenêtre « Découvrir PhishTrainer », qui propose de le configurer.
Si les collaborateurs installent et activent eux-mêmes le complément, l’onglet Message aux collaborateurs de la source fournit un texte prêt à envoyer, avec le lien de téléchargement et le code d’activation. Il leur faut alors des droits d’administrateur sur leur poste.
Déploiement en masse, option 1 : installation silencieuse
Commande à exécuter avec des droits d’administrateur (par exemple par Intune, SCCM ou un script de démarrage) :
- L’onglet Installation de la source affiche cette commande avec le nom du fichier et votre code déjà renseignés.
- Le code n’est pas écrit dans le journal d’installation de msiexec.
- Lors d’une mise à jour ou d’une réparation lancée sans code, le code déjà installé est repris.
Déploiement en masse, option 2 : stratégie de groupe (GPO)
Installez le MSI sans code, puis créez cette valeur de registre sur les postes, par exemple avec une préférence de stratégie de groupe :
| Élément | Valeur |
|---|---|
| Clé | HKEY_LOCAL_MACHINE\Software\Policies\PhishTrainer\Report |
| Nom de la valeur | EnrollmentToken (REG_SZ) |
| Donnée | le code d’activation de l’onglet Réglages |
- Le code d’activation, le paramètre
ENROLLMENTTOKENdu MSI et la valeurEnrollmentTokendésignent la même valeur. Si un poste reçoit les deux, la valeur de stratégie l’emporte sur celle du MSI. - Avec un code posé par stratégie, la fenêtre Paramètres n’affiche plus la saisie du code, mais : « La connexion est gérée par votre service informatique : aucune action n’est nécessaire de votre part. »
- Si vous changez la valeur de stratégie (par exemple après avoir régénéré le code), le poste se réactive avec le nouveau code au prochain démarrage d’Outlook ou à la synchronisation suivante.
Synchronisation : le complément s’active ou synchronise sa configuration au démarrage d’Outlook, puis toutes les 12 heures. Le bouton Synchroniser maintenant des Paramètres la déclenche à la demande. L’activation est propre à chaque utilisateur Windows : sur un poste partagé, chaque session Windows est activée séparément (automatiquement avec la GPO ou le code du MSI).
3Vérifier que tout fonctionne
- Dans Outlook, le groupe « PhishTrainer by Bexxo » de l’onglet Accueil affiche Signaler comme phishing, Signaler comme spam, Paramètres et À propos.
- Dans Paramètres, la section « État de la connexion » indique Connecté et le nom de votre organisation.
- Sélectionnez un email reçu et cliquez sur Signaler comme spam : la fenêtre « Signaler cet email » s’ouvre. Envoyez le signalement et vérifiez qu’il arrive dans PhishTrainer.
- Dans l’onglet Appareils enrôlés de la source (bouton Actualiser), le poste apparaît avec les colonnes Machine, Utilisateur Windows, Version et Dernière activité.
Si l’option Supprimer l’email après le signalement est activée, l’email d’essai est déplacé dans les Éléments supprimés.
Boîtes aux lettres reliées
À l’activation, le poste relie à PhishTrainer jusqu’à 5 adresses de boîtes aux lettres présentes dans le profil Outlook. Un collaborateur ne peut signaler que les emails d’une boîte reliée.
- Boîte ajoutée au profil après l’activation : Outlook affiche « Nouvelle boîte aux lettres dans Outlook ». Avec un code posé par GPO ou par le MSI, le bouton Relier maintenant relie la boîte sans saisie (et le complément tente de la relier seul au démarrage d’Outlook). Sinon, le collaborateur rouvre les Paramètres et colle de nouveau le code d’activation.
- Boîte partagée ouverte sans compte dans le profil : ses emails sont signalés au nom de l’utilisateur du poste.
- Au-delà de cinq comptes dans le profil, le sixième ne peut pas être relié.
Gérer les postes
| Action | Effet |
|---|---|
| Révoquer (onglet Appareils enrôlés) | Seul ce poste perd l’accès et ne peut plus se réactiver avec le code. Les autres postes ne sont pas touchés. Le collaborateur voit « Votre accès a été retiré. Contactez votre service informatique. » |
| Rétablir | Rend l’accès au poste. Il est pris en compte à la synchronisation suivante (démarrage d’Outlook, toutes les 12 heures, ou Synchroniser maintenant). |
| Régénérer le code (onglet Réglages) | Les postes déjà activés continuent de fonctionner. Seules les nouvelles activations ont besoin du nouveau code : mettez à jour la stratégie de groupe, vos scripts d’installation et le message aux collaborateurs. À faire en cas de fuite du code. |
| Désactiver la réception (interrupteur Réception activée) | Les signalements sont refusés et le collaborateur voit « Le service de signalement est désactivé pour votre organisation. Votre poste reste relié : les signalements fonctionneront à nouveau dès sa réactivation. Contactez votre service informatique. » Les postes restent activés. |
Mettre à jour
Le complément ne se met pas à jour tout seul. Il vérifie au plus une fois par jour s’il existe une version plus récente : une pastille orange apparaît alors sur le bouton À propos, dont la fenêtre propose Télécharger. L’installation demande les droits d’administrateur du poste.
En entreprise, redéployez le nouveau MSI (même commande ou même méthode qu’à l’installation). Une nouvelle version remplace l’ancienne ; une version plus ancienne que celle installée est refusée. L’onglet Installation de la source indique la dernière version publiée.
Désinstaller
Le complément est installé comme le programme « PhishTrainer Report » (éditeur « Bexxo by tesweb SA ») : désinstallez-le comme tout programme Windows. Pensez aussi à révoquer le poste dans l’onglet Appareils enrôlés.
Dépannage
| Ce qu’on voit | Cause probable | Que faire |
|---|---|---|
| Groupe « PhishTrainer by Bexxo » absent | Complément non installé, désactivé par Outlook, ou confiance à l’éditeur refusée | Vérifier que « PhishTrainer Report » est installé, puis l’état du complément « PhishTrainer » dans les compléments COM d’Outlook |
| Fenêtre « Découvrir PhishTrainer » au clic sur un bouton de signalement | Poste non activé | Coller le code dans Paramètres, ou le fournir par GPO ou par le MSI |
| « Sélectionnez l’email à signaler. » / « Seuls les emails peuvent être signalés. » | Rien de sélectionné, ou élément qui n’est pas un email | Sélectionner un email |
| « Cet email n’a pas été reçu (brouillon ou email non envoyé) : il ne peut pas être signalé. » | Brouillon | Signaler un email reçu |
| « Cet email est chiffré ou protégé : il ne peut pas être analysé… » | Email S/MIME ou protégé par des droits (IRM) | Le collaborateur transfère l’email au service informatique |
| « Cet email se trouve dans une boîte aux lettres qui n’est pas encore reliée à PhishTrainer sur ce poste… » | Boîte ajoutée à Outlook après l’activation | Relier la boîte (voir « Boîtes aux lettres reliées ») |
| « Cet email est trop volumineux (plus de 10 Mo)… » | Email de plus de 10 Mo | Le collaborateur transfère l’email au service informatique |
| « Sélectionnez au plus 20 emails à la fois. » | Signalement groupé trop grand | Réduire la sélection |
| « Votre accès a été retiré. Contactez votre service informatique. » | Poste révoqué | Si la révocation n’était pas voulue : Rétablir |
| « Le service de signalement est désactivé pour votre organisation… » | Réception désactivée dans PhishTrainer | Réactiver la réception |
| « Le serveur a refusé ce code d’activation. Contactez votre service informatique. » | Code erroné ou ancien code après régénération | Fournir le code actuel de l’onglet Réglages |
| « L’activation de l’extension n’est plus valide… » | Jeton d’appareil refusé, sans code posé par l’informatique | Le collaborateur colle de nouveau le code dans Paramètres |
| « Le serveur PhishTrainer est injoignable. Réessayez plus tard. » ou état Configuré, serveur injoignable | Réseau, proxy ou pare-feu | Réessayer ; vérifier l’accès à app.phishtrainer.com en https |
| « Trop de demandes en peu de temps. Réessayez dans quelques minutes. » | Limite atteinte (60 signalements en 10 minutes par poste) | Attendre |
| Fenêtre « Adresse du serveur non sécurisée » | Adresse de serveur configurée par stratégie qui n’est pas en https | Corriger la stratégie : aucun signalement ne part tant qu’elle n’est pas corrigée |
Sans connexion au serveur, le signalement n’est pas mis en attente : il échoue et le collaborateur doit le refaire.
Informations pour le support
Dans la fenêtre À propos, le bouton Copier les informations de diagnostic copie dans le presse-papiers la version du complément, d’Outlook et de Windows, l’état de la connexion, l’organisation, la date de la dernière synchronisation, l’identifiant du poste et l’emplacement des journaux. Ces informations ne contiennent ni jeton ni code d’activation. Joignez-y si besoin les journaux du poste, situés dans le dossier indiqué dans la section « Données traitées ».
Support : pour toute question sur l’installation, écrivez à info@bexxo.ch.
Vous n’avez pas trouvé la réponse ? Nous contacter