Konfigurera Single Sign-on för 2c8 LiveView

Förutsättningar

Den här artikeln beskriver den tekniska konfigurationen av OIDC/SSO för en befintlig LiveView-publiceringsplats.

Konfigurationen kräver vanligtvis samarbete mellan följande roller:

• En serveradministratör med ansvar för er 2c8-server
• En administratör för er Identity Provider (exempelvis Entra ID eller AD FS)

Innan ni fortsätter behöver ni:

• Ha tillgång till Liveview-serverkonfigurationen
• Ha påbörjat skapandet av en LiveView-publiceringsplats
• Ha valt OIDC som åtkomstkontroll
• Ha en Identity Provider som stödjer OpenID Connect (OIDC)

Funktionen är testad med:

• Microsoft Entra ID
• Microsoft Active Directory Federation Services (AD FS)

Om ni ännu inte har skapat en LiveView-publiceringsplats, följ först artikeln:

• Skapa en LiveView publiceringsplats

Konfigurera OIDC med Microsoft Entra ID

När ni har valt OIDC som åtkomstkontroll visas de fält som behöver fyllas i för OIDC-konfigurationen.

Värdena hämtas från Microsoft Entra Admin Center. Dessa värden tillhandahålls vanligtvis av er Identity Provider-administratör och anges av serveradministratören i 2c8-konfigurationen.

Stegen nedan beskriver hur ni hämtar de nödvändiga värdena från Microsoft Entra.

Skapa en appregistrering i Microsoft Entra ID

1. Logga in i Microsoft Entra admin center
2. Gå till App registrations
3. Klicka på New registration

Ange Redirect URI

1. Kopiera värdet från Callback URL i LiveView-konfigurationen
2. I Entra ID, klistra in adressen i Redirect URI
3. Klicka på Add

Skapa Client Secret

1. Gå till:
   Certificates & secrets
2. Klicka på New client secret
3. Ange namn och giltighetstid
4. Klicka på Add
5. Kopiera värdet från Value

Viktigt: värdet visas endast en gång.

Hämta Client ID

1. Gå till Overview
2. Kopiera:
   • Application (client) ID
   • Directory (tenant) ID

Konfigurera OIDC i LiveView

Fyll i följande värden i LiveView-konfigurationen:

Ange Discovery URI

I fältet Discovery URI, ange:

https://login.microsoftonline.com/<tenant-id>/v2.0/.well-known/openid-configuration

Ersätt:

<tenant-id>

med ert Directory (tenant) ID från Entra ID.

Godkänn API permissions

1. Gå till API permissions
2. Klicka på Grant admin consent

Hantera vilka användare som får åtkomst

1. Gå till Enterprise applications
2. Öppna appregistreringen
3. Gå till Properties

Här kan ni välja om ni vill tillåta alla användare i er organisation, eller begränsa åtkomst till användare eller grupper.
 

Tillåt alla användare

Sätt:

Assignment required = No

Begränsa åtkomst till specifika användare eller grupper

1. Sätt:
   Assignment required = Yes
2. Gå till Users and groups
3. Lägg till de användare eller grupper som ska ha åtkomst
4. Klicka på Save

Slutför

När alla fält är ifyllda kan ni skapa eller uppdatera LiveView-publiceringsplatsen.

Konfigurera OIDC med Microsoft AD FS

När ni har valt OIDC som åtkomstkontroll visas de fält som behöver fyllas i för OIDC-konfigurationen.

Värdena hämtas från Microsoft AD FS. Dessa värden tillhandahålls vanligtvis av er Identity Provider-administratör, medan serveradministratören ansvarar för att fylla i dem i 2c8-konfigurationen.

Stegen nedan beskriver hur ni hämtar de nödvändiga värdena från Microsoft AD FS.

Förutsättningar

Innan ni fortsätter behöver ni:

• Active Directory Federation Services (AD FS) 2016 eller senare
• Ha påbörjat skapandet av en LiveView-publiceringsplats
• Ha valt OIDC som åtkomstkontroll i LiveView-konfigurationen

Ange Discovery URI

I fältet Discovery URI, ange:

https://customer.2c8.com/adfs/.well-known/openid-configuration

Skapa en applikationsgrupp i AD FS

1. Öppna AD FS
   
2. Gå till Application Groups
3. Klicka på Add Application Group
   

Välj applikationstyp

1. Ange ett valfritt namn på applikationen
2. Välj:
   Server application accessing a web API
3. Klicka på Next

Konfigurera Client ID

1. Kopiera värdet från Client identifier
2. Klistra in värdet i fältet Client ID i LiveView-konfigurationen
3. Klicka på Next
   

Ange Redirect URI

1. Kopiera värdet från Callback URL i LiveView-konfigurationen
   
2. Klistra in adressen i fältet Redirect URI i AD FS
   
3. Klicka på Add
4. Klicka på Next

Konfigurera Client Secret

1. Kopiera värdet från Client secret
2. Klistra in värdet i fältet Client Secret i LiveView-konfigurationen
   
3. Klicka på Next

Configure Web API

Fältet Identifier måste innehålla ett värde.

1. Ange ett valfritt värde
   
2. Klicka på Add
3. Klicka på Next
    

Välj åtkomstpolicy

1. Välj vilken Access Control Policy som ska användas
   Policyn styr vilka användare som får åtkomst till publiceringen
   
2. Klicka på Next

Välj behörigheter

1. Under Application Permissions, välj:
   • email
   • openid
2. Slutför guiden
   

Slutför

1. Gå tillbaka till LiveView-konfigurationen
2. Kontrollera att alla OIDC-fält är ifyllda
3. Klicka på Update

OIDC/SSO-konfigurationen är nu klar.