Si votre application utilise des liens magiques ou une connexion par e-mail au lieu de mots de passe traditionnels, Fern peut automatiser le processus d’authentification à l’aide d’une adresse e-mail générée. Fern attend les e-mails de vérification et termine automatiquement le processus de connexion.
Fonctionnement de l’authentification par e-mail
Lorsque vous connectez un tableau de bord qui nécessite une vérification par e-mail :
Activez Créer un e-mail de connexion Fern pour que 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 en extrait le lien ou le code de connexion
Fern termine l’authentification et capture 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 tels que Google ou GitHub.
Accédez à Intégrations dans votre tableau de bord Ferndesk
Repérez la carte Tableau de bord et cliquez sur Connecter
Saisissez votre Nom et votre URL
Dans Étapes de connexion, décrivez le processus de connexion par e-mail (voir l’exemple ci-dessous)
Cliquez sur Connecter pour créer la connexion
Activez Créer un e-mail de connexion Fern pour que Ferndesk génère automatiquement une adresse e-mail unique pour cette connexion
Exemple d’instructions de connexion pour les liens magiques
Indiquez précisément les libellés des boutons et les étapes de navigation. Fern a besoin d’instructions exactes pour terminer le processus.
Consulter l’historique des e-mails
Si le processus d’authentification est bloqué ou échoue, vous pouvez consulter les e-mails récents reçus par Ferndesk :
Accédez à Intégrations et repérez la carte Tableau de bord
Cliquez sur Gérer
Cliquez sur le bouton Parcourir les e-mails reçus de votre connexion
La page E-mails de connexion reçus affiche :
L’objet et l’expéditeur de chaque e-mail
La date et l’heure auxquelles Ferndesk l’a reçu
Le contenu complet de l’e-mail (lorsqu’il est disponible)
Si le message « Aucun contenu disponible » s’affiche pour un e-mail, Ferndesk a reçu le message, mais n’a pas pu en extraire le contenu. Vérifiez le format des e-mails de votre application ou contactez le support.
Dépannage
Si l’e-mail contenant le lien magique n’est pas arrivé :
Consultez 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 uniquement aux utilisateurs inscrits
Patientez quelques minutes, puis réessayez : certaines applications ont des délais d’envoi des e-mails
La plupart des liens magiques expirent au bout de 15 minutes. Si l’automatisation de Fern prend plus de temps que la durée de validité :
Vérifiez si votre application permet de prolonger la durée de validité
Envisagez d’utiliser un environnement de préproduction avec des paramètres de sécurité moins stricts
Utilisez plutôt un compte de contournement avec une 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 une authentification par nom d’utilisateur et mot de passe
Configurez un environnement de préproduction avec une authentification simplifiée
Capturez les captures d’écran manuellement et joignez-les aux articles
Utiliser un compte de contournement
Si l’authentification par e-mail ne fonctionne pas dans votre configuration, créez un compte de démonstration ou de préproduction dédié qui contourne l’authentification par lien magique :
Environnement de développement/préproduction avec une authentification par nom d’utilisateur et mot de passe
Compte de test avec une option de mot de passe de secours
Mode démo ne nécessitant aucune authentification
Suivez la configuration standard décrite dans Automatiser les captures d’écran dans votre documentation 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 doivent jamais donner accès à l’administration d’un environnement de production.
Articles associés