SureSMS

  1. Accueil
  2. /
  3. Intégrations
  4. /
  5. Intégration SMS pour LDAP...
  6. /
  7. Intégration des SMS pour Entra...

Table des matières
    Ajouter un en-tête pour commencer à générer la table des matières

    Intégration SMS Entra ID via fichier CSV

    Azure AD

    Qu'est-ce que Entra ID, également connu sous le nom d'Active Directory ?

    Microsoft Entra ID, anciennement connu sous le nom d'Azure Active Directory (Azure AD), est un service de gestion des identités et des accès basé sur le cloud de Microsoft. Ce service aide les organisations à gérer et à sécuriser l'accès des utilisateurs aux applications et aux données dans une infrastructure informatique hybride moderne. En utilisant Microsoft Entra ID, les organisations peuvent offrir une authentification unique (SSO) et une authentification multifactorielle pour protéger les identités des utilisateurs et améliorer la sécurité. L'intégration avec Microsoft Entra ID et votre Active Directory (AD) permet de synchroniser et de gérer les identités de manière centralisée, ce qui simplifie la gestion des utilisateurs et le contrôle d'accès. Ceci est essentiel pour les organisations qui souhaitent une gestion des accès efficace et sécurisée.

    Prêtez attention à ....

    Il y a quelques points que vous devez connaître avant de commencer à créer une intégration SMS AD avec SureSMS.

    GDPR

    La première chose dont vous devez être conscient est que SureSMS a accès à vos données personnelles. Cela signifie que nous commençons à traiter des données pour vous et que nous devons donc, en vertu de la loi sur la protection des données, respecter les règles suivantesse conformer au GDPRont conclu un accord sur le traitement des données.

    Numéros de téléphone

    Les numéros de téléphone auxquels nous devons envoyer des SMS doivent figurer dans votre AD. Pour pouvoir envoyer des SMS à une personne, nous devons connaître son numéro de téléphone. Par conséquent, si vous n'avez pas de numéros de téléphone dans votre base de données, soit vous en avez, soit vous ne faites pas d'intégration.

    Suppression de contacts

    L'intégration est "à sens unique". Cela signifie que nous ne lisons que les informations provenant de l'AD. L'intégration prend toutes les personnes de votre AD, pour ainsi dire. Ainsi, par exemple, si vous supprimez une personne dans SureSMS, elle ne réapparaîtra que si elle est encore dans AD. C'est toujours AD qui contient les données correctes.

    Comment configurer l'intégration d'Entra ID

    Nous avons plusieurs options lorsqu'il s'agit de l'intégration d'EntraID. Cet article décrit comment l'intégration se fait via un fichier CSV.

    En général, la solution repose sur un petit script qui s'exécute dans vos locaux (c'est-à-dire dans le cadre des mécanismes de sécurité mis en place par votre organisation). Le script crée un fichier séparé par des virgules contenant des informations sur les personnes, les numéros de téléphone et les groupes, et ce fichier est envoyé en toute sécurité via sFTP à SureSMS. SureSMS charge ensuite automatiquement le fichier dans le compte associé aux intégrations.

    Commençons donc.

    Comment cela fonctionne-t-il ?

    Le processus s'articule autour d'un script PowerShell qui exécute les tâches suivantes :

    1.Connexion sécurisée à Microsoft Entra ID à l'aide de l'API Microsoft Graph.
    2.Obtenir des membres d'un ou de plusieurs groupes d'utilisateurs spécifiés.
    3.Extraction des données pertinentes (Nom, code pays, numéro de téléphone) et le nom du groupe auquel ils appartiennent.
    4.Formatage des données dans un fichier CSV compatible avec la plateforme SureSMS.
    5.Téléchargement automatique du fichier CSV au serveur sFTP de SureSMS (sftp.suresms.com).

    Une fois le fichier téléchargé, il est automatiquement importé dans les contacts de votre carnet d'adresses dans SureSMS.

    Format du fichier CSV

    Le script génère un fichier CSV avec un point-virgule comme séparateur, ce qui est la norme au Danemark. Le fichier contient les colonnes suivantes :
    Colonne
    Description
    Exemple d'un exemple
    Nom
    Nom complet de l'utilisateur à partir d'Entra ID
    Anders Jensen
    Code pays
    Indicatif de numérotation avec préfixe +
    +45
    Numéro de téléphone
    Numéro de téléphone mobile ou professionnel
    12345678
    Groupe
    Le nom du groupe Entra ID auquel l'utilisateur appartient.
    Département informatique
    Un exemple de contenu de fichier pourrait ressembler à ceci :
    "Anders Jensen";"+45";"12345678";"IT-Afdeling"
    "Maria Nielsen";"+45";"87654321";"IT-Afdeling"
    "Peter Hansen";"+45";"11223344";"Ventes"
    "Johan Svensson";"+46";"701234567";"Salg"

    Notez que le script convertit automatiquement les codes de pays ISO (par exemple DK, SE, NO) au format de numérotation correct (+45, +46, +47) et supprime tout préfixe de code de pays des numéros de téléphone.

    Conditions préalables

    Avant d'utiliser le script, assurez-vous que votre système remplit les conditions suivantes :

    • Windows PowerShell 5.1 ou version ultérieure (inclus dans Windows 10 et 11).
    • Modules PowerShell requis : Le script tentera automatiquement d'installer les modules suivants Graphique et Posh-SSH, s'ils ne sont pas déjà installés. La première fois, il faut disposer des droits d'administrateur.
    • Permissions dans Entra ID : L'utilisateur qui exécute le script doit avoir la permission de lire les informations sur les utilisateurs et les groupes via Microsoft Graph. La première fois que le script est exécuté, il vous sera demandé de consentir à ces autorisations.
    • Accès sFTP à SureSMS : Vous avez besoin d'un nom d'utilisateur et d'un mot de passe pour le serveur sFTP de SureSMS.

    Guide étape par étape

    Suivez les étapes suivantes pour configurer et exécuter le script.

    Étape 1 : Télécharger le script

    Vous devez d'abord télécharger Le script PowerShell. Enregistrer le fichier Export-EntraIDUsersToSFTP.ps1 à un endroit approprié de votre ordinateur, par exemple dans la rubrique C:\NScripts

    Étape 2 : Trouver les détails de votre sFTP dans SureSMS

    Pour que le script puisse télécharger le fichier, il a besoin de vos données de connexion sFTP personnelles provenant de SureSMS. Le script est déjà configuré pour se connecter à sftp.suresms.com, Vous n'avez donc besoin que de votre nom d'utilisateur et de votre mot de passe.

    Vous pouvez obtenir vos informations sFTP en envoyant un e-mail à [email protected] avec votre numéro d'utilisateur et l'adresse e-mail enregistrée (voir en bas à gauche lorsque vous êtes connecté à app.suresms.com).

    Étape 3 : Exécuter le script

    Ouvrez une fenêtre PowerShell et naviguez jusqu'au dossier dans lequel vous avez enregistré le script. Vous pouvez maintenant exécuter le script avec les paramètres nécessaires.

    Vous trouverez ci-dessous un exemple d'exécution du script. Remplacez les valeurs par vos propres informations.

    .\NExport-EntraIDUsersToSFTP.ps1 -Groups "All Employees", "IT Support" ` -SFTPUsername "ditsftp-username"

    Lorsque vous exécutez la commande :

    • On vous demandera d'abord de vous connecter à votre compte Microsoft pour donner au script l'accès à Entra ID.
    • Il vous sera alors demandé de saisir votre mot de passe sFTP.

    Le script va maintenant récupérer les données, créer un fichier CSV nommé EntraID_Export.csv et le télécharger sur le serveur sFTP de SureSMS.

     

    Paramètres du script

    Voici un aperçu des paramètres que vous pouvez utiliser pour personnaliser la fonction du script :

     

    Paramètres Description
    -Groupes (Obligatoire) Une liste des noms de groupes d'Entra ID que vous souhaitez exporter. Séparez-les par des virgules, par exemple. "Groupe 1", "Groupe 2".
    -Nom d'utilisateur SFTP (Obligatoire) Votre nom d'utilisateur sFTP de SureSMS.
    -Mot de passe SFTP (Facultatif) Mot de passe sous forme de chaîne sécurisée. S'il n'est pas spécifié, vous serez invité à le saisir.
    -SFTPPort (Facultatif) Port sFTP. La valeur par défaut est 22.
    -Chemin d'accès à distance Le dossier sur le serveur sFTP où le fichier doit être téléchargé. Le dossier par défaut est /.
    -Chemin de sortie (Facultatif) Modifie le nom ou l'emplacement du fichier CSV local. La valeur par défaut est .\NEntraID_Export.csv.
    -SauterSFTPUpload (Facultatif) Si cette option est spécifiée, seul le fichier CSV est généré localement sans être téléchargé vers sFTP.

    Exemples d'utilisation

    Exemple 1 : Exportation d'un groupe et téléchargement vers SureSMS

    .\NExport-EntraIDUsersToSFTP.ps1 -Groups "Sales" -SFTPUsername "myuser" (mon utilisateur)"

    Exemple 2 : Exporter plusieurs groupes vers un dossier spécifique

    .\NExport-EntraIDUsersToSFTP.ps1 -Groups "IT", "HR", "Management" ` -SFTPUsername "myuser" ` -SFTPRemotePath "/contacts"

    Exemple 3 : Exportation locale uniquement sans téléchargement sFTP

    .\Export-EntraIDUsersToSFTP.ps1 -Groups "All Employees" ` -OutputPath "C:\Export\Employees.csv" ` -SkipSFTPUpload

    Automatisation avec le planificateur de tâches de Windows

    Pour maintenir la synchronisation de vos listes de contacts, vous pouvez configurer une tâche programmée dans Windows qui exécute le script automatiquement à intervalles réguliers. Ainsi, les nouveaux employés ou les changements de numéros de téléphone sont automatiquement répercutés dans vos listes de destinataires SureSMS, sans aucune intervention manuelle.

    Pour créer une tâche programmée :

    • Ouvrez le planificateur de tâches dans Windows.
    • Cliquez sur Créer une tâche de base.
    • Donnez un nom à la tâche, par exemple "SureSMS Contact Sync".
    • Sélectionnez la fréquence d'exécution de la tâche (par exemple, tous les jours).
    • Sélectionnez Démarrer un programme comme action.
    • Préciser exe en tant qu'application et ajoutez le chemin complet du script avec les paramètres en tant qu'arguments.

    Exemple d'argument :

    -ExecutionPolicy Bypass -File "C:\Scripts\Export-EntraIDUsersToSFTP.ps1" -Groups "All Employees" -SFTPUsername "myuser"

    Note : Pour la conduite automatisée, vous devez stocker le mot de passe en toute sécurité. Vous pouvez utiliser -Mot de passe SFTP avec une SecureString stockée dans un fichier crypté ou exécuter le script sous un compte de service avec des informations d'identification stockées.