Opsætning af SBSYS via SBSIP
Formål:
Denne artikel vejleder i opsætningen af SBSIP WEB API, som åbner adgangen fra XFlow til SBSYS. Vejledningen er fælles for både SaaS og On-Premise.
Hvis der er et ønske om at benytte integrationen til SBSIP, men det ikke er en del af jeres implementering, bedes I kontakte supporten. Dertil er det altid en god ide at spørge XFlow ved tvivl eller spørgsmål.
Sidst redigeret: 25/02/2025
Indholdsfortegnelse:
1. Vigtigt at vide
Har man benyttet SBSYS i XFlow før, skal man være særligt opmærksom på følgende:
Opstart af sager uden sagsskabelonID er ikke muligt igennem SBSIP. Derfor er det vigtigt at undersøge, om der findes dataafleveringer “SbsysOpretSag” i jeres XFlow, som benyttes.
Dataafleveringerne vil ikke fungere efter et skifte til SBSIP, og vi anbefaler derfor, at man skifter disse til dataafleveringen “SBSYS opret fra sagsskabelon”.
Det er vigtigt at understrege, at det kun er opsætning i organisationsindstillinger, der skal ændres for at skifte til benyttelse af SBSIP. Evt. allerede opsatte dataafleveringer i XFlow vil køre videre, men med en ny måde at aflevere til SBSYS.
2. Forarbejde
Inden det er muligt at opsætte integrationen i XFlow, er der et par trin, som skal indhentes hos den ansvarlige for SBSYS i den givne IT-afdeling.
API URL til jeres SBSYS WEBAPI. Eksempel: https://sbsysapi.kommune.dk
Denne URL skal fremstå UDEN "api" til sidst: https://sbsysapi.kommune.dk/api
2.1. Authentication token
I langt de fleste tilfælde vil der blive benyttet token authentication. Derfor skal følgende indstillinger findes:
Authentication URL til at hente token fra SBSIP API'et. Eksempel:
https://sbsip-web.kommune.dk:8543/auth/realms/sbsip/protocol/openid-connect/token
ClientID - Eksempel - “demo-udv-xflow”
ClientSecret - Hemmeligt password
Der findes to måder at authenticate op imod API'et, også kaldet for Grant type.
Bruges der direkte authentication til API, skal Grant type være “password”
Bruges der Windows Authentication til API, skal Grant type være “client_credentials”
Normalt oprettes der en servicebruger til XFlow, som har sit eget brugernavn og password.
SBSYS password
SBSYS brugernavn
Benytter jeres SBSIP Brugerdefineret anmodningsrequest headers er det muligt at sætte op som på billedet senere i guiden.
3. Vejledning i XFlow
Når indstillingerne ligger klar, kan de sættes ind i organisationsindstillinger i XFlow. Dette gøres ved at tilgå “Organisation > Indstillinger > SBSIP”. Husk at gøre det på alle organisationer, der afleverer til SBSYS. Efterfølgende skrives indstillingerne fra forarbejdet ind i XFlow som følgende:
Aktiveres levering til SBSYS over SBSIP vil systemet automatisk skifte over til levering med SBSIP.
OBS: Authentication med et token er den mest brugte måde til at skabe sikkerhed imellem XFlow og SBSYS. Derfor slås “Autentificer med et token” næsten altid til.
Har man spørgsmål til opsætningen efter at have fulgt denne vejledning, er man velkommen til at kontakte XFlow.
