SureSMS

  1. Zuhause
  2. /
  3. Integrationen
  4. /
  5. SMS-Integration in LDAP...
  6. /
  7. SMS-Integration für Entra...

Inhaltsübersicht
    Füge eine Überschrift hinzu, um mit der Erstellung des Inhaltsverzeichnisses zu beginnen

    SMS-Integration Entra ID über CSV-Datei

    Azure AD

    Was ist Entra ID, auch bekannt als Active Directory?

    Microsoft Entra ID, früher bekannt als Azure Active Directory (Azure AD), ist ein Cloud-basierter Identitäts- und Zugangsverwaltungsdienst von Microsoft. Dieser Dienst unterstützt Unternehmen bei der Verwaltung und Sicherung des Nutzerzugangs zu Anwendungen und Daten in einer modernen hybriden IT-Infrastruktur. Durch die Nutzung von Microsoft Entra ID können Unternehmen Single Sign-On (SSO) und Multi-Faktor-Authentifizierung anbieten, um Nutzeridentitäten zu schützen und die Sicherheit zu verbessern. Die Integration mit Microsoft Entra ID und deinem Active Directory (AD) ermöglicht es, Identitäten zentral zu synchronisieren und zu verwalten, was die Benutzerverwaltung und Zugriffskontrolle vereinfacht. Dies ist wichtig für Organisationen, die eine effiziente und sichere Zugangsverwaltung wünschen.

    Achte auf ....

    Es gibt ein paar Dinge, die du wissen solltest, bevor du eine SMS AD-Integration mit SureSMS erstellst.

    GDPR

    Das erste, was Sie wissen müssen, ist, dass SureSMS Zugang zu Ihren persönlichen Daten erhält. Das bedeutet, dass wir nun beginnen, Daten für Sie zu verarbeiten, und daher müssen wir indie GDPR einhalteneine Vereinbarung zur Datenverarbeitung haben.

    Telefonnummern

    Die Telefonnummern, an die wir senden müssen, müssen in deiner AD stehen. Damit wir SMS an eine Person senden können, müssen wir ihre Telefonnummer kennen. Wenn du also keine Telefonnummern in deiner AD hast, solltest du sie entweder besorgen oder keine Integration vornehmen.

    Löschen von Kontakten

    Die Integration ist eine "einseitige" Integration. Das bedeutet, dass wir nur Informationen aus dem AD lesen. Die Integration nimmt sozusagen alle Personen aus Ihrem AD. Wenn Sie also z. B. eine Person in SureSMS löschen, wird sie nur dann wieder angezeigt, wenn sie noch im AD vorhanden ist. Es ist immer das AD, das die richtigen Daten hat.

    So richten Sie Ihre Entra ID-Integration ein

    Für die Integration von EntraID haben wir mehrere Möglichkeiten. Dieser Artikel beschreibt, wie die Integration über eine CSV-Datei erfolgt.

    Im Allgemeinen basiert die Lösung auf einem kleinen Skript, das in Ihren Räumlichkeiten ausgeführt wird (d. h. innerhalb der Sicherheitsmechanismen, die Ihre Organisation eingerichtet hat). Das Skript erstellt eine kommagetrennte Datei mit Inhalten über Personen, Telefonnummern und Gruppen, und diese Datei wird sicher über sFTP an SureSMS gesendet. SureSMS lädt die Datei dann automatisch in das mit den Integrationen verbundene Konto.

    Also, fangen wir an.

    Wie es funktioniert

    Der Prozess basiert auf einem PowerShell-Skript, das die folgenden Aufgaben ausführt:

    1.Sichere Verbindung zu Microsoft Entra ID unter Verwendung der Microsoft Graph API.
    2.Mitglieder gewinnen aus einer oder mehreren angegebenen Benutzergruppen.
    3.Extrahiert relevante Daten (Name, Landesvorwahl, Telefonnummer) und den Namen der Gruppe, der sie angehören.
    4.Daten formatieren in einer CSV-Datei, die mit der SureSMS-Plattform kompatibel ist.
    5.Automatisches Hochladen der CSV-Datei zum SureSMS sFTP-Server (sftp.suresms.com).

    Sobald die Datei hochgeladen ist, wird sie automatisch in die Kontakte Ihres Adressbuchs in SureSMS importiert.

    Format der CSV-Datei

    Das Skript erzeugt eine CSV-Datei mit einem Semikolon als Trennzeichen, wie es in Dänemark üblich ist. Die Datei enthält die folgenden Spalten:
    Säule
    Beschreibung
    Beispiel für ein Beispiel
    Name
    Vollständiger Name des Benutzers aus Entra ID
    Anders Jensen
    Ländercode
    		 Vorwahl mit + Vorwahl
    +45
    Rufnummer
    Handynummer oder Arbeitstelefon
    12345678
    Gruppe
    Der Name der Entra ID Gruppe, zu der der Benutzer gehört
    IT-Abteilung
    Ein Beispiel für den Inhalt der Datei könnte folgendermaßen aussehen:
    "Anders Jensen";"+45";"12345678";"IT-Afdeling"
    "Maria Nielsen";"+45";"87654321";"IT-Afdeling"
    "Peter Hansen";"+45";"11223344";"Verkauf"
    "Johan Svensson";"+46";"701234567";"Salg"

    Beachten Sie, dass das Skript die ISO-Ländercodes (z. B. DK, SE, NO) automatisch in das richtige Wählformat (+45, +46, +47) umwandelt und alle Ländervorwahlen aus den Telefonnummern entfernt.

    Voraussetzungen

    Bevor Sie das Skript verwenden können, müssen Sie sicherstellen, dass Ihr System die folgenden Anforderungen erfüllt:

    • Windows PowerShell 5.1 oder höher (in Windows 10 und 11 enthalten).
    • Erforderliche PowerShell-Module: Das Skript wird automatisch versuchen, folgende Module zu installieren Grafik und Posh-SSH, wenn sie nicht bereits installiert sind. Dies erfordert beim ersten Mal Administratorrechte.
    • Berechtigungen in Entra ID: Der Benutzer, der das Skript ausführt, muss die Berechtigung haben, Benutzer- und Gruppeninformationen über Microsoft Graph zu lesen. Wenn das Skript zum ersten Mal ausgeführt wird, werden Sie aufgefordert, diesen Berechtigungen zuzustimmen.
    • sFTP-Zugang zu SureSMS: Sie benötigen einen Benutzernamen und ein Passwort für den SureSMS sFTP-Server.

    Schritt-für-Schritt-Anleitung

    Folgen Sie diesen Schritten, um das Skript zu konfigurieren und auszuführen.

    Schritt 1: Laden Sie das Skript herunter

    Zunächst müssen Sie Folgendes herunterladen Das PowerShell-Skript. Speichern Sie die Datei Export-EntraIDUsersToSFTP.ps1 an einem geeigneten Ort auf Ihrem Computer, zum Beispiel in C:\Scripts

    Schritt 2: Finden Sie Ihre sFTP-Details in SureSMS

    Damit das Skript die Datei hochladen kann, benötigt es Ihre persönlichen sFTP-Anmeldedaten von SureSMS. Das Skript ist bereits so konfiguriert, dass es sich mit sftp.suresms.com, Sie brauchen also nur Ihren Benutzernamen und Ihr Passwort.

    Sie können Ihre sFTP-Informationen erhalten, indem Sie eine E-Mail an [email protected] mit Ihrer Benutzernummer und der registrierten E-Mail-Adresse senden (siehe unten links, wenn Sie auf app.suresms.com eingeloggt sind)

    Schritt 3: Führen Sie das Skript aus

    Öffnen Sie ein PowerShell-Fenster und navigieren Sie zu dem Ordner, in dem Sie das Skript gespeichert haben. Sie können das Skript nun mit den erforderlichen Parametern ausführen.

    Im Folgenden finden Sie ein Beispiel für die Ausführung des Skripts. Ersetzen Sie die Werte durch Ihre eigenen Informationen.

    .\Export-EntraIDUsersToSFTP.ps1 -Gruppen "Alle Mitarbeiter", "IT-Support" ` -SFTPUsername "ditsftp-username"

    Wenn Sie den Befehl ausführen:

    • Sie werden zunächst aufgefordert, sich bei Ihrem Microsoft-Konto anzumelden, um dem Skript Zugriff auf Entra ID zu geben.
    • Sie werden dann aufgefordert, Ihr sFTP-Passwort einzugeben.

    Das Skript ruft nun die Daten ab und erstellt eine CSV-Datei mit dem Namen EntraID_Export.csv und laden Sie sie auf den SureSMS sFTP-Server hoch.

     

    Parameter des Skripts

    Hier finden Sie eine Übersicht über die Parameter, mit denen Sie die Funktion des Skripts anpassen können:

     

    Parameter Beschreibung
    -Gruppen (Erforderlich) Eine Liste der Gruppennamen aus Entra ID, die Sie exportieren möchten. Trennen Sie diese mit Kommas, z.B. "Gruppe1", "Gruppe2".
    -SFTPUsername (Erforderlich) Ihr sFTP-Benutzername von SureSMS.
    -SFTPPasswort (Optional) Passwort als SecureString. Wird es nicht angegeben, werden Sie aufgefordert, es einzugeben.
    -SFTPPort (Optional) sFTP-Port. Standard ist 22.
    -SFTPRemotePath Der Ordner auf dem sFTP-Server, in den die Datei hochgeladen werden soll. Der Standard ist /.
    -OutputPath (Optional) Ändert den Namen oder den Speicherort der lokalen CSV-Datei. Standard ist .\EntraID_Export.csv.
    -SkipSFTPUpload (Optional) Wenn diese Option angegeben wird, wird nur die CSV-Datei lokal erzeugt und nicht auf sFTP hochgeladen.

    Beispiele für die Verwendung

    Beispiel 1: Eine Gruppe exportieren und zu SureSMS hochladen

    .\Export-EntraIDUsersToSFTP.ps1 -Groups "Sales" -SFTPUsername "myuser"

    Beispiel 2: Mehrere Gruppen in einen bestimmten Ordner exportieren

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

    Beispiel 3: Nur lokaler Export ohne sFTP-Upload

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

    Automatisierung mit dem Windows Taskplaner

    Um Ihre Kontaktlisten zu synchronisieren, können Sie einen geplanten Task in Windows einrichten, der das Skript automatisch in regelmäßigen Abständen ausführt. Auf diese Weise wird sichergestellt, dass neue Mitarbeiter oder geänderte Telefonnummern automatisch in Ihre SureSMS-Empfängerlisten übernommen werden, ohne dass manuelle Arbeiten erforderlich sind.

    So erstellen Sie eine geplante Aufgabe:

    • Öffnen Sie den Taskplaner in Windows.
    • Klicken Sie auf Grundaufgabe erstellen.
    • Geben Sie der Aufgabe einen Namen, z. B. "SureSMS Contact Sync".
    • Wählen Sie aus, wie oft die Aufgabe ausgeführt werden soll (z. B. täglich).
    • Wählen Sie als Aktion ein Programm starten.
    • Geben Sie an. exe als Anwendung und fügen Sie den vollständigen Pfad des Skripts mit Parametern als Argumente hinzu.

    Beispiel für ein Argument:

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

    Hinweis: Für das automatisierte Fahren müssen Sie das Passwort sicher speichern. Sie können verwenden -SFTPPasswort mit einer in einer verschlüsselten Datei gespeicherten SecureString oder führen Sie das Skript unter einem Dienstkonto mit gespeicherten Anmeldeinformationen aus.