Konfigurera SSO för 2c8 LiveView

Konfigurationen består av tre delar:

1. Ni konfigurerar LiveView och ger en uppgift till IT
   Ni kopierar Callback URL och skickar den till er IT-/Identity Provider-administratör.
2. IT konfigurerar Microsoft Entra ID
   IT skapar appregistreringen och skickar tillbaka de uppgifter ni behöver.
3. Ni slutför konfigurationen i LiveView
   Ni använder uppgifterna från IT för att fylla i OIDC-konfigurationen.

1. Ni börjar i LiveView

1. Öppna konfigurationen för er LiveView-publiceringsplats.
2. Välj OIDC som åtkomstkontroll.
3. Kopiera värdet i Callback URL.
4. Skicka Callback URL till er IT/Identity Provider administratör

Det här är den enda uppgift ni behöver skicka till IT för att de ska kunna börja konfigurera Microsoft Entra ID. IT ska använda Callback URL som Redirect URI i Microsoft Entra ID.

När IT har genomfört alla steg under 2. IT konfigurerar Microsoft Entra ID lämnar de tillbaka de värden som ni behöver klistra in i LiveView-konfigurationen. Vilka värden det gäller och var de ska klistras in beskrivs under 3. IT lämnar över uppgifterna till er. 

Skicka gärna länken till den här artikeln till IT så att de kan följa stegen nedan. 

2. IT konfigurerar Microsoft Entra ID

Nu behöver IT-/Identity Provider-administratören ta över.

IT behöver skicka tillbaka värdena tydligt och ange vilken inställning respektive värde gäller, så att den som konfigurerar LiveView-publiceringsplatsen vet var värdena ska klistras in.

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. Använd värdet från Callback URL som du fått från den som konfigurerar LiveView-publiceringsplatsen.
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.
• Client Secret är en känslig uppgift. Lämna över detta på ett säkert sätt.

Hämta Client ID

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

Skicka tillbaka värden

Sicka följande värden till den som konfigurerar LiveView-publiceringsplatsen:

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

3. IT lämnar över uppgifterna till er

När IT har konfigurerat appregistreringen behöver ni få tillbaka tre uppgifter:

Callback URL ska inte skickas tillbaka. Den har ni redan.

4. Ni slutför konfigurationen i LiveView

Gå tillbaka till LiveView-konfigurationen.

1. Ange Client ID
   Ange det Application (client) ID som ni fick från IT.
2. Ange Client Secret
   Ange det Client secret Value som ni fick från IT.
3. Ange Discovery URI
   Discovery URI skapar ni själva med hjälp av Directory (tenant) ID som ni fick från IT.

Ange:

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

Ersätt <tenant-id> med ert Directory (tenant) ID.

Exempel:

https://login.microsoftonline.com/12345678-abcd-1234-abcd-123456789abc/v2.0/.well-known/openid-configuration

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

Konfigurationen består av tre delar:

1. Ni börjar i LiveView och ger Callback URL till IT
   Ni hämtar Callback URL från LiveView och skickar den till er AD FS-administratör.
2. IT konfigurerar AD FS
   IT skapar applikationsgruppen och skickar Discovery URI, Client ID och Client Secret till er.
3. Ni slutför konfigurationen i LiveView
   Ni använder uppgifterna från IT och uppdaterar publiceringsplatsen.

1. Ni börjar i LiveView

1. Öppna konfigurationen för er LiveView-publiceringsplats.
2. Välj OIDC som åtkomstkontroll.
3. Kopiera värdet i Callback URL.
4. Skicka Callback URL till er IT/Identity Provider administratör
   Identity Provider administratören behöver använda Callback URL som Redirect URI.

När IT har genomfört alla steg under 2. IT konfigurerar Microsoft AD FS lämnar de tillbaka de värden som ni behöver klistra in i LiveView-konfigurationen. Vilka värden det gäller och var de ska klistras in beskrivs under 3. IT lämnar över uppgifterna till er.

Skicka gärna länken till den här artikeln till IT så att de kan följa stegen nedan. 

2. IT konfigurerar AD FS

Nu behöver IT-/Identity Provider-administratören ta över.

IT behöver skicka tillbaka värdena tydligt och ange vilken inställning respektive värde gäller, så att den som konfigurerar LiveView-publiceringsplatsen vet var värdena ska klistras in.

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

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

Hämta Discovery URI

Discovery URI används för att LiveView ska kunna hitta konfigurationsinformationen för er OIDC-inloggning.
IT behöver skicka adressen till AD FS-tjänsten. Lägg till följande sökväg efter adressen:
/adfs/.well-known/openid-configuration

Exempel:
https://<adress-till-er-AD-FS-server>/adfs/.well-known/openid-configuration
IT ska lämna över den fullständiga Discovery URI:n till den som konfigurerar LiveView-publiceringsplatsen.

Konfigurera Client ID

1. Kopiera värdet från Client identifier
2. Det här är det Client ID som ska användas i LiveView.
3. Skicka Client ID till serveradministratören.
4. Klicka på Next
   

Ange Redirect URI

1. Använd den Callback URL som serveradministratören skickade.
2. Klistra in adressen i Redirect URI.
   
3. Klicka på Add
4. Klicka på Next

Konfigurera Client Secret

1. Kopiera värdet från Client secret.
2. Det här är det Client Secret som ska användas i LiveView.
3. Skicka Client Secret till serveradministratören.
   Viktigt: Client Secret är en känslig uppgift. Lämna över detta på ett säkert sätt.
   
   
4. 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
   

3. IT lämnar över uppgifterna till er

När IT har skapat applikationsgruppen behöver ni få tillbaka:

Ni har redan skickat Callback URL till IT.

4. Ni slutför konfigurationen i LiveView

1. Gå tillbaka till LiveView-konfigurationen.
2. Kontrollera att följande fält är ifyllda:
   • Client ID
   • Client Secret
   • Discovery URI
3. Klicka på Update.

OIDC/SSO-konfigurationen är nu klar.