Créer un connecteur PSM pour une application web
Quand une console a sa propre page de connexion et rien au Marketplace, PSM peut quand même l'ouvrir pour vos utilisateurs : isolée, enregistrée, avec le mot de passe saisi à leur place. Voici comment construire ce connecteur, le tester et le faire durer.
L'essentiel
Un connecteur web PSM est un composant de connexion qui pilote un vrai navigateur sur le serveur PSM. Il suit une courte liste d'instructions, les WebFormFields, pour saisir les identifiants du coffre dans la page de connexion, vérifie que la connexion a réussi, puis passe la fenêtre à l'utilisateur.
- Vérifier d'abord : si le Marketplace propose déjà un connecteur pour votre console, déployez-le. Ne développez que ce que personne ne couvre.
- Le framework : CyberArk (désormais Idira) le fournit sous le nom de Secure Web Application Connectors Framework. Il pilote Chrome ou Edge par Selenium WebDriver et, depuis la version 14.6, utilise par défaut un dispatcher 64 bits.
- Le travail : copier le composant d'exemple, décrire la connexion en quelques lignes, rattacher le composant à une plateforme, tester.
- Le vrai coût, c'est l'entretien : les navigateurs se mettent à jour toutes les quelques semaines, et le pilote doit avoir exactement la version du navigateur. Prévoyez-le dès le premier jour.
Avant de développer : quatre voies
Il existe quatre façons de placer une session web à privilèges sous contrôle, de la moins chère à la plus chère. Vérifiez les deux premières avant de payer la troisième.
| Votre cible | La bonne voie |
|---|---|
| Une console déjà couverte par le Marketplace | Déployer le connecteur du MarketplaceEmpaqueté et documenté. Le tester sur votre version reste votre affaire. |
| Une application SaaS que vos utilisateurs ouvrent par Idira Identity | Secure Web SessionsL'activité est enregistrée depuis le navigateur de l'utilisateur, par une extension. Pas de serveur de rebond, donc pas d'isolation. |
| Une console web avec page de connexion, chez vous ou dans le cloud | Un connecteur web PSM, l'objet de ce guideLa session tourne sur le serveur PSM : isolée, enregistrée, et le mot de passe n'atteint jamais le poste de travail. |
| Un client lourd Windows | Un Universal ConnectorL'automatisation du client en AutoIt ou avec le SDK : un autre métier, présenté sur notre page sur le développement de connecteurs. |
C'est l'isolation qui distingue la troisième voie de la deuxième. Quand la console administre quelque chose d'important, comme un pare-feu, un hyperviseur ou un système de sauvegarde, la session doit tourner loin du poste de l'utilisateur. C'est précisément le rôle de PSM.
Le déroulé d'une session web PSM
Un connecteur web est une chaîne de cinq maillons. Savoir qui fait quoi fait gagner des heures le jour où quelque chose casse.
- 1 L’utilisateur clique sur Connect dans le PVWA, qui ouvre une session sur un serveur PSM.
- 2 PSM prend le mot de passe du compte dans le Vault ; l’utilisateur ne le reçoit jamais.
- 3 WebAppDispatcher lance Chrome ou Edge par le WebDriver.
- 4 Le pilote remplit la page de connexion d’après les lignes WebFormFields, puis contrôle l’élément de validation.
- 5 L’utilisateur reprend la fenêtre du navigateur par RDP. Toute la session est enregistrée.
Trois détails comptent en pratique. Le navigateur tourne sur le serveur PSM, en navigation privée, et PSM lie la session à cette fenêtre. Le pilote, chromedriver.exe ou msedgedriver.exe, doit avoir exactement la version du navigateur. Et la connexion est un script : si une ligne échoue, l'utilisateur reçoit une erreur au lieu de la console. Par défaut, le navigateur reste réduit derrière une barre de progression pendant ce script.11Le paramètre MinimizeBrowserWhenLoading, sur Yes par défaut. Le passer à No pendant la mise au point permet de suivre chaque étape.
Prérequis
| Élément | Ce qu'il faut |
|---|---|
| PSM | 14.2.3 ou ultérieure pour le framework actuel. Depuis la 14.6, le dispatcher 64 bits est celui par défaut. |
| Framework | La dernière version du Secure Web Application Connectors Framework, sur le Marketplace (Integrations). Depuis les pilotes de navigateur 133, la version 14.6.0.244 au minimum. |
| Navigateur | Google Chrome 100 ou ultérieur, ou Microsoft Edge 103 ou ultérieur, en 32 ou 64 bits. Le mode IE d'Edge n'est pas pris en charge. |
| Pilote | chromedriver.exe ou msedgedriver.exe exactement à la version du navigateur, dans le dossier Components de PSM. |
| Durcissement | Le script de durcissement de PSM lancé avec la prise en charge des applications web, et le navigateur autorisé dans la configuration AppLocker. |
| Plateforme | Le caractère > ajouté aux caractères interdits dans les mots de passe de la plateforme, comme l'exige la documentation : c'est le séparateur de chaque ligne WebFormFields. |
Pas à pas
- Installer le frameworkDécompressez l'archive du Marketplace sur le serveur PSM et copiez le contenu de son dossier Components dans
PSM\Componentspour le dispatcher 32 bits, ou dansPSM\Components\x64pour le 64 bits. - Préparer le navigateurInstallez Chrome ou Edge et le pilote correspondant. Lancez
PSMHardening.ps1avec la prise en charge des applications web (option-supportWebApplication, ou$SUPPORT_WEB_APPLICATIONSsur un serveur hors domaine), puis autorisez le navigateur dansPSMConfigureAppLocker.xmlet lancezPSMConfigureAppLocker.ps1. Vérifiez que le chemin indiqué dans le fichier XML est bien celui où le navigateur est installé. - Copier l'exempleDans le PVWA, sous Administration, Configuration Options, Options, Connection Components, copiez
PSM-WebAppSample, collez-le, et donnez à la copie son propre Id et son nom d'affichage. - Décrire la connexionSous Target Settings, Web Form Settings :
LogonURLest la page de connexion et accepte les propriétés du compte, comme danshttps://{Address}/login;WebFormFieldscontient les lignes de connexion ;EnforceCertificateValidationreste sur Yes. - Choisir le navigateurRéglez
ClientAppsur Chrome, la valeur par défaut, ou sur Edge, et laissezMainWindowClassàChrome_WidgetWin_1, la bonne valeur pour les deux. - Ne toucher aux délais qu'en cas de besoin
ActionTimeout(10 secondes par défaut) etPageLoadTimeout(30 secondes) conviennent à la plupart des consoles. Un équipement lent peut demander davantage. - Rattacher le composant à une plateformeDans Platform Management, modifiez la plateforme, ajoutez le composant de connexion sous UI & Workflows avec son Id et Enable à Yes, puis ajoutez
>à ses caractères interdits. - Tester avec un compte de laboConnectez-vous depuis le PVWA. Si la connexion échoue, activez le débogage avancé et lisez les captures, comme décrit plus bas.
Quand la connexion a besoin des identifiants du compte de connexion lié (logon account), ajoutez la capacité LogonAccount au composant (Target Settings, Supported Capabilities) et utilisez ses paramètres, listés dans la section suivante.
L'aide-mémoire WebFormFields
WebFormFields est une liste de lignes exécutées de haut en bas. Chaque ligne trouve un élément de la page et en fait une seule chose, toujours dans le même ordre : l'identifiant, le séparateur >, la valeur ou l'action, puis la façon de trouver l'élément.
Modèle
identifiant > valeur ou (Action) (SearchBy=Id|Name|Class|Text|XPath)
| Pour | Écrire |
|---|---|
| Saisir dans un champ | username > {username} (SearchBy=Id)Ajoutez (SendSlow=0.2) pour les champs qui perdent des caractères tapés trop vite : la valeur est le délai, en secondes, entre deux caractères. |
| Cliquer | login > (Button) (SearchBy=Id)(Click) fait de même sur tout élément cliquable. |
| Cliquer par JavaScript | menu > (ScriptClick) (SearchBy=Id)Pour les éléments masqués ou dynamiques qui ignorent un clic normal. |
| Prouver que la connexion a réussi | logout > (Validation) (SearchBy=Id)(Verification) est équivalent. Les lignes de validation viennent en dernier. |
| Expliquer un échec | error > (Failure) (SearchBy=Class) (Message=Votre texte)Affiche vos mots au lieu d'un « Element not found » générique. |
| Entrer dans un cadre | main > (iFrame) (SearchBy=Id)(iFrame) seul entre dans un cadre sans identifiant, plus lentement. Les cadres imbriqués fonctionnent ; (MainWindow) revient à la page. |
| Ouvrir une autre page | (Navigate=https://console.example/home)L'adresse doit contenir ://. |
| Faire une pause | (Wait=1)Ferme aussi un bloc de validation, voir plus bas. |
| Saisir un code MFA | Run Generate_TOTP_MFA_Code (MFADeviceSecret=…), puis otp > &MFACode&Codes TOTP uniquement. Lisez la remarque de sécurité avant de l'utiliser. |
| Brancher selon la page | if ((…)) … end-ifAvec else-if, else et les conditions Exists, Count et Placeholder. |
- Valeurs du compte
{username},{password},{address}et toute autre propriété du compte, comme{domain}:{username}@{domain}est valide.- Comptes liés
{logonaccount\username},{reconcileaccount\password},{extraaccount\password}. Les valeurs du compte de connexion exigent la capacité LogonAccount.- Valeurs PreConnect
- Ce que renvoie votre propre DLL PreConnect, écrit
&nom&. - XPath
- Placez un accent circonflexe devant chaque crochet :
//form^[@id='login'^]//button. - Ordre de recherche
- Sans SearchBy, l'élément est cherché par Id, puis Name, puis Class. Nommer la méthode évite les surprises.
Une règle de validation piège tout le monde une fois. Une ligne de validation ouvre un bloc : les lignes compatibles qui la suivent, comme iFrame, Navigate ou MainWindow, restent dans ce bloc et sont ignorées dès qu'une validation réussit. Plusieurs lignes de validation à la suite valent des alternatives : une seule réussite suffit. Pour naviguer après une validation réussie, intercalez une autre commande, comme (Wait=1).
Un exemple complet, ligne par ligne
Pour montrer la méthode sans toucher à la console de personne, nous prenons la page de connexion de the-internet, un site d'entraînement open source de Sauce Labs sur lequel s'exercent les utilisateurs de Selenium. Ses identifiants de démonstration sont affichés sur la page : en labo, rangez-les dans un compte de test, dans un safe de test.
1. Lire la page de connexion
Ouvrez la page dans le navigateur du serveur PSM lui-même, puis inspectez le formulaire. Les deux champs ont pour id username et password. Le bouton n'a ni id ni name, seulement la classe radius.
2. Lire la page qui suit la connexion
C'est l'étape que la plupart sautent, et c'est là que la validation se trompe. L'espace sécurisé qui suit une connexion réussie contient un lien de déconnexion vers /logout, un message de réussite et un élément dont l'id est… username, comme le champ de connexion.
- Valider sur
usernameréussirait sur la page de connexion elle-même : une connexion ratée passerait pour un succès. - Valider sur la classe
radiusréussirait aussi : le bouton de connexion et le lien de déconnexion la partagent. - Le lien de déconnexion n'existe qu'après une connexion réussie. C'est l'élément à contrôler.
3. Écrire les lignes
LogonURL
https://the-internet.herokuapp.com/login
WebFormFields
username > {username} (SearchBy=Id)
password > {password} (SearchBy=Id)
radius > (Button) (SearchBy=Class)
error > (Failure) (SearchBy=Class) (Message=Le site a refusé le mot de passe du coffre)
//a^[@href='/logout'^] > (Validation) (SearchBy=XPath)
Ligne par ligne : remplir les deux champs avec les identifiants du compte, cliquer sur le bouton, afficher un message clair si le site montre son bandeau d'erreur (sa classe contient error), et confirmer la réussite sur le lien de déconnexion. Les accents circonflexes de la dernière ligne protègent les crochets du XPath, comme l'exige le framework.
Sur une vraie console, la LogonURL devient en général https://{Address}/login : un seul composant de connexion sert alors tous les équipements du même modèle.
Les connexions plus difficiles
Connexion en deux écrans
Beaucoup de consoles demandent l'identifiant, puis affichent le champ du mot de passe sur un second écran. Il suffit d'ajouter des lignes : saisir l'identifiant, cliquer sur Suivant, saisir le mot de passe, cliquer sur Se connecter. Les pauses sont rarement utiles, car le framework attend déjà que chaque élément soit utilisable, jusqu'à WaitForElementActionableTimeout (ActionTimeout s'il n'est pas renseigné). Augmentez ce délai avant d'ajouter des lignes (Wait).
identifier > {username} (SearchBy=Id)
next > (Button) (SearchBy=Id)
password > {password} (SearchBy=Name)
signin > (Button) (SearchBy=Id)
account-menu > (Validation) (SearchBy=Id)
Cadres
Les consoles anciennes chargent souvent le formulaire dans un cadre. Entrez-y avant les champs, puis revenez à la page principale avant de valider un élément situé hors du cadre.
(iFrame)
user > {username} (SearchBy=Name)
pass > {password} (SearchBy=Name)
signin > (Button) (SearchBy=Id)
(MainWindow)
nav-menu > (Validation) (SearchBy=Id)
Codes MFA
Pour une MFA à base de TOTP, le framework peut calculer le code lui-même à partir du secret de l'appareil, et le saisir là où vous écrivez &MFACode& :
username > {username} (SearchBy=Id)
password > {password} (SearchBy=Id)
login > (Button) (SearchBy=Id)
Run Generate_TOTP_MFA_Code (MFADeviceSecret=VOTRE-SECRET-BASE32)
otp > &MFACode& (SearchBy=Name)
dashboard > (Validation) (SearchBy=Id)
L'exemple de la documentation écrit le secret dans le composant de connexion. Considérez-le comme un raccourci de labo : quiconque lit la configuration du PVWA lit aussi le secret, et un secret TOTP appartient à un seul compte, alors qu'un composant en sert beaucoup. En production, gardez chaque secret avec son compte, et vérifiez en labo si votre version accepte un paramètre de compte dans la commande MFA ; sinon, une DLL PreConnect (plus bas) peut fournir le secret. Les notifications push et les jetons matériels exigent une personne : on ne peut pas les automatiser ainsi.
Les écrans qui n'apparaissent que parfois
Un message « session déjà ouverte », un bandeau de cookies, une page d'expiration du mot de passe : ces écrans font échouer un script figé. Les blocs conditionnels les prennent en charge.
username > {username} (SearchBy=Id)
password > {password} (SearchBy=Id)
login > (Button) (SearchBy=Id)
if ((resume-session > (Condition) (SearchBy=Id) (Exists eq true)))
resume-session > (Button) (SearchBy=Id)
end-if
dashboard > (Validation) (SearchBy=Id)
Chaque condition est entre ses propres parenthèses, et les conditions s'enchaînent avec and ou or. Exists teste la présence d'un élément, Count compare le nombre d'éléments trouvés (eq, ne, gt, ge, lt, le), et Placeholder compare une valeur du compte ou de PreConnect, ce qui permet d'envoyer certains comptes sur un autre chemin. Les blocs else-if et else suivent un end-if, et chaque bloc a sa commande de fermeture.
Authentification basique
Depuis PSM 14.0, le framework sait aussi répondre à l'invite d'authentification Basic ou Digest du navigateur, avec les identifiants placés dans l'adresse par des paramètres du compte (domain\username:password@URL). Deux limites comptent : PSM ne sait pas si l'authentification a réussi, donc ajoutez une ligne de validation ou d'échec, et une syntaxe fausse peut écrire des données sensibles dans les journaux. Sur un PSM durci, la stratégie du navigateur doit aussi autoriser les schémas basic et digest avant de relancer le durcissement.
Les valeurs calculées avant la connexion
Quand la connexion a besoin d'une valeur que le coffre ne contient pas telle quelle (un utilisateur temporaire, un jeton, une valeur dérivée de l'identifiant), le framework peut d'abord appeler votre propre DLL .NET. Elle implémente l'interface IPreconnectContract de CyberArk.PSM.WebAppDispatcher.PreconnectUtils.dll, livrée avec PSM. On la déclare dans les réglages propres au client du composant (PreConnectDllName, PreConnectParameters), et on utilise ce qu'elle renvoie sous la forme &nom& dans les WebFormFields. Levez une PreconnectException en cas d'erreur, pour que l'utilisateur voie votre message plutôt qu'une erreur générique.
Quand ça échoue
Commencez par les captures. EnableAdvancedDebugging, un paramètre de plateforme, fait enregistrer au dispatcher une image à chaque étape des WebFormFields, ce qui montre exactement où la connexion s'arrête. Supprimez le dossier des captures une fois le diagnostic terminé : les images comme les noms de fichiers peuvent contenir des données sensibles.
| Symptôme | Cause et correction |
|---|---|
| « Element not found » dès la première ligne | Un identifiant faux, un formulaire dans un cadre, ou une page encore en chargement.Inspectez la page dans le navigateur du serveur PSM lui-même, ajoutez (iFrame) ou augmentez PageLoadTimeout. |
| Fonctionnait hier, échoue aujourd'hui pour tous les comptes | Le navigateur s'est mis à jour, pas le pilote.Installez le pilote exactement à la version du navigateur, ou déployez l'outil WebDriverUpdater. |
| Le navigateur ne démarre plus du tout | AppLocker ne reconnaît plus le navigateur mis à jour.La règle du navigateur dans PSMConfigureAppLocker.xml est une règle d'empreinte (Method="Hash") : relancez PSMConfigureAppLocker.ps1 après chaque mise à jour du navigateur. |
| Une page d'avertissement au lieu de la page de connexion, sur une console en HTTP | Le mode HTTPS-First, actif par défaut en navigation privée depuis Chromium 127.Passez la console en HTTPS ; à défaut, testez et ajustez la stratégie du navigateur sur PSM. |
| Une erreur de certificat sur une console interne | Un certificat autosigné ou une autorité de certification privée.Faites approuver l'autorité interne par le serveur PSM ; ne passez EnforceCertificateValidation à No qu'en dernier recours. |
| La connexion réussit, la validation échoue | L'élément diffère selon la page d'arrivée, ou une ligne Navigate suit directement les lignes de validation.Validez sur un élément présent sur toutes les pages qui suivent la connexion ; séparez un Navigate suivant par une autre commande, comme (Wait=1). |
| Un connecteur casse après le passage au dispatcher 64 bits | Les composants du Marketplace restent dans les dossiers 32 bits.Copiez-les dans Components\x64\Connectors, ou ramenez ClientDispatcher sur {PSMComponentsFolder32}. |
| Fonctionne pour un compte, pas pour un autre | Des écrans propres au compte : consentement, expiration du mot de passe, enrôlement MFA.Ajoutez des blocs if/else, ou une condition Placeholder. |
Sécurité : qu'un connecteur n'affaiblisse jamais PSM
- Durcir d'abord, développer ensuite : lancez le durcissement avec la prise en charge du web plutôt que d'assouplir les stratégies du navigateur à la main, et n'autorisez que le navigateur que vous utilisez.
- HTTPS et contrôle des certificats : l'éditeur prend en charge HTTP, et l'authentification basique sur HTTP, mais les déconseille tous deux. Gardez EnforceCertificateValidation sur Yes.
- Aucun secret dans le composant : les mots de passe viennent des paramètres du compte, et les secrets MFA restent avec leurs comptes.
- Nettoyer après le débogage : supprimez les captures et désactivez EnableAdvancedDebugging.
- Un composant par application : plus simple à relire, à tester et à retirer qu'un composant étiré sur plusieurs consoles à coups de blocs if/else.
Faire durer le connecteur
Un connecteur web est terminé le jour où il fonctionne, et commence à vieillir le lendemain matin. Quatre habitudes le font durer.
- Mettre à jour ensemble le navigateur, le pilote et AppLockerLe pilote doit avoir exactement la version du navigateur. L'outil WebDriverUpdater du Marketplace contrôle les deux toutes les heures et télécharge le pilote correspondant chez Google ou Microsoft ; si vous préférez des fenêtres de changement, faites les trois en une fois.
- Garder le framework à jourLes navigateurs évoluent sous lui : après les pilotes 133, il fallait le framework 14.6.0.244 ou ultérieur pour continuer à fonctionner correctement.
- Retester après chaque changement, d'un côté comme de l'autreUne montée de version PSM, une mise à jour de la console, un nouvel écran de connexion. Gardez un compte de test par connecteur et une courte liste de tests : connexion, message d'échec, validation, enregistrement.
- Choisir des identifiants stablesLes id d'abord, puis les name. Les classes générées par les frameworks front-end et les longues expressions XPath cassent à la première refonte.
Si vous héritez d'anciens connecteurs bâtis sur le WebFormDispatcher, convertissez-les : faites pointer ClientDispatcher vers CyberArk.PSM.WebAppDispatcher.exe et réglez ClientApp sur le navigateur. Retestez chacun ensuite.
Privilege Cloud
Avec Privilege Cloud, PSM tourne sur les serveurs de connecteurs installés dans votre réseau : tout ce qui précède s'y applique, du framework à l'entretien, en passant par le navigateur, le pilote et le durcissement. La documentation de Privilege Cloud a sa propre version de la procédure. Ces serveurs de connecteurs suivent aussi leur propre calendrier de support : voir notre tableau de fin de support.
Comment nous pouvons aider
Nous développons des connecteurs web pour les consoles que le Marketplace ne couvre pas (portails d'éditeurs, interfaces d'équipements, outils internes), nous les testons sur votre version de PSM, et nous vous remettons le composant, la liste de tests et la documentation. Nous pouvons aussi revoir les connecteurs que vous exploitez déjà avant une montée de version.
Plus de détails sur ce service : connecteurs PSM et plugins CPM.
Sources
- Documentation Idira (CyberArk), PSM web application connection components (prérequis, navigateurs, WebFormFields, conditions, MFA, authentification basique, débogage ; en anglais).
- Documentation Idira (CyberArk), Configure PSM to connect to Web applications (durcissement, AppLocker, WebDriverUpdater ; en anglais).
- Documentation Idira (CyberArk), Configure PreConnect custom code (en anglais).
- Documentation Idira (CyberArk), Web applications for PSM, Privilege Cloud (en anglais).
- Sauce Labs, the-internet, site d'entraînement open source (pages de connexion et d'espace sécurisé utilisées dans l'exemple).
Vérifié sur PAM Self-Hosted 15.2 le 15 novembre 2026. Les menus et les noms de paramètres peuvent différer dans les versions plus anciennes ; les pages officielles font foi.
Questions
Les connecteurs web PSM en bref
Un connecteur web PSM gère-t-il la MFA ?
Oui, pour les codes TOTP : le framework calcule le code à partir du secret de l'appareil et le saisit dans la page. Les notifications push et les jetons matériels exigent une personne et ne s'automatisent pas ; demandez au responsable de l'application si une option TOTP existe.
Pourquoi mon connecteur web ne fonctionne-t-il plus après une mise à jour du navigateur ?
Presque toujours parce que le pilote ne correspond plus à la version du navigateur. Installez le chromedriver ou le msedgedriver correspondant, ou déployez l'outil WebDriverUpdater. Si le navigateur ne démarre plus du tout, relancez le script AppLocker : sa règle pour le navigateur est une règle d'empreinte.
Faut-il utiliser Chrome ou Edge sur PSM ?
Les deux sont pris en charge : Chrome 100 ou ultérieur et Edge 103 ou ultérieur, en 32 ou 64 bits, sans le mode IE d'Edge. Choisissez celui que vos serveurs PSM entretiennent déjà ; Chrome est la valeur par défaut.
Le même connecteur fonctionne-t-il avec Privilege Cloud ?
Oui. PSM tourne sur vos serveurs de connecteurs, avec les mêmes exigences de framework, de navigateur et de pilote.
Les utilisateurs peuvent-ils voir le mot de passe ?
Non. Le pilote le saisit dans la page, sur le serveur PSM, avant que l'utilisateur reprenne la fenêtre, et par défaut le navigateur reste même réduit pendant la connexion. Le mot de passe n'atteint jamais le poste de travail.
● Prochaine étape
Parlez-nous de votre bastionVersion, volumétrie, échéance. Nous vous dirons tout de suite si nous sommes les bonnes personnes pour le faire.