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”.
- Setup provisionering
- Navigér 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"
-
Tilføj grupper (valgfrit). Alle provisionerede grupper vil blive oprettet som afdelinger på den primære ComplyCloud konto, men hvis du har underkonti og ønsker at afdelinger oprettes på disse, skal du konfigurere en "roles" attribute ligesom du gjorde for brugere.
-
Gå til din Enterprise application side for den oprettede app, gå til “Provisioning” og derfra til “Attribute mapping”
-
Vælg “Provision Microsoft Entra ID Groups”, tik “Show advanced options” boksen i bunden og klik på “Edit attribute list for customappsso”
- På Edit Attribute List siden, opret en række med navnet “roles”, med tiks i boksene “Required?” og “Multi-Value?”.
- Tik også “Required?” boksen for “members” attributten.
- Klik “Save” i øverste venstre hjørne.
- Klik på “Add new mapping” og sæt følgende værdier:
- Mapping Type – Expression
- Expression – AppRoleAssignmentsComplex([appRoleAssignments])
- Target attribute – roles (Du skal muligvis refreshe siden for at kunne se den mulighed)
- Klik på “Enabled” knappen, for at slå provisioneringen af grupper til.
- Klik “Save” i øverste venstre hjørne.
- Fra siden “Users and groups”, kan du nu provisionere grupper som afdelinger.
- Vælg de grupper som du gerne vil have tilføjet og tildel dem en passende rolle. Bemærk at brugerne i gruppen vil få tildelt samme rolle, medmindre de har fået tildelt en højere rolle på anden vis.
- Klik på “Assign” knappen.
-
- 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 de brugere or grupper som du ønsker har adgang. Bemærk at en bruger og gruppe kan tildeles flere roller (dog én af gangen) og skal tildeles flere roller for at kunne tilgå flere konti.
- 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.