Anpassad SSO-integration – Guide – Palms Hjälpcenter

Den här guiden beskriver hur Anpassad SSO-integrationen i Palms fungerar – hur du skickar användardata, vilka fält som kan mappas och hur matchning mot befintliga användare går till.

Översikt

Anpassad SSO-integrationen består av en SSO-endpoint som skapar eller uppdaterar användare och returnerar en redirect-URL för inloggning.

Så fungerar det

Gör ett POST-anrop till din synkroniserings-URL med din API-nyckel i headern X-Api-Key och ett JSON-objekt som representerar användaren i bodyn.

Det finns inget krav på objektets format. Nästa avsnitt beskriver hur inkommande data mappas till attribut i Palms.

Exempel på anrop

POST /integration/simplesso/999/sync
X-Api-Key: abc123
Content-Type: application/json

{  
    "name": "Alice Barker",
    "contact": {
        "email": "alice@example.com",
        "phone": "555-1234"
    }
}

Exempel på svar

HTTP/1.1 200 OK  
Content-Type: application/json  
  
{  
    "redirect_url": "https://<din-domän>/integration/simplesso/999/login/def456"  
}

Redirect-URL:en i svaret används för att logga in användaren i Palms.

Fältmappning

Inkommande JSON-data mappas till Palms-attribut med hjälp av JSONQuery-syntax. https://jsonquerylang.org/

Nedan listas de giltiga Palms-attributen.

Användarattribut

Palms-fält	Beskrivning
Standardfält
`user_given_name`	Förnamn
`user_family_name`	Efternamn
`user_full_name`	Helt namn
`user_email`	E-postadress
`user_phone`	Telefonnummer
`user_locale`	Språk
`user_timezone`	Tidszon
`user_active`	Aktiv/Inaktiv

Avancerade fält
`user_met:<id>`	Metadata-fält
`user_log:<id>:<attribut>`	Inloggningssystem-fält
`user_int:<id>:<attribut>`	Integration-fält

För integration-fält kan du använda {id} som ett substitut för den integration du skapar/redigerar just nu. Exempel: user_int:{id}:personnummer

Team- och rollattribut

Team och roll med samma <n> bildar ett medlemskap.

Palms-fält	Beskrivning
`team<n>_name`	Teamnamn eller sökväg
`team<n>_met:<id>`	Team-metadatafält
`role<n>_name`	Rollnamn

Matchning av användare

För att matcha inkommande data mot befintliga användare i Palms anger du en kommaseparerad lista med attribut som ska användas för matchning, t.ex.:

int:{id}:identifier,email,phone

Palms försöker matcha i den ordning attributen anges. Om en matchning hittas uppdateras den befintliga användaren. Om ingen matchning hittas skapas en ny användare.

Giltiga fält:

Fält	Beskrivning
`name`	Helt namn
`email`	E-postadress
`phone`	Telefonnummer
`met:<id>`	Metadata-fält
`log:<id>:<attribut>`	Inloggningssystem-fält
`int:<id>:<attribut>`	Inkommande fält i integrationen