SureSMS

  1. Hem
  2. /
  3. Integrationer
  4. /
  5. SMS-integration för LDAP...
  6. /
  7. SMS-integration för Entra...

Innehållsförteckning
    Lägg till en rubrik för att börja generera innehållsförteckningen

    SMS-integration Entra ID via CSV-fil

    Azure AD

    Vad är Entra ID, även känt som Active Directory?

    Microsoft Entra ID, tidigare känt som Azure Active Directory (Azure AD), är en molnbaserad tjänst för identitets- och åtkomsthantering från Microsoft. Denna tjänst hjälper organisationer att hantera och säkra användaråtkomst till applikationer och data över en modern hybrid IT-infrastruktur. Genom att använda Microsoft Entra ID kan organisationer erbjuda single sign-on (SSO) och multifaktorautentisering för att skydda användaridentiteter och förbättra säkerheten. Integrationen med Microsoft Entra ID och Active Directory (AD) gör det möjligt att synkronisera och hantera identiteter centralt, vilket förenklar användarhantering och åtkomstkontroll. Detta är viktigt för organisationer som vill ha en effektiv och säker åtkomsthantering.

    Var uppmärksam på ....

    Det finns några saker som du bör känna till innan du börjar skapa en SMS AD-integration med SureSMS.

    GDPR

    Det första du måste vara medveten om är att SureSMS får tillgång till personuppgifter från dig. Detta innebär att vi nu börjar behandla uppgifter åt dig och därmed måste vi, iuppfylla kraven i GDPRhar ett personuppgiftsbiträdesavtal.

    Telefonnummer

    De telefonnummer som vi behöver skicka till måste finnas i din AD. För att vi ska kunna skicka SMS till en person måste vi känna till deras telefonnummer. Om du inte har telefonnummer i din AD måste du därför antingen skaffa det eller inte göra en integration.

    Radering av kontakter

    Integrationen är en "enkelriktad" integration. Det innebär att vi bara läser av information från AD. Integrationen tar så att säga alla personer från ditt AD. Så om du till exempel tar bort en person i SureSMS kommer den bara tillbaka om den fortfarande finns i AD. Det är alltid AD som har rätt data.

    Så här ställer du in din Entra ID-integration

    Vi har flera alternativ när det gäller integration med EntraID. I denna artikel beskrivs hur integrationen görs via en CSV-fil.

    I allmänhet bygger lösningen på ett litet skript som körs i era lokaler (dvs. inom de säkerhetsmekanismer som er organisation har etablerat). Skriptet skapar en kommaseparerad fil med innehåll om personer, telefonnummer och grupper, och denna fil skickas säkert via sFTP till SureSMS. SureSMS laddar sedan automatiskt filen till det konto som är kopplat till integrationerna.

    Så, låt oss komma igång.

    Så här fungerar det

    Processen är uppbyggd kring ett PowerShell-skript som utför följande uppgifter:

    1.Säker anslutning till Microsoft Entra ID med hjälp av Microsoft Graph API.
    2.Få medlemmar från en eller flera angivna användargrupper.
    3.Extraherar relevanta data (Namn, landskod, telefonnummer) och namnet på den grupp de tillhör.
    4.Formatering av data i en CSV-fil som är kompatibel med SureSMS-plattformen.
    5.Laddar automatiskt upp CSV-filen till SureSMS sFTP-server (sftp.suresms.com).

    När filen har laddats upp importeras den automatiskt till kontakterna i din adressbok i SureSMS.

    Format för CSV-filen

    Skriptet genererar en CSV-fil med semikolon som avgränsare, vilket är standard i Danmark. Filen innehåller följande kolumner:
    Kolumn
    Beskrivning
    Exempel på ett exempel
    Namn
    Användarens fullständiga namn från Entra ID
    Anders Jensen
    Landskod
    		 Uppringningskod med + prefix
    +45
    Telefonnummer
    Mobilnummer eller arbetstelefon
    12345678
    Grupp
    Namnet på den Entra ID-grupp som användaren tillhör
    IT-avdelningen
    Ett exempel på filinnehåll kan se ut så här:
    "Anders Jensen";"+45";"12345678";"IT-Afdeling"
    "Maria Nielsen";"+45";"87654321";"IT-Afdeling"
    "Peter Hansen";"+45";"11223344";"Försäljning"
    "Johan Svensson";"+46";"701234567";"Salg"

    Observera att skriptet automatiskt konverterar ISO-landskoder (t.ex. DK, SE, NO) till rätt uppringningsformat (+45, +46, +47) och tar bort eventuella landskodsprefix från telefonnumren.

    Förkunskapskrav

    Innan du kan använda skriptet måste du se till att ditt system uppfyller följande krav:

    • Windows PowerShell 5.1 eller senare (ingår i Windows 10 och 11).
    • Nödvändiga PowerShell-moduler: Skriptet försöker automatiskt att installera Graf och Posh-SSH, om de inte redan är installerade. Detta kräver administratörsrättigheter första gången.
    • Behörigheter i Entra ID: Den användare som kör skriptet måste ha behörighet att läsa användar- och gruppinformation via Microsoft Graph. Första gången skriptet körs kommer du att bli ombedd att godkänna dessa behörigheter.
    • sFTP-åtkomst till SureSMS: Du behöver ett användarnamn och lösenord för SureSMS sFTP-server.

    Steg-för-steg-guide

    Följ dessa steg för att konfigurera och köra skriptet.

    Steg 1: Ladda ner skriptet

    Först måste du ladda ner PowerShell-skriptet. Spara filen Export-EntraIDUsersToSFTP.ps1 på en lämplig plats på din dator, till exempel i C:\Skript

    Steg 2: Hitta dina sFTP-uppgifter i SureSMS

    För att skriptet ska kunna ladda upp filen behöver det dina personliga sFTP-inloggningsuppgifter från SureSMS. Skriptet är redan konfigurerat för att ansluta till sftp.suresms.com, så du behöver bara ditt användarnamn och lösenord.

    Du kan få din sFTP-information genom att skicka ett e-postmeddelande till [email protected] med ditt användarnummer och den registrerade e-postadressen (se längst ner till vänster när du är inloggad på app.suresms.com)

    Steg 3: Kör skriptet

    Öppna ett PowerShell-fönster och navigera till den mapp där du sparade skriptet. Du kan nu köra skriptet med de nödvändiga parametrarna.

    Nedan följer ett exempel på hur du kör skriptet. Byt ut värdena mot din egen information.

    .\Export-EntraIDUsersToSFTP.ps1 -Groups "Alla anställda", "IT-support" ` -SFTPUsername "ditsftp-användarnamn"

    När du kör kommandot:

    • Du kommer först att bli ombedd att logga in på ditt Microsoft-konto för att ge skriptet tillgång till Entra ID.
    • Du kommer sedan att bli ombedd att ange ditt sFTP-lösenord.

    Skriptet kommer nu att hämta data, skapa en CSV-fil med namnet EntraID_Export.csv och ladda upp den till SureSMS sFTP-server.

     

    Parametrar för skriptet

    Här följer en översikt över de parametrar som du kan använda för att anpassa skriptets funktion:

     

    Parameter Beskrivning
    -Grupper (Obligatorisk) En lista med de gruppnamn från Entra ID som du vill exportera. Separera med kommatecken, t.ex. "Grupp1", "Grupp2".
    -SFTPUanvändarnamn (Obligatoriskt) Ditt sFTP-användarnamn från SureSMS.
    -SFTPPassword (Valfritt) Lösenord som SecureString. Om det inte anges kommer du att uppmanas att ange det.
    -SFTPPort (Valfritt) sFTP-port. Standard är 22.
    -SFTPRemoteSökväg Den mapp på sFTP-servern där filen ska laddas upp. Standardvärdet är /.
    -Utmatningssökväg (Valfritt) Ändrar namn eller plats för den lokala CSV-filen. Standard är .\EntraID_Export.csv.
    -SkipSFTPUpload (Valfritt) Om detta anges genereras endast CSV-filen lokalt utan att laddas upp till sFTP.

    Exempel på användning

    Exempel 1: Exportera en grupp och ladda upp till SureSMS

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

    Exempel 2: Exportera flera grupper till en specifik mapp

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

    Exempel 3: Endast lokal export utan sFTP-uppladdning

    .\Export-EntraIDUsersToSFTP.ps1 -Groups "Alla anställda" ` -OutputPath "C:\Export\Employees.csv" ` -SkipSFTPUpload

    Automatisering med Windows Task Scheduler

    För att hålla dina kontaktlistor synkroniserade kan du ställa in en schemalagd uppgift i Windows som kör skriptet automatiskt med jämna mellanrum. Detta säkerställer att nya anställda eller ändringar i telefonnummer automatiskt återspeglas i dina SureSMS-mottagarlistor utan något manuellt arbete.

    Så här skapar du en schemalagd uppgift:

    • Öppna Task Scheduler i Windows.
    • Klicka på Skapa grundläggande uppgift.
    • Ge uppgiften ett namn, t.ex. "SureSMS Contact Sync".
    • Välj hur ofta uppgiften ska köras (t.ex. dagligen).
    • Välj Starta ett program som åtgärd.
    • Specificera exe som applikation och lägg till hela sökvägen till skriptet med parametrar som argument.

    Exempel på argument:

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

    Obs: För automatiserad körning måste du lagra lösenordet på ett säkert sätt. Du kan använda -SFTPPassword med en SecureString som lagras i en krypterad fil eller kör skriptet under ett servicekonto med lagrade autentiseringsuppgifter.