Introduction
Cet article fournit un guide étape par étape pour activer l'authentification unique (SSO) pour le Tableau de bord Business. Vous aurez besoin de l'aide de votre service informatique interne pour finaliser cette configuration. Il fournit des instructions détaillées sur les sujets suivants :
Informations importantes
Configuration du SSO avec Google
Configuration du SSO avec Azure
Validation du nom de domaine
Important à savoir avant d'activer le SSO
Avant de configurer le SSO pour votre organisation, il est important de connaître certains comportements au niveau du système.
Le SSO s'applique au niveau du domaine de messagerie, et non par organisation
Lorsque le SSO est activé pour un domaine de messagerie (par ex. @votreentreprise.com), il s'applique à l'ensemble du système, sur tous les comptes Airthings. Tout utilisateur disposant de ce domaine de messagerie devra s'authentifier via le SSO.
Cela signifie que si un utilisateur dont le domaine est configuré pour le SSO est invité dans une deuxième organisation pour laquelle le SSO n'est pas activé, il sera tout de même invité à se connecter via le SSO. Il ne pourra pas créer de nom d'utilisateur et de mot de passe distincts pour ce compte.
Accéder à plusieurs organisations avec le SSO
Si un utilisateur a besoin d'accéder à plusieurs organisations Airthings et que son domaine de messagerie est configuré pour le SSO, la procédure recommandée est la suivante :
Invitez l'utilisateur dans l'organisation où le SSO est configuré.
L'utilisateur se connecte via le SSO. Cela crée son compte utilisateur dans le système Airthings.
Une fois connecté, l'utilisateur peut être invité dans d'autres organisations, y compris celles sans SSO.
L'utilisateur peut ensuite basculer entre les organisations depuis le Tableau de bord sans avoir à s'authentifier de nouveau.
Remarque : Un utilisateur dont le domaine de messagerie est configuré pour le SSO ne peut pas s'inscrire avec un nom d'utilisateur et un mot de passe sur un compte Airthings, même si cette organisation n'a pas configuré le SSO. Si un utilisateur a besoin d'un compte indépendant avec une autre méthode d'authentification, il doit utiliser une autre adresse e-mail.
Configuration du SSO avec Google
Pour configurer le SSO avec Google, procédez comme suit :
Créez un nouvel identifiant d'API OAuth2.0 dans Google.
Définissez l'origine sur : https://accounts.airthings.com/
Définissez l'URI de redirection sur : https://accounts.airthings.com/federated
Copiez l'ID client et le secret pour les utiliser dans le Tableau de bord Airthings.
Connectez-vous au Tableau de bord Airthings et accédez à : Paramètres du compte - Organisation - SSO
Activez le SSO et remplissez les champs suivants :
Sélectionnez Google comme fournisseur.
Saisissez le domaine de messagerie pour lequel vous souhaitez activer le SSO.
Saisissez l'ID client et le secret copiés lors de la configuration des identifiants d'API Google.
Enregistrez le formulaire et copiez l'enregistrement TXT.
Ajoutez l'enregistrement TXT chez votre fournisseur DNS pour le domaine de messagerie.
Une fois l'enregistrement TXT en place, vous pouvez vérifier la propriété du domaine depuis le formulaire de configuration SSO.
Après une vérification réussie, vous pouvez activer le SSO pour votre domaine en cliquant sur « Activer » dans le formulaire.
Invitez ensuite les utilisateurs (par e-mail) dans votre organisation sur le Tableau de bord Airthings.
Configuration du SSO avec Azure
Créez une nouvelle inscription d'application (App registration).
Définissez l'URI de redirection sur : https://accounts.airthings.com/federated
Créez un secret client. L'ID client et le secret seront utilisés dans le Tableau de bord Airthings.
Assurez-vous que le client est autorisé à lire les informations utilisateur (User Info) sous Autorisations d'API.
Connectez-vous au Tableau de bord Airthings et accédez à : Paramètres du compte - Organisation - SSO
Activez le SSO et remplissez les champs suivants :
Sélectionnez Microsoft comme fournisseur.
Saisissez votre ID de locataire (Tenant ID) Microsoft.
Saisissez le domaine de messagerie pour lequel vous souhaitez activer le SSO.
Saisissez l'ID client et le secret copiés lors de la configuration de l'inscription d'application Azure.
Enregistrez le formulaire et copiez l'enregistrement TXT.
Ajoutez l'enregistrement TXT chez votre fournisseur DNS pour le domaine de messagerie.
Une fois l'enregistrement TXT en place, vous pouvez vérifier la propriété du domaine depuis le formulaire de configuration SSO.
Après une vérification réussie, vous pouvez activer le SSO pour votre domaine en cliquant sur « Activer » dans le formulaire.
Après l'activation, les utilisateurs dont l'adresse e-mail correspond au domaine de messagerie vérifié pourront se connecter à Airthings via le SSO.
Invitez ensuite les utilisateurs (par e-mail) dans votre organisation sur le Tableau de bord Airthings.
Comment valider le nom de domaine
Pour utiliser l'authentification unique (SSO) avec le Tableau de bord Airthings, vous devez valider la propriété de votre domaine. Pour cela, vous devez ajouter un enregistrement TXT au domaine enregistré dans le Tableau de bord Airthings. Suivez les étapes ci-dessous pour valider le domaine. Si vous souhaitez utiliser plusieurs noms de domaine, ces étapes doivent être effectuées pour chaque nom de domaine séparément.
Connectez-vous à votre compte chez votre registraire de domaine ou votre fournisseur DNS.
Accédez à la section de gestion DNS. Recherchez une section intitulée « DNS » ou « Gestion DNS ». L'emplacement exact de cette section peut varier selon votre registraire de domaine ou votre fournisseur DNS.
Sélectionnez le domaine que vous souhaitez valider. Si vous avez plusieurs domaines, assurez-vous de choisir le bon domaine pour lequel vous souhaitez ajouter l'enregistrement TXT. Il doit correspondre au domaine saisi dans le champ « domaine de messagerie » de la configuration SSO.
Ajoutez un nouvel enregistrement TXT. Recherchez l'option permettant d'ajouter un nouvel enregistrement, généralement intitulée « Ajouter un enregistrement » ou « Ajouter un enregistrement DNS ». Dans le menu déroulant, sélectionnez « TXT » comme type d'enregistrement.
Saisissez les informations requises. Vous devrez renseigner le champ « Nom » ou « Hôte » et le champ « Valeur ». Le champ « Nom » doit contenir le nom de domaine à valider, et le champ « Valeur » doit contenir la valeur d'enregistrement TXT reçue du tableau de bord Airthings.
Enregistrez vos modifications. Une fois les informations requises saisies, cliquez sur le bouton « Enregistrer ». Veuillez noter que la propagation du nouvel enregistrement TXT dans le système DNS peut prendre de quelques minutes à quelques heures.
Vérifiez la validation du domaine dans le tableau de bord Airthings. Après avoir effectué les étapes ci-dessus, vous pouvez vérifier que la validation du domaine est terminée en consultant le tableau de bord Airthings. Dans la section de vérification du domaine, cliquez sur le bouton Vérifier à côté du domaine pour lequel vous avez ajouté l'enregistrement TXT.
Si la vérification réussit, le domaine sera marqué comme vérifié. Si elle échoue, vous pouvez utiliser un outil en ligne, tel que « DNS Checker » ou « MX Toolbox », pour vérifier l'enregistrement TXT de votre domaine afin de résoudre le problème.
