SSO-integration | Gfacility

Integrationer · Autentisering · 1.4

Med single sign-on (SSO) loggar medarbetarna in i Gfacility via er egen organisations identitetsleverantör, till exempel Microsoft Entra ID (tidigare Azure AD) eller OneLogin. Er IT bestämmer vem som får logga in och på vilka villkor. Gfacility stöder OpenID Connect och SAML 2.0.

SSO eller Logga in med Microsoft?

Med båda loggar medarbetarna in med sitt Microsoft-jobbkonto, men via olika appar i er Entra-tenant. Välj en av dem.

	Logga in med Microsoft	Single sign-on (SSO)
Vilken app	Gfacility-appen	En app som er IT skapar själv
Konfiguration	En administratör godkänner en gång via en länk	IT skapar en appregistrering, Gfacility-administratören fyller i uppgifterna
Vem förvaltar appen	Gfacility	Er egen IT (vem som får logga in, hur länge en hemlighet gäller)
Passar bäst för	Snabb start, lite IT-arbete	Organisationer som vill behålla kontrollen själva

Väljer ni Logga in med Microsoft? Läs då Logga in med Microsoft. Den här artikeln handlar om SSO.

I den här artikeln anges alltid URL:erna för produktion (app.gfacility.com) och UAT/test (uat.gfacility.com). Använd URL:en för den miljö du konfigurerar.

1. Konfiguration via OpenID Connect (rekommenderas)

OpenID Connect är snabbast att konfigurera. Arbetet delas mellan två personer: er organisations IT-administratör (steg A) och Gfacility-administratören (steg B).

A. I Microsoft Entra ID (IT-administratör)

Steg	Vad du gör
1	Gå till entra.microsoft.com → Appregistreringar → Ny registrering. Ange ett namn (t.ex. Gfacility SSO) och välj Endast konton i den här organisationskatalogen.
2	Under Omdirigerings-URI väljer du plattformen Webb och anger: PROD: `https://app.gfacility.com/login/sso` UAT: `https://uat.gfacility.com/login/sso` Klicka på Registrera.
3	Anteckna Application (client) ID och Directory (tenant) ID på sidan Översikt.
4	Klicka på Slutpunkter och kopiera OAuth 2.0-auktoriseringsslutpunkten (v2). Den slutar på `/oauth2/v2.0/authorize`.
5	Gå till Autentisering och kryssa i ID-token. Klicka på Spara.
6	Gå till Certifikat och hemligheter → Ny klienthemlighet. Kopiera värdet direkt (inte hemlighets-ID:t); det visas bara en gång. Anteckna utgångsdatumet.
7	Gå till API-behörigheter. Kontrollera att `openid`, `profile` och `User.Read` finns under Microsoft Graph (delegerade). Klicka på Bevilja administratörsmedgivande för [organisation] och bekräfta.
8	Gå till Företagsprogram → [appens namn] → Användare och grupper och lägg till de medarbetare eller grupper som får logga in.

B. I Gfacility (Gfacility-administratör)

Gå till Integrationer & inloggning → Single sign-on (SSO) → Lägg till identitetsleverantör och välj Microsoft Entra ID (OpenID). Fyll i:

Fält i Gfacility	Vad du fyller i
Authority-URL	Auktoriseringsslutpunkten från steg 4, som slutar på `/oauth2/v2.0/authorize`
Omdirigerings-URL	Exakt samma URL som i steg 2
Omdirigerings-URL efter utloggning	Valfritt, t.ex. `https://app.gfacility.com/login`
Scope	Lämna tomt (Gfacility använder då `openid profile`)
Tenant-ID	Directory (tenant) ID från steg 3
Client ID	Application (client) ID från steg 3
Client secret	Värdet från steg 6

Klicka på Testa anslutning. Slå på single sign-on för alla först när du har testat med en användare (se nedan).

Testa

Öppna ett nytt privat fönster och gå till https://app.gfacility.com/login/sso?email=namn@ditforetag.se (eller uat. för testmiljön). Logga in med det kontot. Hamnar du i Gfacility fungerar det.

Du ser	Orsak och lösning
"Need admin approval"	Administratörsmedgivandet från steg 7 saknas. Om skärmen nämner Gfacility-appen i stället för er egen app går inloggningen via Logga in med Microsoft: använd länken med `/login/sso`.
Fel om svars-URL:en eller omdirigerings-URI:n	Omdirigerings-URL:en i Gfacility och i Entra är inte exakt likadan. Kontrollera `https`, `app` eller `uat` och ett avslutande `/`.
"not assigned to a role" eller liknande	Användaren lades inte till i steg 8.
Tillbaka i Gfacility, men inte inloggad	Användarens e-postadress i Gfacility måste stämma med användarens inloggningsnamn i Microsoft.

2. Konfiguration via SAML 2.0

SAML kräver en engångskonfiguration av Gfacility. Kom därför först överens med oss om vilket företagsnamn som ska användas i URL:erna. Följ sedan de här stegen i Microsoft Entra ID:

Steg	Vad du gör
1	Gå till Program → Företagsprogram → Översikt.
2	Öppna Azure AD SAML Toolkit. Finns det inte? Klicka på + Nytt program.
3	I vänstermenyn: Enkel inloggning.
4	Klicka på Redigera vid den grundläggande SAML-konfigurationen och fyll i URL:erna (se nedan).
5	Skicka oss uppgifterna från steg 3 (SAML-certifikat) och steg 4 (Toolkit).

URL:er för steg 4

Ersätt {companyname} med det namn du har kommit överens om med Gfacility.

Produktion

Identifier (Entity ID): https://app.gfacility.com/api/sso/{companyname}/metadata
Reply URL (ACS): https://app.gfacility.com/api/sso/{companyname}/acs
Sign-on URL: https://app.gfacility.com/login/sso

UAT / Test

Identifier (Entity ID): https://uat.gfacility.com/api/sso/{companyname}/metadata
Reply URL (ACS): https://uat.gfacility.com/api/sso/{companyname}/acs
Sign-on URL: https://uat.gfacility.com/login/sso

Vad skickar du till Gfacility?

Steg 3 (SAML-certifikat): App Federation Metadata URL.
Steg 4 (SAML Toolkit): Sign-on URL, Microsoft Entra Identifier och Sign-out URL.

När Gfacility har konfigurerat kopplingen lägger du i Gfacility till en identitetsleverantör av typen Microsoft Entra ID (SAML) under Integrationer & inloggning → Single sign-on (SSO). Ange Entras inloggnings-URL som omdirigerings-URL.

Se även Microsofts artikel om att konfigurera SAML i Entra för mer bakgrund.

Logga in med SSO

Slutanvändarna väljer “Logga in med SSO” på inloggningsskärmen. Med en direkt-URL kan du göra det ännu enklare:

Automatisk identifiering

Användaren anger sin e-postadress en gång. Webbläsaren kommer ihåg den vid senare besök. Praktiskt att lägga på intranätet.

PROD: https://app.gfacility.com/login/sso?email=auto

UAT: https://uat.gfacility.com/login/sso?email=auto

Specifik URL

Skicka med e-postadressen i URL:en (t.ex. via ert intranät). Användaren behöver inte fylla i något.

PROD: app.gfacility.com/login/sso?email=mail@user.com

UAT: uat.gfacility.com/login/sso?email=mail@user.com

← Föregående: Logga in med Microsoft Nästa: Konfigurera e-postutskick→