Microsoft Entra SSO setup guide
Denne guide gennemgår opsætningen af ComplyClouds SSO løsning.
Hvis du har spørgsmål eller gerne vil sætte et support møde op, så kan du kontakte os på support@complycloud.com.
For at sætte SSO op får du brug for at oprette en Enterprise application i Microsoft Entra. Applikationen kommer til at stå for to ting:
- Autentificering gennem SAML, som derved håndterer login af dine brugere i ComplyCloud.
- Provisionering gennem SCIM, som håndterer synkroniseringen af brugere og deres roller mellem Entra og ComplyCloud.
ComplyCloud Integrationssiden
Flere steder i denne guide vil du få brug for information som er specifik til din ComplyCloud konto. Den information kan du finde på din ComplyCloud konto (Indstillinger > Kontostyring > Integrationer), som vist på billedet under. Herfra vil denne side blive referet til som ComplyCloud integrationssiden.
Setup
- Setup "Enterprise application"
- Gå til Entra Admin Center
- Naviger til “Enterprise applications”
- Klik på “New Application”
- Klik “Create your own application” og i vinduet til højre navngiv applikationen (eg. ComplyCloud SSO) og vælg “Integrate any other application…”
- Klik“Create”
- Setup applikationsroller
- Naviger til “App registrations”
- Find den "app registration" som er oprettet til din "enterprise application" og klik på den.
- I venstre sidepanel, vælg "App Roles". Den viste liste er enten tom eller indeholder et par irrelevante roller. For at mindske fremtidig forvirring anbefaler vi at du sletter eventuelle roller her ved at klikke dig ind på dem og fjerne fluebenet ved "Do you want to enable this role" og klik "Apply". Derefter burde du kunne slette den pågældende rolle ved "Delete".
- I venstre sidepanel, klik på "Manifest"
- På integrationssiden i ComplyCloud, klik på "Download app-roller" og åbn den hentede fil i notepad, word eller lignende. Indholdet af filen skal indsættes til højre for kolonnet hvor der står "appRoles" (og erstatte de eksisterende kantede klammer som burde stå der "[]").
- Klik “Save”
- Generér SAML
- Naviger til “Enterprise applications” og vælg din oprettede app
- I venstre sidepanel, klik “Single sign-on” og vælg “SAML” under “Select a sign-on method”.
- Klik “Edit” under “Basic SAML Configuration”.
- Klik “Add Identifier” og tilføj “Entity id” med værdien fra ComplyCloud Integrationssiden.
- Klik “Add Reply URL” og tilføj “Redirect URL” med værdien fra ComplyCloud Integrationssiden.
- Klik “Save”
- Upload SAML
- Stadig på siden fra det foregående trin, under “SAML Signing Certificate” klik “Download” hvor der står “Federation Metadata XML”.
- På ComplyCloud Integrationssiden, klik “Upload SAML” button og upload den hentede fil.
- Stadig på siden fra det foregående trin, under “SAML Signing Certificate” klik “Download” hvor der står “Federation Metadata XML”.
- Tilføj brugere og tildel roller
- På din "Enterprise application" app, gå til “Users and Groups” og klik “Add user/group”.
- Vælg brugeren som du gerne vil tildele adgang og de(n) rolle(r) som du gerne vil have brugeren har.
- Klik “Assign”.
-
Tilføj grupper (dette trin er valgfrit). BEMÆRK: Grupper i Microsoft Entra bruges til at oprette "Afdelinger" i ComplyCloud.
-
Gå til “Users and Groups” igen og klik “Add user/group”.
-
Vælg de grupper du gerne vil tildele din "Enterprise application" og tildel dem roller. Det er vigtigt at tildele den minimale rolle, idet den vil blive tildelt alle brugerne i gruppen.
-
Klik “Assign”.
-
- Setup provisionering
- Naviger til "Enterprise application" siden og gå til “Provisioning”.
- Klik “Get started” og vælg “Automatic Provisioning mode”.
- Under “Admin Credentials” ved “Tenant URL” indsæt “Provision URL” værdien fundet på ComplyCloud integrationssiden.
- Ved “Secret Token” indsæt “Provision Secret” værdien fundet på ComplyCloud integrationssiden.
- Test at konfigurationen er korrekt ved at klikke på “Test Connection” knappen.
- Klik på "Provision Microsoft Entra ID Users" under "Mappings"
- Sæt flueben ved “Show advanced options” i bunden af siden og klik på “Edit attribute list for customappsso”
- Sæt flueben ved "Required" på den række som hedder “emails[type eq “work”].value”
- Tilføj en række i bunden som hedder “roles” med “Type” sat til “String” og sæt flueben ved “Required” og “Multi-value”.
- Klik på "Save"
- Tilbage på "Attribute Mapping" siden, klik på "Add New Mapping" og sæt følgende værdier:
- Mapping Type – Expression
- Expression – AppRoleAssignmentsComplex([appRoleAssignments])
- Target attribute – roles
- Konfigurér din attribute mapping så den matcher følgende:
customappsso Attribute Microsoft Entra ID Attribute userName userPrincipalName active Switch([IsSoftDeleted],,"False","True","True","False") displayName displayName emails[type eq "work"].value userPrincipalName preferredLanguage preferredLanguage roles AppRoleAssignmentsComplex([appRoleAssignments])
- Klik "Ok" og Klik "Save"
- Aktiver provisioneringen
- Naviger til "Enterprise application" og klik på "Provisioning"
- Klik på "Start provisioning" knappen for at få Entra til at påbegynde synkroniseringen af dine konfigurerede brugere og grupper, som du satte op under trin 5.
- Hvis du gerne vil køre kontrollerede tests af din opsætning kan du bruge "Provision on demand" funktionaliteten på siden her. Fælg instrukserne på skærmen for at synkronisere enkelte brugere eller grupper.
Du er færdig! Provisionerede brugere burde nu sendes til Microsoft for at logge ind når de indtaster deres email i ComplyCloud. Kontakt os på support@complycloud.com hvis du oplever problemer med din opsætning.