- Hjem
- /
- Integrasjoner
- /
- SMS-integrasjon for LDAP...
- /
- SMS-integrasjon for Entra...
SMS-integrasjon Entra ID via CSV-fil
Hva er Entra ID, også kjent som Active Directory?
Microsoft Entra ID, tidligere kjent som Azure Active Directory (Azure AD), er en skybasert tjeneste for identitets- og tilgangsstyring fra Microsoft. Denne tjenesten hjelper organisasjoner med å administrere og sikre brukertilgang til applikasjoner og data på tvers av en moderne hybrid IT-infrastruktur. Ved å bruke Microsoft Entra ID kan organisasjoner tilby single sign-on (SSO) og multifaktorautentisering for å beskytte brukeridentiteter og forbedre sikkerheten. Integrasjonen med Microsoft Entra ID og Active Directory (AD) gjør det mulig å synkronisere og administrere identiteter sentralt, noe som forenkler brukeradministrasjon og tilgangskontroll. Dette er avgjørende for organisasjoner som ønsker effektiv og sikker tilgangsstyring.
Følg med på ....
Det er noen ting du bør være klar over før du begynner å lage en SMS AD-integrasjon med SureSMS.
GDPR
Det første du må være klar over, er at SureSMS får tilgang til personopplysninger fra deg. Dette betyr at vi nå begynner å behandle data for deg, og dermed må vi, ioverholde GDPRhar en databehandleravtale.
Telefonnumre
Telefonnumrene vi skal sende til, må finnes i AD-et ditt. For at vi skal kunne sende SMS til en person, må vi vite telefonnummeret deres. Hvis du ikke har telefonnumre i AD-et ditt, må du derfor enten skaffe det eller la være å gjøre en integrasjon.
Slette kontakter
Integrasjonen er en "enveis"-integrasjon. Det betyr at vi bare leser informasjon fra AD. Integrasjonen tar så å si alle personer fra AD. Hvis du for eksempel sletter en person i SureSMS, vil vedkommende bare komme tilbake hvis han eller hun fortsatt finnes i AD. Det er alltid AD som har de riktige dataene.
Slik konfigurerer du din Entra ID-integrasjon
Vi har flere alternativer når det gjelder EntraID-integrasjon. Denne artikkelen beskriver hvordan integrasjonen gjøres via en CSV-fil.
Løsningen er i hovedsak basert på et lite skript som kjøres hos dere (dvs. innenfor de sikkerhetsmekanismene organisasjonen har etablert). Skriptet oppretter en kommaseparert fil med innhold om personer, telefonnumre og grupper, og denne filen sendes sikkert via sFTP til SureSMS. SureSMS laster deretter automatisk inn filen i kontoen som er knyttet til integrasjonene.
Så, la oss komme i gang.
Slik fungerer det
Når filen er lastet opp, importeres den automatisk til kontaktene i adresseboken din i SureSMS.
Format for CSV-filen
|
Spalte
|
Beskrivelse
|
Eksempel på et eksempel
|
|
Navn
|
Brukerens fulle navn fra Entra ID
|
Anders Jensen
|
|
Landskode
|
Oppringningskode med + prefiks |
+45
|
|
Telefonnummer
|
Mobilnummer eller jobbtelefon
|
12345678
|
|
Gruppe
|
Navnet på Entra ID-gruppen som brukeren tilhører
|
IT-avdelingen
|
Forutsetninger
Før du kan bruke skriptet, må du sørge for at systemet ditt oppfyller følgende krav:
- Windows PowerShell 5.1 eller nyere (inkludert i Windows 10 og 11).
- Nødvendige PowerShell-moduler: Skriptet vil automatisk forsøke å installere Graf og Posh-SSH, hvis de ikke allerede er installert. Dette krever administratorrettigheter første gang.
- Tillatelser i Entra ID: Brukeren som kjører skriptet må ha tillatelse til å lese bruker- og gruppeinformasjon via Microsoft Graph. Første gang skriptet kjøres, vil du bli bedt om å godkjenne disse tillatelsene.
- sFTP-tilgang til SureSMS: Du må ha et brukernavn og passord for SureSMS' sFTP-server.
Steg-for-steg-veiledning
Følg disse trinnene for å konfigurere og kjøre skriptet.
Trinn 1: Last ned skriptet
Først må du laste ned PowerShell-skriptet. Lagre filen Eksporter-EntraIDUsersToSFTP.ps1 på et passende sted på datamaskinen din, for eksempel i C:\Scripts
Trinn 2: Finn sFTP-opplysningene dine i SureSMS
For at skriptet skal kunne laste opp filen, trenger det dine personlige sFTP-påloggingsdetaljer fra SureSMS. Skriptet er allerede konfigurert til å koble til sftp.suresms.com, så du trenger bare brukernavnet og passordet ditt.
Du kan få sFTP-informasjonen din ved å sende en e-post til [email protected] med brukernummeret ditt og den registrerte e-postadressen (se nederst til venstre når du er logget inn på app.suresms.com)
Trinn 3: Kjør skriptet
Åpne et PowerShell-vindu og naviger til mappen der du lagret skriptet. Du kan nå kjøre skriptet med de nødvendige parameterne.
Nedenfor ser du et eksempel på hvordan du kjører skriptet. Erstatt verdiene med din egen informasjon.
.\Export-EntraIDUsersToSFTP.ps1 -Groups "All Employees", "IT Support" ` -SFTPUsername "ditsftp-username"
Når du kjører kommandoen:
- Du vil først bli bedt om å logge inn på Microsoft-kontoen din for å gi skriptet tilgang til Entra ID.
- Du blir deretter bedt om å oppgi sFTP-passordet ditt.
Skriptet vil nå hente dataene, opprette en CSV-fil med navnet EntraID_Export.csv og laste den opp til SureSMS sFTP-serveren.
Parametere for skriptet
Her er en oversikt over parameterne du kan bruke til å tilpasse skriptets funksjon:
| Parameter | Beskrivelse |
| -Grupper | (Påkrevd) En liste over gruppenavnene fra Entra ID du ønsker å eksportere. Skille med komma, f.eks. "Gruppe1", "Gruppe2". |
| -SFTPUsername | (Påkrevd) Ditt sFTP-brukernavn fra SureSMS. |
| -SFTPPassord | (Valgfritt) Passord som SecureString. Hvis det ikke er angitt, blir du bedt om å oppgi det. |
| -SFTPPort | (Valgfritt) sFTP-port. Standard er 22. |
| -SFTPRemotePath | Mappen på sFTP-serveren der filen skal lastes opp. Standardinnstillingen er /. |
| -OutputPath | (Valgfritt) Endrer navnet på eller plasseringen av den lokale CSV-filen. Standardinnstillingen er .\EntraID_Export.csv. |
| -SkipSFTPUpload | (Valgfritt) Hvis dette er angitt, genereres bare CSV-filen lokalt uten å lastes opp til sFTP. |
Eksempler på bruk
Eksempel 1: Eksporter én gruppe og last den opp til SureSMS
.\Export-EntraIDUsersToSFTP.ps1 -Groups "Sales" -SFTPUsername "myuser"
Eksempel 2: Eksporter flere grupper til en bestemt mappe
.\Export-EntraIDUsersToSFTP.ps1 -Groups "IT", "HR", "Management" ` -SFTPUsername "myuser" ` -SFTPRemotePath "/contacts"
Eksempel 3: Kun lokal eksport uten sFTP-opplasting
.\Export-EntraIDUsersToSFTP.ps1 -Groups "All Employees" ` -OutputPath "C:\Export\Employees.csv" ` -SkipSFTPUpload
Automatisering med Windows Task Scheduler
For å holde kontaktlistene synkronisert kan du sette opp en planlagt oppgave i Windows som kjører skriptet automatisk med jevne mellomrom. Dette sikrer at nye ansatte eller endringer i telefonnumre automatisk gjenspeiles i SureSMS-mottakerlistene uten manuelt arbeid.
Slik oppretter du en planlagt oppgave:
- Åpne Oppgaveplanlegging i Windows.
- Klikk på Opprett grunnleggende oppgave.
- Gi oppgaven et navn, for eksempel "SureSMS Contact Sync".
- Velg hvor ofte oppgaven skal kjøres (f.eks. daglig).
- Velg Start et program som handling.
- Spesifiser exe som applikasjon og legge til hele banen til skriptet med parametere som argumenter.
Eksempel på argument:
-ExecutionPolicy Bypass -File "C:\Scripts\Export-EntraIDUsersToSFTP.ps1" -Groups "All Employees" -SFTPUsername "myuser"
Merk: For automatisert kjøring må du lagre passordet på en sikker måte. Du kan bruke -SFTPPassord parameteren med en SecureString lagret i en kryptert fil, eller kjør skriptet under en tjenestekonto med lagret legitimasjon.