Si votre application utilise des liens magiques (magic links) ou une connexion par e-mail au lieu des mots de passe traditionnels, Fern peut automatiser le flux d'authentification à l'aide d'une adresse e-mail générée. Elle attendra les e-mails de vérification et terminera le processus de connexion automatiquement.
Lorsque vous connectez un tableau de bord qui nécessite une vérification par e-mail :
Ferndesk génère une adresse e-mail unique pour cette connexion
Fern accède à votre page de connexion et saisit cette adresse
Votre application envoie un e-mail de vérification à cette adresse
Ferndesk reçoit l'e-mail et extrait le lien ou le code de connexion
Fern termine l'authentification et effectue vos captures d'écran
Cette fonctionnalité fonctionne avec les liens magiques, les codes à usage unique et d'autres méthodes de vérification par e-mail. Elle ne prend pas en charge les fournisseurs OAuth tiers comme Google ou GitHub.
Allez dans Integrations sur votre tableau de bord Ferndesk
Trouvez la carte Dashboard et cliquez sur Connect
Saisissez votre Dashboard Name et votre Dashboard URL
Dans Login Instructions, décrivez le flux de connexion par e-mail (voir l'exemple ci-dessous)
Cliquez sur Connect pour créer la connexion
Ferndesk génère automatiquement une adresse e-mail unique pour cette connexion
1. Click "Sign In" in the top navigation
2. Click the "Email" tab
3. Enter the generated email address
4. Click "Send magic link"
5. Wait for the email to arrive (Ferndesk handles this automatically)Soyez précis concernant les libellés des boutons et les étapes de navigation. Fern a besoin d'instructions exactes pour mener à bien le flux.
Si le flux d'authentification stagne ou échoue, vous pouvez consulter les e-mails récents reçus par Ferndesk :
Allez dans Integrations et trouvez la carte Dashboard
Cliquez sur Manage connections
Cliquez sur le bouton View email history de votre connexion
Le panneau des e-mails récents affiche :
L'objet et l'expéditeur de chaque e-mail
L'horodatage de réception par Ferndesk
Le contenu complet de l'e-mail (lorsqu'il est disponible)
Si vous voyez « No content available » pour un e-mail, cela signifie que Ferndesk a reçu le message mais n'a pas pu en extraire le contenu. Vérifiez le format d'e-mail de votre application ou contactez le support.
Si l'e-mail du lien magique n'est pas arrivé :
Vérifiez l'historique des e-mails pour confirmer que Ferndesk n'a rien reçu
Vérifiez que votre application envoie des liens magiques à n'importe quelle adresse e-mail, et pas seulement aux utilisateurs enregistrés
Attendez quelques minutes et réessayez : certaines applications présentent des retards d'envoi d'e-mails
La plupart des liens magiques expirent après 15 minutes. Si l'automatisation de Fern prend plus de temps que la fenêtre d'expiration :
Vérifiez si votre application permet des délais d'expiration plus longs
Envisagez d'utiliser un environnement de test (staging) avec des paramètres de sécurité assouplis
Utilisez plutôt un compte de contournement avec authentification par mot de passe
Cette fonctionnalité gère uniquement la vérification par e-mail. Pour les applications utilisant Google, GitHub ou d'autres fournisseurs OAuth :
Créez un compte de contournement avec authentification par nom d'utilisateur/mot de passe
Configurez un environnement de test avec une authentification simplifiée
Effectuez les captures d'écran manuellement et joignez-les aux articles
Si l'authentification par e-mail ne fonctionne pas pour votre configuration, créez un compte de démonstration ou de test dédié qui contourne l'authentification par lien magique :
Environnement de développement/test avec authentification par nom d'utilisateur/mot de passe
Compte de test avec une option de mot de passe dérobé (backdoor)
Mode démo ne nécessitant pas d'authentification
Suivez la configuration standard dans Automate screenshots in your docs en utilisant les identifiants de votre compte de contournement.
Utilisez un compte de test dédié, et non un compte personnel. Les identifiants sont chiffrés, mais ne devraient jamais correspondre à un accès administrateur en production.
Automate screenshots in your docs - Configuration générale de l'intégration du tableau de bord
Dashboard integration - Gestion de la connexion