Appearance
Konfigurationsfiler
Detta kapitel innehåller beskrivning av parametrar i konfigurationsfilerna i flexites produktfamilj.
Obs!
Detta kapitel är under uppbyggnad och innehåller därmed inte fullständig information om samtliga parametrar.
flexiteCLIENT
flexite.ini
flexite.ini är den huvudsakliga konfigurationsfilen för flexiteCLIENT.
Filen är belägen i rotkatalogen för flexiteCLIENT.
Exempel
ini
[DATABASE CONNECTION]
ConnectServerType=SQLServer
ConnectDatabaseName=sqlserver.company.com:flexite
ConnectUserName=dbUserName
ConnectUserPassword=ABCDEFGH12345678
SingleConnection=1
[PROGRAM LOGIN]
LoginUserName=
LoginPassword=
UseWindowsLogin=0
HideUserFunctions=1
[PARAMETERS]
SendMail=1
; 1 - plain
; 2 - HTML
MailFormat=2
LoadUserName=1
PointsRefreshMinutes=5
ShowToDoList=1[DATABASE CONNECTION]
Dessa parametrar anger uppgifter för databasanslutning.
| Parameter | Beskrivning / Värde |
|---|---|
ConnectServerType | Typ av anslutning till Microsoft SQL Server:
|
ConnectDatabaseName | Sökväg för databasanslutning. |
ConnectUserName | Användarnamn för konto för databasanslutning. |
ConnectUserPassword | Lösenord i krypterat format för konto för databasanslutning. Lösenord i krypterat format kan hämtas från konfigurationsfilerna för applikationerna flexiteDBUpdate ( |
Databasanslutning
flexiteCLIENT nyttjar samma parameternamn och -värden för konfiguration av databasanslutning som flexiteProcessEngine. För information om konfiguration av databasanslutning för flexiteProcessEngine, se avsnitt Databasanslutning.
[PARAMETERS]
Dessa parametrar kan användas för att skräddarsy funktionalitet i flexiteCLIENT.
| Parameter | Beskrivning / Värde |
|---|---|
IdleTimeout | Gränsvärde för tillåten passiv tid i flexiteCLIENT innan användaren loggas ut. Tid anges i minuter. Standardvärde om inget anges: |
IdleTimeout
I flexiteCLIENT avslutas en användarsession som standard efter 90 minuters inaktivitet. Undantaget från detta är sessioner med ej sparade förändringar samt pågående operationer såsom exempelvis importer och exporter.
flexiteProcessEngine
flexiteProcessEngine.dat
flexiteProcessEngine.dat är en systemkritisk fil med information om de tjänster som körs av aktuell flexiteProcessEngine. Denna fil genereras vid uppstart av flexiteProcessEngine och uppdateras därefter löpande.
Filen är belägen i rotkatalogen för flexiteProcessEngine.
Exempel
SupervisorStartDateTime=1234567890
LogsBackupDateTime=2024-01-31 00:00
flexiteProcessEngine=9876543210
flexiteProcessEngine_hwnd=123456
flexiteProcessEngine_pid=1234
OnHoldService=2024-01-31 10:00
AlarmService=2024-01-31 10:10
StatisticsService=2024-01-31 10:20
DBLink=2024-01-31 10:30
DBLink_PID=2345
LeadTimesService=2024-01-31 10:40
SubstituteService=2024-01-31 10:50
MailService=2024-01-31 10:00
MailService_PID=3456
MailService_prepare=2024-01-31 10:00
MailService_prepare_PID=4567
MailService_send=2024-01-31 10:00
MailService_send_PID=5678flexiteProcessEngine.ini
flexiteProcessEngine.ini är den huvudsakliga konfigurationsfilen för flexiteProcessEngine.
Filen är belägen i rotkatalogen för flexiteProcessEngine.
Exempel
ini
[Service]
Name=flexiteProcessEngine
DisplayName=FlexiteProcessEngine %version
Description=Support services for the Flexite Web application
CheckServices=1
[Logs]
; 1 - only general log files
; 2 - both general log files and working log files
DebugLevel=1
AlarmLog=Logs\alarm.log
AlarmDebugLog=Logs\alarm_debug.log
ReportLog=Logs\report.log
ReportDebugLog=Logs\report_debug.log
StatisticsLog=Logs\statistics.log
StatisticsDebugLog=Logs\statistics_debug.log
OnHoldLog=Logs\onhold.log
OnHoldDebugLog=Logs\onhold_debug.log
DBLinkLog=Logs\dblink.log
DBLinkDebugLog=Logs\dblink_debug.log
ExternalDataLog=Logs\external_data.log
ExternalDataDebugLog=Logs\external_data_debug.log
LeadTimesLog=Logs\leadtimes.log
LeadTimesDebugLog=Logs\leadtimes_debug.log
SubstituteLog=Logs\substitute.log
SubstituteDebugLog=Logs\substitute_debug.log
MailsLog=Logs\mail.log
MailsDebugLog=Logs\mail_debug.log
BackupFolder=logbackup
; DBlinkSvc. Create Indy debug log (message task)
DBLinkSpecialDebugLog = 0
; MailSvc. Create special debug log
MailSpecialDebugLog = 0
; MailSvc. Create special debug log and include it into service debug
; log
MailSpecialDebugLogToDebugLog = 0
[Database.0]
ConnectServerType=SQLServer
ConnectDatabaseName=sqlserver.company.com:flexite
ConnectUserName=dbUserName
ConnectUserPassword=ABCDEFGH12345678
OnHoldSvc=1
AlarmSvc=1
StatisticsSvc=1
DBLinkSvc=1
LeadTimesSvc=1
SubstituteSvc=1
MailSvc=1
ExportAuthorizationChangesLog=1
AuthorizationChangesLogs=AppLogs\AuthorizationChanges
ExportEmailsLog=1
Emails=AppLogs\Emails
ExportImpUsersLog=1
ImportUsersLogs=AppLogs\ImportUsers
ExportInstancesLog=1
InstancesLogs=AppLogs\Instances
ExportManualExport=1
ManualExportLogs=AppLogs\ManualExport
ExportProcessChangesLog=1
ProcessChangesLogs=AppLogs\ProcessChanges
ExportReplaceDataLog=1
ReplaceDataTaskChangesLogs=AppLogs\ReplaceDataTaskChanges
ExportSearchesLog=1
SearchesLogs=AppLogs\Searches
ExportUserAccountChanges=1
UserAccountChangesLogs=AppLogs\UserAccountChanges
ExportUsersSessionsLog=1
UsersSessionsLogs=AppLogs\UsersSessions
DeleteLogsChunkSize=10000,5
[ExternalData]
DLLLocation=ExtData
InfoPort=25020
DataPort=35020
[ActionDLL]
DLLLocation=ActionDLL[Service]
Anger generella inställningar för tjänsten flexiteProcessEngine.
| Parameter | Beskrivning / Värde |
|---|---|
Name | Namnet på tjänsten för flexiteProcessEngine. Måste inledas med Standard: |
DisplayName | Visningsnamn för tjänsten för flexiteProcessEngine. Standard: |
Description | Beskrivning av tjänsten för flexiteProcessEngine. Standard: |
CheckServices | Aktivera/inaktivera automatisk statuskontroll av flexiteProcessEngines tjänster på aktuell instans av flexiteProcessEngine. Globala inställningar anges i flexiteCLIENT (se avsnitt Konfigurera flexiteProcessEngine).
|
[Logs]
Denna sektion anger global loggningsnivå samt globala sökvägar för loggfiler för samtliga systemtjänster som aktuell flexiteProcessEngine ansvarar för.
[Database.X]
Denna sektion innehåller databasspecifik konfiguration.
Det är möjligt att ansluta en flexiteProcessEngine till flera databaser. I detta fall anges den första databasanslutningen i sektion [Database.0], den andra i [Database.1], den tredje i [Database.2] och så vidare.
Databasanslutning
Dessa parametrar anger uppgifter för databasanslutning.
| Parameter | Beskrivning / Värde |
|---|---|
ConnectServerType | Typ av anslutning till Microsoft SQL Server:
|
ConnectDatabaseName | Sökväg för databasanslutning. Samma sökväg måste anges för flexiteWEB med parametern För mer information, se avsnitt Database connection. |
ConnectUserName | Användarnamn för konto för databasanslutning. |
ConnectUserPassword | Lösenord i krypterat format för konto för databasanslutning. Lösenord i krypterat format kan hämtas från konfigurationsfilerna för applikationerna flexiteCLIENT ( |
Anslutning till standardinstans och standardport
Anslut till en Microsoft SQL-servers standardinstans på standardporten; 1433. Stödjer både krypterad och okrypterad anslutning, baserat på konfiguration av Microsoft SQL Server.
ini
ConnectServerType=SQLServer
ConnectDatabaseName={dbServer}:{dbName}Exempel
ini
ConnectServerType=SQLServer
ConnectDatabaseName=sqlserver.company.com:flexiteKrypterad anslutning till standardinstans och standardport
Anslut till en Microsoft SQL-servers standardinstans på standardporten; 1433. Stödjer enbart krypterad anslutning.
ini
ConnectServerType=SQLServerEnc
ConnectDatabaseName={dbServer}:{dbName}Exempel
ini
ConnectServerType=SQLServerEnc
ConnectDatabaseName=sqlserver.company.com:flexiteAnslutning till specifik instans
Anslut till en specifik namngiven instans på en Microsoft SQL-server. Stödjer både krypterad och okrypterad anslutning, baserat på konfiguration av Microsoft SQL Server.
ini
ConnectServerType=SQLServer
ConnectDatabaseName={dbServer}\{dbInstance}:{dbName}Exempel
ini
ConnectServerType=SQLServer
ConnectDatabaseName=sqlserver.company.com\dbinstance:flexiteKrypterad anslutning till specifik instans
Anslut till en specifik namngiven instans på en Microsoft SQL-server. Stödjer enbart krypterad anslutning.
ini
ConnectServerType=SQLServerEnc
ConnectDatabaseName={dbServer}\{dbInstance}:{dbName}Exempel
ini
ConnectServerType=SQLServerEnc
ConnectDatabaseName=sqlserver.company.com\dbinstance:flexiteAnslutning till specifik port
Anslut till en specifik port på en Microsoft SQL-server. Stödjer både krypterad och okrypterad anslutning, baserat på konfiguration av Microsoft SQL Server.
ini
ConnectServerType=SQLServer
ConnectDatabaseName={dbServer},{dbPort}:{dbName}Exempel
ini
ConnectServerType=SQLServer
ConnectDatabaseName=sqlserver.company.com,1234:flexiteKrypterad anslutning till specifik port
Anslut till en specifik port på en Microsoft SQL-server. Stödjer enbart krypterad anslutning.
ini
ConnectServerType=SQLServerEnc
ConnectDatabaseName={dbServer},{dbPort}:{dbName}Exempel
ini
ConnectServerType=SQLServerEnc
ConnectDatabaseName=sqlserver.company.com,1234:flexiteConnectServerType — Kryptering av databaskommunikation
flexiteProcessEngine stödjer både krypterad och okrypterad anslutning till databasservern. Detta innebär att det tillåts att falla tillbaka till en okrypterad anslutning i det fall både server och klient stödjer en sådan.
Med parametern ConnectServerType är det möjligt att ange huruvida flexiteProcessEngine ska tillåtas att falla tillbaka till okrypterad anslutning eller ej.
- SQLServer — Tillåt kommunikation över både okrypterat och krypterat protokoll. Konfiguration av SQL-server bestämmer i detta fall vilket protokoll som kommer att nyttjas. I det fall SQL-servern stödjer både krypterat och okrypterat protokoll kommer anslutningen att nyttja okrypterat. Standardvärde om parameter saknas.
- SQLServerEnc — Tillåt enbart kommunikation över krypterat protokoll.
Beteendematris
Dessa matriser detaljerar vilken effekt olika värden för parametern ConnectServerType har på anslutningen vid olika konfigurationer av SQL-server samt tillgänglighet av certifikat på applikationsservern.
SQL-server med tvingad kryptering, med certifikat
Denna matris visar effekten när SQL-servern har aktiverat tvingad kryptering (Force Encryption = Yes) samt är tilldelad ett giltigt certifikat.
| Parameter | Certifikat | Resultat |
|---|---|---|
ConnectServerType=SQLServer | Installerat i Windows Certificate Store | Krypterad anslutning |
ConnectServerType=SQLServer | Ej installerat | Ingen anslutning |
ConnectServerType=SQLServerEnc | Installerat i Windows Certificate Store | Krypterad anslutning |
ConnectServerType=SQLServerEnc | Ej installerat | Ingen anslutning |
SQL-server utan tvingad kryptering, utan certifikat
Denna matris visar effekten när SQL-servern har inaktiverat tvingad kryptering (Force Encryption = No) och inte tilldelats något certifikat. I detta scenario nyttjar SQL-servern ett egensignerat certifikat som vi förutsätter inte är installerat i Windows Certificate Store på applikationsservern.
| Parameter | Certifikat | Resultat |
|---|---|---|
ConnectServerType=SQLServer | Ej installerat | Okrypterad anslutning |
ConnectServerType=SQLServerEnc | Ej installerat | Ingen anslutning |
SQL-server utan tvingad kryptering, med certifikat
Denna matris visar effekten när SQL-servern har inaktiverat tvingad kryptering (Force Encryption = No) samt är tilldelad ett giltigt certifikat.
| Parameter | Certifikat | Resultat |
|---|---|---|
ConnectServerType=SQLServer | Installerat i Windows Certificate Store | Okrypterad anslutning |
ConnectServerType=SQLServer | Ej installerat | Okrypterad anslutning |
ConnectServerType=SQLServerEnc | Installerat i Windows Certificate Store | Krypterad anslutning |
ConnectServerType=SQLServerEnc | Ej installerat | Ingen anslutning |
Tjänster
Dessa parametrar anger vilka tjänster som ska vara aktiva på aktuell flexiteProcessEngine för den aktuella databasen.
| Parameter | Beskrivning / Värde |
|---|---|
OnHoldSvc | Aktivera/Inaktivera tjänsten Onhold på aktuell flexiteProcessEngine.
|
AlarmSvc | Aktivera/Inaktivera tjänsten Alarm på aktuell flexiteProcessEngine.
|
StatisticsSvc | Aktivera/Inaktivera tjänsten Statistik på aktuell flexiteProcessEngine.
|
DBLinkSvc | Aktivera/Inaktivera tjänsten flexiteDB-link på aktuell flexiteProcessEngine.
|
LeadTimesSvc | Aktivera/Inaktivera tjänsten Ledtider på aktuell flexiteProcessEngine.
|
SubstituteSvc | Aktivera/Inaktivera tjänsten Ersättare på aktuell flexiteProcessEngine.
|
MailSvc | Aktivera/Inaktivera tjänsten E-post på aktuell flexiteProcessEngine.
|
Loggning
Dessa parametrar anger hur aktuell flexiteProcessEngine ska arbeta med databasspecifika loggar, både i databas och i filer på disk.
För information om konfiguration av export och radering av loggar, se kapitel Loggning — Radering och export.
| Parameter | Beskrivning / Värde |
|---|---|
ExportUsersSessionsLog | Aktivera/Inaktivera export av loggar för användarsessioner till fil på aktuell flexiteProcessEngine, i enlighet med konfiguration i flexiteCLIENT.
|
UsersSessionsLogs | Relativ sökväg för exporterade loggar för användarsessioner. Installationskatalogen för flexiteProcessEngine används som rot. Standard om värde saknas: |
ExportAuthorizationChangesLog | Aktivera/Inaktivera export av loggar för ändringar i rättighetsgrupper till fil på aktuell flexiteProcessEngine
|
AuthorizationChangesLogs | Relativ sökväg för exporterade loggar för ändringar i rättighetsgrupper. Installationskatalogen för flexiteProcessEngine används som rot. Standard om värde saknas: |
ExportSearchesLog | Aktivera/Inaktivera export av loggar för sökningar till fil på aktuell flexiteProcessEngine, i enlighet med konfiguration i flexiteCLIENT.
|
SearchesLogs | Relativ sökväg för exporterade loggar för sökningar. Installationskatalogen för flexiteProcessEngine används som rot. Standard om värde saknas: |
ExportInstancesLog | Aktivera/Inaktivera export av loggar för registreringar till fil på aktuell flexiteProcessEngine, i enlighet med konfiguration i flexiteCLIENT.
|
InstancesLogs | Relativ sökväg för exporterade loggar för registreringar. Installationskatalogen för flexiteProcessEngine används som rot. Standard om värde saknas: |
ExportProcessChangesLog | Aktivera/Inaktivera export av loggar för förändringar i process och organisation till fil på aktuell flexiteProcessEngine, i enlighet med konfiguration i flexiteCLIENT.
|
ProcessChangesLogs | Relativ sökväg för exporterade loggar för förändringar i process och organisation. Installationskatalogen för flexiteProcessEngine används som rot. Standard om värde saknas: |
ExportReplaceDataLog | Aktivera/Inaktivera export av loggar för gallring till fil på aktuell flexiteProcessEngine, i enlighet med konfiguration i flexiteCLIENT.
|
ReplaceDataTaskChangesLogs | Relativ sökväg för exporterade loggar för gallring. Installationskatalogen för flexiteProcessEngine används som rot. Standard om värde saknas: |
ExportImpUsersLog | Aktivera/Inaktivera export av loggar för flexiteDB-link användar- och objektimport till fil på aktuell flexiteProcessEngine, i enlighet med konfiguration i flexiteCLIENT.
|
ImportUsersLogs | Relativ sökväg för exporterade loggar för flexiteDB-link användar- och objektimport. Installationskatalogen för flexiteProcessEngine används som rot. Standard om värde saknas: |
ExportUserAccountChanges | Aktivera/Inaktivera export av loggar för förändringar av användarkonton till fil på aktuell flexiteProcessEngine, i enlighet med konfiguration i flexiteCLIENT.
|
UserAccountChangesLogs | Relativ sökväg för exporterade loggar för förändringar av användarkonton. Installationskatalogen för flexiteProcessEngine används som rot. Standard om värde saknas: |
ExportManualExport | Aktivera/Inaktivera export av loggar för manuell logg-export till fil på aktuell flexiteProcessEngine, i enlighet med konfiguration i flexiteCLIENT.
|
ManualExportLogs | Relativ sökväg för exporterade loggar för manuell logg-export. Installationskatalogen för flexiteProcessEngine används som rot. Standard om värde saknas: |
ExportEmailsLog | Aktivera/Inaktivera export av loggar för e-postmeddelanden till fil på aktuell flexiteProcessEngine, i enlighet med konfiguration i flexiteCLIENT.
|
Emails | Relativ sökväg för exporterade loggar för e-postmeddelanden. Installationskatalogen för flexiteProcessEngine används som rot. Standard om värde saknas: |
DeleteLogsChunkSize | Anger hur radering av loggar i databasen ska hanteras av aktuell flexiteProcessEngine. Möjliga värden är:
Standard om värde saknas: |
Tjänster — Tidsintervall för återförsök
I det fall en systemtjänst av någon anledning inte kan utföra sitt arbete vid schemalagd tidpunkt kommer tjänsten att försöka på nytt så snart det är möjligt. Som standard utförs dessa återförsök tills dess att tjänsten lyckas slutföra sin uppgift.
Det är möjligt att per systemtjänst ange en begränsning i form av ett tidsspann för denna typ av återförsök i flexiteProcessEngine.ini.
| Parameter | Beskrivning |
|---|---|
ScheduledServiceTimeout | Tidsintervall i timmar, räknat från schemalagd tidpunkt, under vilket tjänsten tillåts att göra återförsök.
|
Exempel
ini
[AlarmSvc]
ScheduledServiceTimeout=2
[OnHoldSvc]
ScheduledServiceTimeout=2
[StatisticsSvc]
ScheduledServiceTimeout=0
[DBLinkSvc]
ScheduledServiceTimeout=0
[LeadTimesSvc]
ScheduledServiceTimeout=0
[SubstituteSvc]
ScheduledServiceTimeout=2
[MailSvc]
ScheduledServiceTimeout=0I exemplet ovan tillåts tjänsterna Alarm (AlarmSvc), OnHold (OnHoldSvc) och Ersättare (SubstituteSvc) utföra återförsök inom 2 timmar från ursprunglig schemalagd tidpunkt (ScheduledServiceTimeout=2). För övriga tjänster anges ingen begränsning av tidsintervall för återförsök (ScheduledServiceTimeout=0).
[DBLinkSvc]
Denna sektion innehåller konfiguration av tjänsten flexiteDB-link (DBLinkSvc).
| Parameter | Beskrivning |
|---|---|
Web. | Tillvägagångssätt när flexiteDB-link nyttjas för att kvittera en registrering på en aktivitet.
För mer information, se avsnitt Web.Responsibility.Calculation. |
Web.Responsibility.Calculation
Anger tillvägagångssätt när flexiteDB-link nyttjas för att kvittera en registrering på en aktivitet.
Web.Responsibility.Calculation=0
Standardkonfiguration.
- flexiteDB-link hämtar ärendenummer från aktuell XML.
- flexiteDB-link frågar flexiteWEB Web Service om en registrering med det aktuella ärendenumret är tillgängligt för kvittering på en aktivitet där flexiteDB-link bemannar ansvarig roll.
- Om ärendenumret är tillgängligt; flexiteDB-link kvitterar registreringen med det matchande ärendenumret.
Web.Responsibility.Calculation=1
Äldre tillvägagångssätt som kan aktiveras i kompatibilitetssyfte.
- flexiteDB-link frågar flexiteWEB Web Service efter en lista över samtliga ärendenummer från registreringar som är tillgängliga för kvittering på en aktivitet där flexiteDB-link bemannar ansvarig roll.
- flexiteDB-link söker efter de returnerade ärendenumren bland samtliga tillgängliga XML.
- För varje matchande XML; flexiteDB-link kvitterar matchande registrering.
flexiteProcessEngine.exe tilläggskommandon
Filen flexiteProcessEngine.exe kan köras manuellt tillsammans med tilläggskommandon, så kallade command line arguments, för att utföra specifika uppgifter.
| Parameter | Beskrivning |
|---|---|
/extdatadllupdate | Detta kommando har enbart effekt om aktuell flexiteProcessEngine är konfigurerad att köra OnHold-tjänsten, och därmed agerar huvudserver. Uppdatera databasen med tillgängliga ExtData DLL-filer samt tillhörande konfigurationsfiler för aktuell flexiteProcessEngine. Samma funktion utförs av flexiteProcessEngine huvudserver vid varje uppstart samt återkommande varje timme. Detta kommando kan exempelvis nyttjas vid implementering av nya eller uppdaterade ExtData-integrationer i ett scenario med flera applikationsservrar för att tvinga synkronisering mellan servrarna. |
/main | Registrera aktuell server för samtliga aktiva tjänster enligt konfiguration i Det är starkt rekommenderat att stoppa tjänsten för aktuell flexiteProcessEngine innan detta kommando körs. Efter utfört kommando är det starkt rekommenderat att avsluta samtliga processer för aktuell flexiteProcessEngine innan tjänsten startas igen. |
/encrypt:{path_to_folder} (/db:{database id}) | Kryptera okrypterade XML-filer i en angiven katalog med aktuell krypteringsnyckel från systemet. I system med flera databaser måste även databas-ID anges. För information om funktionen, se avsnitt Kryptera XML-filer med flexiteProcessEngine. |
Best practice — Integrationsfiler
flexite levereras med en uppsättning standardintegrationer för flexiteDB-link och Extern Data. Filer för dessa är belägna i följande kataloger i en standardinstallation:
C:\tomcat\flexite\flexiteProcessEngine\DBLinkDataC:\tomcat\flexite\flexiteProcessEngine\ExtData
När någon av dessa integrationer ska nyttjas är det starkt rekommenderat att skapa en kopia på standardfilerna och därefter konfigurera och nyttja denna kopia för integrationen. På detta vis undviks möjligheten att aktiva, anpassade, integrationsfiler kan skrivas över av standardfiler vid en uppgradering eller hotfixpatchning.
flexiteWEB
customer.conf
customer.conf innehåller systemspecifika anpassningsmöjligheter för flexiteWEB.
Sökväg: {flexiteWEB}\WEB-INF\classes\settings\customer.conf.
Inställningar
| Parameter | Beskrivning / Värde |
|---|---|
Administration. | Anger hur aktuell, ej kvitterad information i en registrering ska hanteras vid duplicering av registreringen.
|
File. | Anger om aktuellt datum ska adderas till samtliga CSS-filnamn i serversvar som skickas till webbläsare. Detta kan motverka problem med korrupt cache i webbläsare. Bör användas i kombination med Notera att det enbart är i serversvaret som filerna får nytt namn, de faktiska filerna i webbapplikationen påverkas inte.
|
File. | Anger om aktuellt datum ska adderas till samtliga JavaScript-filnamn i serversvar som skickas till webbläsare. Detta kan motverka problem med korrupt cache i webbläsare. Bör användas i kombination med Notera att det enbart är i serversvaret som filerna får nytt namn, de faktiska filerna i webbapplikationen påverkas inte.
|
Login. | Anger den sträng som måste återfinnas i svaret från IdP för att användaren ska tillåtas inloggning via SAML. Formatet på strängen är Base64. Kan enbart användas i kombination med SAML. För mer information, se avsnitt Login.SAML.Response. |
Login. | Numeriskt ID för de rättighetsgrupper för vilka medlemmarna inte ska tillåtas logga in. Flera rättighetsgrupper separeras med komma ( Numeriskt ID för rättighetsgrupper återfinns i databasen i tabellen Kan enbart användas i kombination med För mer information, se avsnitt Login.SAML.Response. |
Login. | Den textsträng som utgör det meddelande som visas för de användare som inte tillåts logga in på grund av att de tillhör angivna rättighetsgrupper ( För mer information, se avsnitt Login.SAML.Response. |
Login. | Den textsträng som visas på knappen för att försöka autentisering på nytt. Denna knapp visas tillsammans med meddelandet från För mer information, se avsnitt Login.SAML.Response. |
Map. | Alias för URL-parameter för att ange komponentvärde. Alias anges i följande format:
Flera alias separeras med mellanslag. För mer information, se avsnitt Map.Url.Parameters. |
URL. | Numeriskt attribut-ID för datumkomponenter för vilka standardvärdet ska sparas till utkast när URL SSO används. Flera ID:n separeras med komma ( Som standard uppdateras standardvärdet i datumkomponenter varje gång utkastet öppnas. För mer information, se avsnitt URL.SSO.Save.Draft.Default.Value.Components. |
Login.SAML.Response
Det är möjligt att utöka funktionaliteten av SAML baserat på innehåll i det svar som flexiteWEB mottar från Identity Provider (IdP). Funktionaliteten i dessa parametrar förutsätter att systemet konfigurerats att nyttja SAML för autentisering av användare; se kapitel Single Sign-On — SAML.
Grundläggande funktionalitet
Vid autentisering via SAML kontrollerar flexite det svar som skickas från IdP genom att söka efter den sträng som angivits för Login.SAML.Response.MustContain. Därefter utförs följande aktioner:
- Om autentiseringen lyckas och svaret från IdP innehåller sträng från
Login.SAML.Response.MustContain:- Logga in i flexiteWEB.
- Om autentiseringen lyckas och svaret från IdP INTE innehåller sträng från
Login.SAML.Response.MustContain:- Om aktuellt användarkonto är medlem någon av de angivna rättighetsgrupperna (
Login.SAML.Response.NotContains.Groups):- Blockera inloggning i flexiteWEB samt visa meddelande och knapp för att försöka autentisering på nytt (
Login.SAML.Response.NotContains.MessagerespektiveLogin.SAML.Response.NotContains.Retry). Vad som händer vid klick på knappen Retry beror på konfiguration av IdP.
- Blockera inloggning i flexiteWEB samt visa meddelande och knapp för att försöka autentisering på nytt (
- Om aktuellt användarkonto INTE är medlem i de angivna rättighetsgrupperna (
Login.SAML.Response.NotContains.Groups):- Logga in i flexiteWEB.
- Om aktuellt användarkonto är medlem någon av de angivna rättighetsgrupperna (
Map.Url.Parameters
Det är möjligt att via URL-parametrar ange värden för en eller flera komponenter som befinner sig på formulär i den aktuella aktiviteten. Denna funktionalitet stöds av E-services för registrering samt ansvarslänkar.
För mer information om URL-parametrar, se guiden för att Skräddarsy länkar med URL-parametrar.
Med parametern Map.Url.Parameters i customer.conf är det möjligt att ange och nyttja egna alias för denna funktionalitet.
Standardformat
Som standard har URL-parametern för att ange en komponent och dess värde följande format:
attr{attribut-id}={värde}- attribut-id — Det unika attribut-id:t för den komponent som värdet ska anges för. Detta attribut-id går att utläsa i Formulärdesignern i flexiteCLIENT.
- värde — Det värde som ska skrivas till komponenten.
Exempel
I detta exempel vill vi ange värden för två komponenter i vår aktivitet:
- Rullgardin – Attribut-ID: 12345 – Det befintliga värdet Avdelning 123 ska väljas när formuläret laddas.
- Kryssruta – Attribut-ID: 67890 – Kryssrutan ska aktiveras när formuläret laddas.
Standard-URL:en för vår E-service, utan parametrar för komponenter och värden, ser ut på följande vis:
https://flexite.company.com/flexite/jsp/service.jsp?s=ABCD1234
Med parametrar för komponenter och värden tillagda i slutet av URL:en ser den ut på följande vis:
https://flexite.company.com/flexite/jsp/service.jsp?s=ABCD1234&attr12345=Avdelning 123&attr67890=Yes
- attr12345=Avdelning 123 – Värdet Avdelning 123 väljs i vår rullgardinskomponent.
- attr67890=Yes – Vår kryssrutekomponent aktiveras.
Ange och nyttja alias
Med parametern Map.Url.Parameters kan vi ange egna alias för ett eller flera attribut-id:n; attr{attribut-id}. Detta görs i följande format:
conf
Map.Url.Parameters={alias}-{attribut-id}Flera alias separeras med mellanslag:
conf
Map.Url.Parameters={alias.01}-{attribut-id.01} {alias.02}-{attribut-id.02}Exempel
I detta exempel vill vi ange värden för två komponenter i vår aktivitet:
- Rullgardin – Attribut-ID: 12345 – Det befintliga värdet Avdelning 123 ska väljas när formuläret laddas.
- Kryssruta – Attribut-ID: 67890 – Kryssrutan ska aktiveras när formuläret laddas.
Istället för att använda komponenternas ID:n i URL:en vill vi nyttja egna alias. Detta uppnår vi genom att konfigurera parametern Map.Url.Parameters i customer.conf:
conf
Map.Url.Parameters=avdelning-attr12345 kryss-attr67890Med alias för komponenter och deras värden tillagda i slutet av URL:en ser den ut på följande vis:
https://flexite.company.com/flexite/jsp/service.jsp?s=ABCD1234&avdelning=Avdelning 123&kryss=Yes- avdelning=Avdelning 123 – Värdet Avdelning 123 väljs i vår rullgardinskomponent.
- kryss=Yes – Vår kryssrutekomponent aktiveras.
URL.SSO.Save.Draft.Default.Value.Components
Utkast i flexiteWEB kan användas för att fortsätta ett påbörjat arbete vid ett senare tillfälle. För datumkomponenten uppdateras standardvärdet varje gång ett utkast öppnas.
Med parametern URL.SSO.Save.Draft.Default.Value.Components är det möjligt att ange specifika attribut-ID för datumkomponenter för vilka standardvärdet inte ska uppdateras när utkast används tillsammans med URL SSO (Single Sign-On via länk). För dessa komponenter kommer standardvärdet enbart sättas första gången formuläret laddas.
Notera att detta inte påverkar utkast utanför URL SSO.
Exempel
I detta exempel vill vi att standardvärdet för datumkomponenterna med attribut-ID 10001 respektive 10002 inte ska uppdateras när utkast används tillsammans med URL SSO:
conf
URL.SSO.Save.Draft.Default.Value.Components=10001,10002ext-verification.conf
ext-verification.conf innehåller inställningar för E-ID för flexiteWEB.
Sökväg: {flexiteWEB}\WEB-INF\classes\integration\eid\ext-verification.conf.
E-ID kräver konto och nycklar från Svensk e-identitet:
- En nyckel för Svensk e-identitets API; GrandID.
- En uppsättning nycklar för varje leverantör som ska nyttjas.
För information om konfiguration av E-ID, se kapitel E-ID för identifiering och signering.
Exempel
Exempel med BankID och BankIDPhone som leverantörer:
conf
### General Settings
active.service.provider=GrandID
Providers=BankID BankIDPhone Telia Google eIDAS FrejaEID
### GrandID
GrandID.serviceURL=https://client.grandid.com/json1.1/
# API KEY
GrandID.apiKey=ABCDEFGH1234567890
# BANKID
BankID.Version=30
GrandID.BankID.auth=ABCDEFGH1234567890
GrandID.BankID.sign=ABCDEFGH1234567890
# BANKIDPHONE
GrandID.BankIDPhone.auth=ABCDEFGH1234567890
# TELIA
GrandID.Telia.auth=
GrandID.Telia.sign=
# GOOGLE
GrandID.Google.auth=
# EIDAS
GrandID.eIDAS.auth=
# FREJAEID
GrandID.FrejaEID.auth=
GrandID.FrejaEID.sign=Inställningar
| Parameter | Beskrivning / Värde |
|---|---|
active.service.provider | Den tjänsteleverantör som ska nyttjas för E-ID. Det enda värde som stöds är standardvärdet |
Providers | Anger de identitetsleverantörer som ska nyttjas. Flera leverantörer separeras med mellanslag. Tillgängliga val är API-nycklar måste anges för samtliga Providers som ska nyttjas. |
GrandID.serviceURL | URL för GrandID API. |
GrandID.apiKey | API-nyckel för GrandID. |
BankID.Version | API-version för BankID. |
GrandID.BankID.auth | API-nyckel för BankID, autentisering. |
GrandID.BankID.sign | API-nyckel för BankID, signering. |
GrandID.BankIDPhone.auth | API-nyckel för BankID Phone. |
GrandID.Telia.auth | API-nyckel för Telia, autentisering. |
GrandID.Telia.sign | API-nyckel för Telia, signering. |
GrandID.Google.auth | API-nyckel för Google. |
GrandID.eIDAS.auth | API-nyckel för eIDAS. |
GrandID.FrejaEID.auth | API-nyckel för FrejaEID, autentisering. |
GrandID.FrejaEID.sign | API-nyckel för FrejaEID, signering. |
flexite.conf
flexite.conf är den huvudsakliga konfigurationsfilen för flexiteWEB.
Sökväg: {flexiteWEB}\WEB-INF\classes\settings\flexite.conf.
Filnamnet måste stämma överens med det projektnamn (ProjectID) som är angivet i {flexiteWEB}\index.jsp. I en standardinstallation är detta FLEXITE, vilket ger filnamnet flexite.conf.
Exempel
conf
######## One time settings to be made ONLY at first installation or moving of system
### Tomcat settings
base-dir=/flexite/
mobile-dir=/flexite/m/
log-file=c:/tomcat/flexite/log/flexite.log
external-verification-conf=/integration/eid/ext-verification.conf
### Database settings
db-server-type=SQLServer
db-service-name=sqlserver.company.com:flexite
db-user-name=dbUserName
db-user-password=ABCDEFGH12345678
db-server-url=jdbc:sqlserver://sqlserver.company.com:1433;databaseName=flexite
######## Settings only to be touched after specific decision from Flexite AB
theme-dir=/flexite/theme/modern/
flexite8-modern-style=0
mobile-implementation-level=2
mobile-enable=1
mobile-myresp-enable=1
allow-survey=0
search-calc-rows=30
login-allow-empty-password=0
auto-login-expire-days=10
log-query=0
######## Customer specific settings. Decision is taken by Flexite AB technician
db-server-max-connections=200
db-select-query-timeout=120
######## Customer specific settings. Must check at update how customer wants it.
login-type-manual=FLEXITE
login-type-auto=COOKIE
login-welcome-page=1
session-timeout=60
instance-lock-timeout=5
######## Test database specific settings. Must be changed if system is a test system.
# General automatic e-mail generation (Sending is configured in mailservice)
# 0 - do not generate email (Should be always used for test database)
# 1 - generate email
send-email=1Tomcat settings
Dessa parametrar anger generella sökvägar för webbapplikationen.
| Parameter | Beskrivning / Värde |
|---|---|
base-dir | Relativ sökväg till webbapplikationen flexiteWEB, med Tomcat's katalog för webbapplikationer som utgångspunkt. Standardvärde: |
mobile-dir | Relativ sökväg till mobila gränssnittet för webbapplikationen flexiteWEB (även kallat SmoothForms), med Tomcat's katalog för webbapplikationer som utgångspunkt. Standardvärde: |
log-file | Absolut sökväg för loggfil för inloggningshändelser samt kvittering av ärenden i flexiteWEB. Standardvärde: |
external-verification-conf | Relativ sökväg för konfigurationsfil för eID, med rotkatalogen i flexiteWEB som utgångspunkt. Standardvärde: |
Database connection
Dessa parametrar anger hur flexiteWEB ska ansluta till databasen.
| Parameter | Beskrivning / Värde |
|---|---|
db-server-type | Typ av databasserver. Det enda värde som stöds är standardvärdet |
db-service-name | Den sökväg för databasen som nyttjas av flexiteProcessEngine. Nyttjas vid kommunikation med flexiteProcessEngine och underliggande tjänster. Måste matcha den sökväg som angivits för flexiteProcessEngine med parametern Se avsnitt db-service-name. |
db-user-name | Användarnamn för konto för databasanslutning. |
db-user-password | Lösenord i krypterat format för konto för databasanslutning. Lösenord i krypterat format kan hämtas från konfigurationsfilerna för applikationerna flexiteCLIENT ( |
db-server-url | Sökväg för databasen för flexiteWEB. Se avsnitt db-server-url. |
db-select-query-timeout | Maximal tid i minuter som SQL queries av typen SELECT ska tillåtas köra innan de avbryts.
Standardvärde: |
db-service-name
Parameter som anger den sökväg för databasen som är konfigurerad för flexiteProcessEngine. Denna sökväg nyttjas vid kommunikation med flexiteProcessEngine och underliggande tjänster.
Strängen måste matcha den sökväg som angivits för flexiteProcessEngine med parametern ConnectDatabaseName i flexiteProcessEngine.ini (se avsnitt [Database.X]).
Anslutning till standardinstans och standardport
Anslut till en Microsoft SQL-servers standardinstans på standardporten; 1433. Stödjer både krypterad och okrypterad anslutning, baserat på konfiguration av Microsoft SQL Server.
conf
db-service-name={dbServer}:{dbName}Exempel
conf
db-service-name=sqlserver.company.com:flexiteAnslutning till specifik instans
Anslut till en specifik namngiven instans på en Microsoft SQL-server. Stödjer både krypterad och okrypterad anslutning, baserat på konfiguration av Microsoft SQL Server.
conf
db-service-name={dbServer}\{dbInstance}:{dbName}Exempel
conf
db-service-name=sqlserver.company.com\dbinstance:flexiteAnslutning till specifik port
Anslut till en specifik port på en Microsoft SQL-server. Stödjer både krypterad och okrypterad anslutning, baserat på konfiguration av Microsoft SQL Server.
conf
db-service-name={dbServer},{dbPort}:{dbName}Exempel
conf
db-service-name=sqlserver.company.com,1234:flexitedb-server-url
Parameter som anger sökväg för databasen för flexiteWEB. Kan anges i följande format:
Anslutning till standardinstans och standardport
Anslut till en Microsoft SQL-servers standardinstans på standardporten; 1433. Stödjer både krypterad och okrypterad anslutning, baserat på konfiguration av Microsoft SQL Server.
conf
jdbc:sqlserver://{dbServer};databaseName={dbName}Exempel
conf
jdbc:sqlserver://sqlserver.company.com;databasename=flexiteKrypterad anslutning till standardinstans och standardport
Anslut till en Microsoft SQL-servers standardinstans på standardporten; 1433. Stödjer enbart krypterad anslutning.
conf
jdbc:sqlserver://{dbServer};databaseName={dbName};encrypt=trueExempel
conf
jdbc:sqlserver://sqlserver.company.com;databasename=flexite;encrypt=trueAnslutning till specifik instans
Anslut till en specifik namngiven instans på en Microsoft SQL-server. Stödjer både krypterad och okrypterad anslutning, baserat på konfiguration av Microsoft SQL Server.
conf
jdbc:sqlserver://{dbServer};instanceName={dbInstance};databaseName={dbName}Exempel
conf
jdbc:sqlserver://sqlserver.company.com;instanceName=dbinstance;databasename=flexiteKrypterad anslutning till specifik instans
Anslut till en specifik namngiven instans på en Microsoft SQL-server. Stödjer enbart krypterad anslutning.
conf
jdbc:sqlserver://{dbServer};instanceName={dbInstance};databaseName={dbName};encrypt=trueExempel
conf
jdbc:sqlserver://sqlserver.company.com;instanceName=dbinstance;databasename=flexite;encrypt=trueAnslutning till specifik port
Anslut till en specifik port på en Microsoft SQL-server. Stödjer både krypterad och okrypterad anslutning, baserat på konfiguration av Microsoft SQL Server.
conf
jdbc:sqlserver://{dbServer}:{dbPort};databaseName={dbName}Exempel
conf
jdbc:sqlserver://sqlserver.company.com:1234;databasename=flexiteKrypterad anslutning till specifik port
Anslut till en specifik port på en Microsoft SQL-server. Stödjer enbart krypterad anslutning.
conf
jdbc:sqlserver://{dbServer}:{dbPort};databaseName={dbName};encrypt=trueExempel
conf
jdbc:sqlserver://sqlserver.company.com:1234;databasename=flexite;encrypt=trueencrypt — kryptering av databaskommunikation
flexiteWEB är konstruerat att som standard stödja både krypterad och okrypterad anslutning till databasservern. Detta innebär att det tillåts att falla tillbaka till en okrypterad anslutning i det fall både server och klient stödjer en sådan.
Med parametern encrypt är det möjligt att ange huruvida flexiteWEB ska tillåtas att falla tillbaka till okrypterad anslutning eller ej.
- false — Tillåt kommunikation över både okrypterat och krypterat protokoll. Konfiguration av SQL-server bestämmer i detta fall vilket protokoll som kommer att nyttjas. I det fall SQL-servern stödjer både krypterat och okrypterat protokoll kommer anslutningen att nyttja okrypterat. Standardvärde om parameter saknas.
- true — Tillåt enbart kommunikation över krypterat protokoll.
Beteende med standardkonfiguration
Om inget annat anges i konfigurationsfilen används parametern encrypt=false
Med en SQL-server som inte kräver kryptering medför detta att en okrypterad anslutning upprättas.
Med en SQL-server som kräver kryptering medför detta att en krypterad anslutning upprättas om CA-certifikatet för det certifikat som nyttjas av SQL-servern finns installerat i Javas keystore cacerts. Om certifikatet inte finns installerat kan ingen anslutning upprättas.
Beteendematris
Dessa matriser detaljerar vilken effekt olika värden för parametern encrypt har på anslutningen vid olika konfigurationer av SQL-servern samt tillgänglighet av certifikat på applikationsservern.
SQL-server med tvingad kryptering, med certifikat
Denna matris visar effekten när SQL-servern har aktiverat tvingad kryptering (Force Encryption = Yes) samt är tilldelad ett giltigt certifikat.
| Parameter | Certifikat | Resultat |
|---|---|---|
encrypt=false | Installerat i Java keystore | Krypterad anslutning |
encrypt=false | Ej installerat | Ingen anslutning |
encrypt=true | Installerat i Java keystore | Krypterad anslutning |
encrypt=true | Ej installerat | Ingen anslutning |
SQL-server utan tvingad kryptering, utan certifikat
Denna matris visar effekten när SQL-servern har inaktiverat tvingad kryptering (Force Encryption = No) och inte tilldelats något certifikat. I detta scenario nyttjar SQL-servern ett egensignerat certifikat som vi förutsätter inte är installerat i Java keystore på applikationsservern.
| Parameter | Certifikat | Resultat |
|---|---|---|
encrypt=false | Ej installerat | Okrypterad anslutning |
encrypt=true | Ej installerat | Ingen anslutning |
SQL-server utan tvingad kryptering, med certifikat
Denna matris visar effekten när SQL-servern har inaktiverat tvingad kryptering (Force Encryption = No) samt är tilldelad ett giltigt certifikat.
| Parameter | Certifikat | Resultat |
|---|---|---|
encrypt=false | Installerat i Java keystore | Okrypterad anslutning |
encrypt=false | Ej installerat | Okrypterad anslutning |
encrypt=true | Installerat i Java keystore | Krypterad anslutning |
encrypt=true | Ej installerat | Ingen anslutning |
Inställningar för webbapplikation
| Parameter | Beskrivning / Värde |
|---|---|
login-type-manual | Anger vilka manuella inloggningsmetoder som ska finnas tillgängliga i flexiteWEB. Flera inloggningsmetoder kommasepareras och hanteras i seriell ordning. Tillgängliga alternativ:
|
login-type-auto | Anger vilken automatisk inloggningsmetod som ska finnas tillgänglig i flexiteWEB. Tillgängliga alternativ:
|
login-welcome-page | Anger hur välkomstsida ska presenteras när
För mer information, se avsnitt login-welcome-page. |
session-timeout | Gränsvärde i minuter för tillåten passiv tid i flexiteWEB innan användarsessionen avslutas och användaren loggas ut. Används i kombination med parametern Standardvärde: För mer information, se avsnitt Sessionshantering och timeout. |
instance-lock-timeout | Gränsvärde för tillåten passiv tid vid arbete i formulär i flexiteWEB innan en registrering kan övertas av Övervakare. Tid anges i minuter. Standardvärde: För mer information, se avsnitt Sessionshantering och timeout. |
upload-temp-file-threshold | Gränsvärde i Bytes för lagring av temporära filer på disk istället för RAM vid filuppladdning. Standardvärdet motsvarar cirka 2 GB, vilket även är maxvärdet ( Dold som standard och bör enbart användas i utredningssyfte. |
login-welcome-page
Med parametern login-welcome-page är det möjligt att ange hur en välkomstsida ska visas när login-type-manual används i kombination med login-type-auto.
Tillgängliga parametervärden:
- login-welcome-page=0 — Visa inte välkomstsida.
- login-welcome-page=1 — Visa välkomstsida där användaren måste välja mellan automatisk eller manuell inloggning.
- login-welcome-page=2 — Visa välkomstsida där automatisk inloggning hanteras som standard men där användaren ges möjlighet att via en länk gå vidare till manuell inloggning.
Undantag
Denna välkomstsida är inte kompatibel med login-type-auto=cookie, då den inte visas oavsett konfiguration.
login-welcome-page=0
Välkomstsida visas ej.
Angivna inloggningstyper hanteras på följande vis:
login-type-autoOm inget matchande användarkonto hittas, gå till 2.- Inloggningsruta visas och
login-type-manualhanteras i seriell ordning. Om inget matchande användarkonto hittas för första valet, fortsätt med nästa val.
Undantag
login-type-auto=SAML i kombination med login-welcome-page=0 resulterar i att login-type-manual ej hanteras. Det är därmed starkt rekommenderat att undvika denna kombination.
login-welcome-page=1
Visa välkomstsida där användaren måste välja mellan automatisk eller manuell inloggning.

Angivna inloggningstyper hanteras på följande vis:
- Användare väljer automatisk inloggning:
login-type-autoOm inget matchande användarkonto hittas, gå till 2.- Inloggningsruta visas och
login-type-manualhanteras i seriell ordning. Om inget matchande användarkonto hittas för första valet, fortsätt med nästa val.
- Användare väljer manuell inloggning:
- Inloggningsruta visas och
login-type-manualhanteras i seriell ordning.
- Inloggningsruta visas och
Undantag
login-type-auto=SAML resulterar i att login-type-manual ej hanteras när användaren väljer automatisk inloggning.
login-welcome-page=2
Visa välkomstsida där automatisk inloggning hanteras som standard men där användaren ges möjlighet att via en länk gå vidare till manuell inloggning.
Denna funktion är primärt framtagen för login-type-auto=SAML men kan även fungera tillsammans med login-type-auto=CUSTOMER, beroende på den specifika lösningen.
Detta val stöds inte av login-type-auto=WINDOWS, där funktionaliteten istället kommer att behandlas som login-welcome-page=0.
Med SAML är det möjligt att konfigurera flexite att hantera autentiseringen i samma fönster som flexiteWEB eller i en popup. Den slutgiltiga funktionaliteten skiljer sig beroende på denna konfiguration.
SAML i samma fönster som flexiteWEB
Angivna inloggningstyper hanteras på följande vis:
login-type-auto. Om inget matchande användarkonto hittas, gå till 2.- Varningsmeddelande visas med länk till manuell inloggning. Vid klick på länk, gå till 3.
- Inloggningsruta visas och
login-type-manualhanteras i seriell ordning. Om inget matchande användarkonto hittas för första valet, fortsätt med nästa val.
SAML i popup
Angivna inloggningstyper hanteras på följande vis:
login-type-auto. På samma sida visas en länk till manuell inloggning. Vid klick på länk, gå till 2.- Inloggningsruta visas och
login-type-manualhanteras i seriell ordning. Om inget matchande användarkonto hittas för första valet, fortsätt med nästa val.
Sessionshantering och timeout
Dessa parametrar kontrollerar idle timeout i flexiteWEB för användarsessioner samt låsning av registreringar vid arbete i formulär.
session-timeout
Parametern session-timeout kontrollerar idle timeout för sessioner mellan klienter och webbapplikationen flexiteWEB. Parametern anger i hur många minuter från senaste interaktion med flexiteWEB, inom en och samma webbläsarflik, som sessionen ska hållas öppen.
Efter att tiden passerat avslutas sessionen mellan klienten och webbapplikationen och användaren loggas ut. Eventuell information som angivits i sessionen men inte sparats går förlorad.
I det fall webbläsarfliken stängs ner utan att användaren först loggar ut, eller kommunikationen mellan klient och server avbryts på grund av annan orsak, överlåts avslutande av sessionen till webbservern Apache Tomcat. Som standard avslutas sessionen av Tomcat efter 5 minuter.
För konfiguration av sessionshantering i Apache Tomcat, se avsnitt Sessionshantering.
Undantag
För E-services av typen registrering (E-service för registrering, Standard E-service för applikationen Registrering) som publiceras inuti en IFRAME på en webbsida hålls sessionen i flexiteWEB vid liv tills dess att den manuellt avslutas av användaren eller webbapplikationen stoppas.
Detta betyder att dessa typer av sessioner inte har någon idle timeout.
instance-lock-timeout
En användare som bemannar en roll av typen övervakare har möjligheten att överta ansvaret för en registrering som redan har accepterats av en användare. Detta inkluderar registreringar där arbete har påbörjats.
För att förebygga att en övervakare övertar ansvaret för en registrering där den ansvarige för närvarande arbetar i formuläret låser flexite ansvaret för registreringar medan arbete pågår.
Parametern instance-lock-timeout anger i hur många minuter från senaste interaktion med formulär som ansvaret för registreringen låses under tiden formuläret är öppet. Interaktioner innefattar arbete med komponenter på formulär samt navigation mellan formulär.
Inställningar för flexitePortal
Dessa parametrar möjliggör utökad funktionalitet för integration med den separata webbapplikationen flexitePortal.
flexitePortal är en webbapplikation som är avsedd att användas som en webbportal där medborgare kan logga in med E-ID och hantera sina personliga ärenden i flexite. Applikationen har ingen egen databasanslutning, utan kommunicerar med flexite via flexiteWEBs API.
| Parameter | Beskrivning / Värde |
|---|---|
portal-initialize-hosts | URL för de flexitePortal-webbapplikationer som ska kunna kringgå krav på E-ID vid start av flexite E-service. Flera URL separeras med mellanslag Notera att dessa flexitePortal-installationer måste inneha en nyckel ( |
portal-initialize-secret-key | Nyckel för att kringgå krav på E-ID vid start av flexite E-service. Istället nyttjas uppgifter från aktuell användare (Identitet) i flexitePortal. Måste matcha nyckeln som angivits i flexitePortal ( |
portal-initialize
I flexitePortal skapas nya registreringar via publika E-services som hämtas från flexiteWEB API. I dessa E-services används komponenten Identitet för att knyta den individuelle medborgaren till registreringen.
Som standard kräver komponenten Identitet att medborgaren manuellt bekräftar sin identitet via BankID.
För att förenkla flödet för medborgaren är det möjligt att nyttja krav på E-ID vid öppnande av E-service tillsammans med portal-initialize-secret-key för att använda den redan autentiserade identiteten från aktuell session i flexitePortal. På detta vis behöver medborgaren själv inte manuellt identifiera sig igen för att knyta identiteten till registreringen.
Denna nyckel måste stämma överens med nyckeln som angivits för flexitePortal; parametern flexite-initialize-secret-key i flexitePortal.conf.
Parametern portal-initialize-hosts definierar vilka flexitePortal-installationer som tillåts kringgå E-ID på detta vis, förutsatt att de har nyckeln.
pool.conf
pool.conf är en systemkritisk konfigurationsfil för flexiteWEB.
Sökväg: {flexiteWEB}\WEB-INF\classes\settings\pool.conf.
Exempel
conf
######## Global installation parameters. Should be set for each project.
# JDBC drivers to use.
# Possible values: com.microsoft.sqlserver.jdbc.SQLServerDriver
# Possible values depend from JDBC driver and can be different from described if another drivers are used.
# Values can be used together separated by space.
drivers=com.microsoft.sqlserver.jdbc.SQLServerDriver
# Log file location.
# logfile=c:/tomcat/flexite/log/pool.log
logfile=c:/tomcat/flexite/logs/pool.log
########## Project specific parameters. Should be set for each project.
########## Project: FLEXITE
# Configuration file that contains additional project parameters.
# Default project name when using only one installation is FLEXITE
# FLEXITE.conf=flexite.conf
FLEXITE.conf=flexite.conf
# FLEXITETEST.conf=flexitetest.conf
# Enables auto compression of all logs every night at 00.00
log-compress=0Inställningar
| Parameter | Beskrivning / Värde |
|---|---|
drivers | Den drivrutin som ska nyttjas för databasanslutningar. Det enda värde som stöds är standardvärdet |
logfile | Absolut sökväg till loggfil för loggning av pool-hantering i flexiteWEB. |
{PROJECT}.conf={project}.conf | Anger konfigurationsfiler för aktuella projekt i flexiteWEB. I system där en enskild webbapplikation används för flera databaser (projekt) anges varje konfiguration på ny rad. Namn på projekt-filer anges i formatet Standardvärde: |
log-compress | Anger huruvida loggfiler för webbapplikationen ska komprimeras varje dygn klockan 00:00. De loggfiler som komprimeras är:
Varje fil komprimeras till en individuell ZIP-fil med samma namn som ursprungsfilen. |
saml.conf
saml.conf innehåller inställningar för SAML för flexiteWEB.
Sökväg: {flexiteWEB}\WEB-INF\classes\integration\saml\saml.conf.
För information om konfiguration av SAML, se kapitel Single Sign-On — SAML.
Exempel
conf
idp_metadata_file=/integration/saml/saml_idp.xml
idp_entity_id=https://idp.company.com:9443/
idp_user_attibute_name=urn:oid:2.4.8.128
fx_user_field_name=username
keystore_file=/integration/saml/saml.jks
keystore_password=keystore_password
sign_request=1
sign_cert_name=sign_certificate
sign_cert_password=sign_password
sign_assertion=1
encrypt_assertion=1
encrypt_cert_name=encrypt_certificate
encrypt_cert_password=encrypt_passwordInställningar
| Parameter | Beskrivning / Värde |
|---|---|
idp_metadata_file | Relativ sökväg till den metadata-fil som hämtats från Identity Provider. Använder katalogen |
idp_entity_id | ID för server som agerar Identity Provider. |
idp_user_attibute_name | Det attribut hos Identity Provider som innehåller användar-id. |
fx_user_field_name | Det attribut i flexite som användar-id från Identity Provider ska verifieras mot. Möjliga alternativ:
|
keystore_file | Relativ sökväg till keystore för SAML-certifikat. Använder katalogen |
keystore_password | Lösenord i klartext för SAML-keystore. |
sign_request | Anger huruvida Requests skickade från flexiteWEB till Identity Provider ska signeras med certifikat eller ej. Nyttjar certifikatet som angivits i
|
sign_cert_name | Namn på det certifikat som ska nyttjas av flexiteWEB för signering av Requests. |
sign_cert_password | Lösenord i klartext för det certifikat som ska nyttjas för signering. |
sign_assertion | Ange huruvida Assertions från Identity Provider måste vara signerade med certifikat eller ej.
|
encrypt_assertion | Anger huruvida Assertions som skickas från Identity Provider ska krypteras med certifikat eller ej. Nyttjar certifikatet som angivits i
|
encrypt_cert_name | Namn på det certifikat som ska nyttjas av Identity Provider för kryptering av Assertions. |
encrypt_cert_password | Lösenord i klartext för det certifikat som ska nyttjas för kryptering av Assertions. |
Språkfiler
Det är möjligt att skräddarsy de textsträngar som visas i gränssnittet efter egna önskemål. I flexiteWEB anges anpassade textsträngar per språk och fungerar som komplement till ordinarie språkfiler.
För information om anpassning av språkfiler, se kapitel Anpassning — Språktermer.
Ordinarie språkfiler
Ordinarie språkfiler ligger i katalogen C:\tomcat\webapps\flexite\WEB-INF\classes\language:
ResBundle_en.properties — Engelska
ResBundle_se.properties — Svenska
Anpassade språkfiler
Anpassade språkfiler placeras i katalogen C:\tomcat\webapps\flexite\WEB-INF\classes\language\customer. flexiteWEB stödjer en fil per språk, med samma namn som den fil den ska agera komplement till.
flexiteAdmin
flexiteAdmin.conf
flexiteAdmin.conf är den huvudsakliga konfigurationsfilen för flexiteAdmin.
Sökväg: {flexiteAdmin}\WEB-INF\classes\settings\flexiteAdmin.conf.
Exempel
conf
base-dir=/flexiteAdmin/
log-file=c:/tomcat/flexite/log/flexiteAdmin/flexiteAdmin.log
site-name=flexiteAdmin {version}
login-type=MANUAL
session-timeout=60
channel-interval=30
timeout-warning-time=300
jdbc-server-url=sqlserver.company.com
jdbc-database-name=flexite
jdbc-encrypt=0
jdbc-trust-server-certificate=0
jdbc-username=flexite
jdbc-password=ABCDEFGH12345678
jdbc-query-timeout=30
jdbc-queue-timeout=60
jdbc-pool-size=5
jdbc-pool-timeout=20
jdbc-max-attempts=10Inställningar för webbapplikation
Dessa inställningar anger bland annat sökvägar, inloggningsmetod och beteende för flexiteAdmin.
| Parameter | Beskrivning / Värde |
|---|---|
base-dir | Relativ sökväg till webbapplikationen flexiteAdmin, med Tomcat's katalog för webbapplikationer som utgångspunkt. Standardvärde: |
log-file | Absolut sökväg för loggfil för applikationsloggar för flexiteAdmin. |
site-name | Titeln för webbapplikationen. Denna visas exempelvis i webbläsarfliken.
|
login-type | De inloggningsmetoder som finnas tillgängliga i flexiteAdmin. Flera metoder separeras med mellanslag.
|
session-timeout | Gränsvärde i minuter för tillåten passiv tid i flexiteAdmin innan användarsessionen avslutas och användaren loggas ut. Används i kombination med Standardvärde: För information om sessionshantering i Tomcat, se avsnitt Sessionshantering. |
channel-interval | Tidsintervall i sekunder för heartbeats, en funktion som används av webbläsaren för att kontrollera att servern svarar. Standardvärde: |
timeout-warning-time | Tid i sekunder från session-timeout som en notifikation ska visas för användaren. Standardvärde: |
login-type
I det fall login-type konfigureras att nyttja både MANUAL och SAML visas en välkomstsida där användaren måste välja mellan automatisk eller manuell inloggning.

Angivna inloggningstyper hanteras på följande vis:
- Automatisk — Inloggning med SAML.
- Manuell — Inloggning med flexite-konto.
Databasanslutning
Dessa parametrar anger hur flexiteAdmin ska ansluta till databasen.
| Parameter | Beskrivning / Värde |
|---|---|
jdbc-server-url | Adress för databasservern, inkluderat port och/eller instans vid behov. |
jdbc-database-name | Namn på databasen. |
jdbc-encrypt | Aktivera/Inaktivera krav på krypterad anslutning.
|
jdbc-trust-server-certificate | Aktivera/Inaktivera validering av databasserverns certifikat.
|
jdbc-username | Användarnamn för konto för databasanslutning. |
jdbc-password | Lösenord i krypterat format för konto för databasanslutning. Lösenord i krypterat format kan hämtas från konfigurationsfilerna för applikationerna flexiteCLIENT ( |
Anslutning till standardinstans och standardport
Anslut till en Microsoft SQL-servers standardinstans på standardporten; 1433. Stödjer både krypterad och okrypterad anslutning, baserat på konfiguration av Microsoft SQL Server.
conf
jdbc-server-url={dbServer}
jdbc-database-name={dbName}Exempel
conf
jdbc-server-url=sqlserver.company.com
jdbc-database-name=flexiteAnslutning till specifik instans
Anslut till en specifik namngiven instans på en Microsoft SQL-server. Stödjer både krypterad och okrypterad anslutning, baserat på konfiguration av Microsoft SQL Server.
conf
jdbc-server-url={dbServer};instanceName={dbInstance}
jdbc-database-name={dbName}Exempel
conf
jdbc-server-url=sqlserver.company.com;instanceName=dbinstance
jdbc-database-name=flexiteAnslutning till specifik port
Anslut till en specifik port på en Microsoft SQL-server. Stödjer både krypterad och okrypterad anslutning, baserat på konfiguration av Microsoft SQL Server.
conf
jdbc-server-url={dbServer}:{dbPort}
jdbc-database-name={dbName}Exempel
conf
jdbc-server-url=sqlserver.company.com:1234
jdbc-database-name=flexitejdbc-encrypt — kryptering av databaskommunikation
flexiteAdmin är konstruerat att som standard stödja både krypterad och okrypterad anslutning till databasservern. Detta innebär att det tillåts att falla tillbaka till en okrypterad anslutning i det fall både server och klient stödjer en sådan.
Med parametern jdbc-encrypt är det möjligt att ange huruvida flexiteAdmin ska tillåtas att falla tillbaka till okrypterad anslutning eller ej.
- 0 — Tillåt kommunikation över både okrypterat och krypterat protokoll. Konfiguration av SQL-server bestämmer i detta fall vilket protokoll som kommer att nyttjas. I det fall SQL-servern stödjer både krypterat och okrypterat protokoll kommer anslutningen att nyttja okrypterat. Standardvärde om parameter saknas.
- 1 — Tillåt enbart kommunikation över krypterat protokoll.
Beteendematris
Dessa matriser detaljerar vilken effekt olika värden för parametern jdbc-encrypt har på anslutningen vid olika konfigurationer av SQL-servern samt tillgänglighet av certifikat på applikationsservern.
SQL-server med tvingad kryptering, med certifikat
Denna matris visar effekten när SQL-servern har aktiverat tvingad kryptering (Force Encryption = Yes) samt är tilldelad ett giltigt certifikat.
| Parameter | Certifikat | Resultat |
|---|---|---|
jdbc-encrypt=0 | Installerat i Java keystore | Krypterad anslutning |
jdbc-encrypt=0 | Ej installerat | Ingen anslutning |
jdbc-encrypt=1 | Installerat i Java keystore | Krypterad anslutning |
jdbc-encrypt=1 | Ej installerat | Ingen anslutning |
SQL-server utan tvingad kryptering, utan certifikat
Denna matris visar effekten när SQL-servern har inaktiverat tvingad kryptering (Force Encryption = No) och inte tilldelats något certifikat. I detta scenario nyttjar SQL-servern ett egensignerat certifikat som vi förutsätter inte är installerat i Java keystore på applikationsservern.
| Parameter | Certifikat | Resultat |
|---|---|---|
jdbc-encrypt=0 | Ej installerat | Okrypterad anslutning |
jdbc-encrypt=1 | Ej installerat | Ingen anslutning |
SQL-server utan tvingad kryptering, med certifikat
Denna matris visar effekten när SQL-servern har inaktiverat tvingad kryptering (Force Encryption = No) samt är tilldelad ett giltigt certifikat.
| Parameter | Certifikat | Resultat |
|---|---|---|
jdbc-encrypt=0 | Installerat i Java keystore | Okrypterad anslutning |
jdbc-encrypt=0 | Ej installerat | Okrypterad anslutning |
jdbc-encrypt=1 | Installerat i Java keystore | Krypterad anslutning |
jdbc-encrypt=1 | Ej installerat | Ingen anslutning |
grandId.json
grandId.json innehåller inställningar för E-ID för flexiteAdmin.
Sökväg: {flexiteAdmin}\WEB-INF\classes\settings\grandId.json
E-ID kräver konto och nycklar från Svensk e-identitet:
- En nyckel för Svensk e-identitets API; GrandID.
- En uppsättning nycklar för varje leverantör som ska nyttjas.
För information om konfiguration av E-ID, se kapitel E-ID för identifiering och signering.
Exempel
Exempel med BankID som leverantör (provider):
json
{
"url": "https://client.grandid.com/json1.1/",
"apiKey": "ABCDEFGH1234567890",
"providers": {
"bankid": {
"serviceKey": "ABCDEFGH1234567890",
"nameLetterCase": "none"
}
}
}Inställningar
| Parameter | Beskrivning / Värde |
|---|---|
url | URL för GrandID API. |
apiKey | API-nyckel för GrandID. |
providers | Här specificeras inställningar per leverantör. |
bankid | Anger inställningar för leverantören BankID. |
serviceKey | API-nyckel för leverantören BankID. |
nameLetterCase | Valfri parameter. Anger hur namn-information som mottas från leverantören ska formateras när det sparas till flexite. Namn-information inkluderar attribut som innehåller för- och efternamn och berör inte information såsom unikt ID.
|
saml.conf
saml.conf innehåller inställningar för SAML för flexiteAdmin.
Sökväg: {flexiteAdmin}\WEB-INF\classes\settings\integration\saml\saml.conf
För information om konfiguration av SAML, se kapitel Single Sign-On — SAML.
Exempel
conf
idp_metadata_file=/integration/saml/saml_idp.xml
idp_entity_id=https://idp.company.com:9443/
idp_user_attibute_name=urn:oid:2.4.8.128
fx_user_field_name=username
keystore_file=/integration/saml/saml.jks
keystore_password=keystore_password
sign_request=1
sign_cert_name=sign_certificate
sign_cert_password=sign_password
sign_assertion=1
encrypt_assertion=1
encrypt_cert_name=encrypt_certificate
encrypt_cert_password=encrypt_passwordInställningar
| Parameter | Beskrivning / Värde |
|---|---|
idp_metadata_file | Relativ sökväg till den metadata-fil som hämtats från Identity Provider. Använder katalogen för SAML som rot. |
idp_entity_id | ID för server som agerar Identity Provider. |
idp_user_attibute_name | Det attribut hos Identity Provider som innehåller användar-id. |
fx_user_field_name | Det attribut i flexite som användar-id från Identity Provider ska verifieras mot. Möjliga alternativ:
|
keystore_file | Relativ sökväg till keystore för SAML-certifikat. Använder katalogen för SAML som rot. |
keystore_password | Lösenord i klartext för SAML-keystore. |
sign_request | Anger huruvida Requests skickade från flexiteAdmin till Identity Provider ska signeras med certifikat eller ej. Nyttjar certifikatet som angivits i
|
sign_cert_name | Namn på det certifikat som ska nyttjas av flexiteAdmin för signering av Requests. |
sign_cert_password | Lösenord i klartext för det certifikat som ska nyttjas för signering. |
sign_assertion | Ange huruvida Assertions från Identity Provider måste vara signerade med certifikat eller ej.
|
encrypt_assertion | Anger huruvida Assertions som skickas från Identity Provider ska krypteras med certifikat eller ej. Nyttjar certifikatet som angivits i
|
encrypt_cert_name | Namn på det certifikat som ska nyttjas av Identity Provider för kryptering av Assertions. |
encrypt_cert_password | Lösenord i klartext för det certifikat som ska nyttjas för kryptering av Assertions. |
Språkfiler
Det är möjligt att skräddarsy de textsträngar som visas i gränssnittet efter egna önskemål. I flexiteAdmin anges anpassade textsträngar per språk och fungerar som komplement till ordinarie språkfiler.
För information om anpassning av språkfiler, se kapitel Anpassning — Språktermer.
Ordinarie språkfiler
Ordinarie språkfiler ligger i katalogen C:\tomcat\webapps\flexiteAdmin\WEB-INF\classes\languages:
en.lang.ini — Engelska
sv.lang.ini — Svenska
Anpassade språkfiler
Anpassade språkfiler placeras i katalogen C:\tomcat\webapps\flexiteAdmin\WEB-INF\classes\languages\custom.
flexiteAdmin stödjer flera språkfiler per språk, där filerna måste namnges efter följande format:
{valfritt namn}.{språk}.lang.ini
Exempel för språkfil på svenska:
mycustomfile.sv.lang.ini
Filerna läses i alfanumerisk ordning, där den senast lästa filen har företräde.
flexitePortal
flexitePortal.conf
flexitePortal.conf är den huvudsakliga konfigurationsfilen för flexitePortal.
Sökväg: {flexitePortal}\WEB-INF\classes\settings\flexitePortal.conf.
Exempel
conf
base-dir=/flexitePortal/
log-file=c:/tomcat/flexite/log/flexitePortal/flexitePortal.log
site-name=flexitePortal {version}
session-timeout=60
channel-interval=30
timeout-warning-time=300
http-pool-size=5
http-queue-timeout=60
http-request-timeout=30
flexite-url=https://flexite.company.com/flexite/
flexite-login=standard
flexite-secret=FLEXITE
flexite-username=flexitePortal
flexite-password=NWJhYTYxZTRjOWI5M2YzZjA2ODIyNTBiNmNmODMzMWI3ZWU2OGZkOA==
link-encryption-key=ABCDEFGH12345678
flexite-initialize-secret-key=12345678ABCDEFGHInställningar för webbapplikation
Dessa inställningar anger bland annat sökvägar och beteende för flexitePortal.
| Parameter | Beskrivning / Värde |
|---|---|
base-dir | Relativ sökväg till webbapplikationen flexitePortal, med Tomcat's katalog för webbapplikationer som utgångspunkt. Standardvärde: |
log-file | Absolut sökväg för loggfil för applikationsloggar för flexitePortal. |
site-name | Titeln för webbapplikationen. Denna visas exempelvis i webbläsarfliken.
|
session-timeout | Gränsvärde i minuter för tillåten passiv tid i flexitePortal innan användarsessionen avslutas och användaren loggas ut. Används i kombination med Standardvärde: För information om sessionshantering i Tomcat, se avsnitt Sessionshantering. |
channel-interval | Tidsintervall i sekunder för heartbeats, en funktion som används av webbläsaren för att kontrollera att servern svarar. Standardvärde: |
timeout-warning-time | Tid i sekunder från session-timeout som en notifikation ska visas för användaren. Standardvärde: |
http-pool-size | Antal aktiva förfrågningar till flexiteWEB som kan vara aktiva samtidigt. Standardvärde: |
http-queue-timeout | Antal sekunder i kön innan en väntande förfrågan till flexiteWEB avbryts. Standardvärde: |
http-request-timeout | Antal sekunder innan en aktiv förfrågan till flexiteWEB anses ha misslyckats. Standardvärde: |
link-encryption-key | Unik nyckel för kryptering av publika länkar i flexitePortal. |
API-anslutning
Dessa inställningar anger hur flexitePortal ska ansluta till flexiteWEB API.
| Parameter | Beskrivning / Värde |
|---|---|
flexite-url | URL för webbapplikationen flexiteWEB. |
flexite-login | Inloggningsmetod för flexiteWEB API. Standardvärde: |
flexite-secret | Projektnamn för flexiteWEB API. Standardvärde: |
flexite-username | Användarnamn för flexiteWEBs flexitePortal-användarkonto (användarkonto med Tillåt API-autentisering med utökade Identitets-funktioner aktiverat). |
flexite-password | Lösenord för flexiteWEBs flexitePortal-användarkonto (användarkonto med Tillåt API-autentisering med utökade Identitets-funktioner aktiverat). Anges i formatet Base64-kodad SHA1-hash av användarkontots lösenord. |
flexite-initialize-secret-key | Nyckel för att kringgå krav på E-ID vid start av flexite E-service. Istället nyttjas uppgifter från aktuell användare (Identitet) i flexitePortal. Måste matcha nyckeln som angivits i flexiteWEB ( |
flexite-password
Lösenordet för flexitePortal användarkonto anges i krypterat format; en Base64-kodad SHA1-hash av användarkontots lösenord:
{lösenord} -> SHA1 Hash -> Base64 EncodeExempel
Lösenordet password resulterar i följande Base64-sträng:
NWJhYTYxZTRjOWI5M2YzZjA2ODIyNTBiNmNmODMzMWI3ZWU2OGZkOA==flexite-initialize-secret-key
I flexitePortal skapas nya registreringar via publika E-services som hämtas från flexiteWEB API. I dessa E-services används komponenten Identitet för att knyta den individuelle medborgaren till registreringen.
Som standard kräver komponenten Identitet att medborgaren manuellt bekräftar sin identitet via BankID.
För att förenkla flödet för medborgaren är det möjligt att nyttja krav på E-ID vid öppnande av E-service tillsammans med flexite-initialize-secret-key för att använda den redan autentiserade identiteten från aktuell session i flexitePortal. På detta vis behöver medborgaren själv inte manuellt identifiera sig igen för att knyta identiteten till registreringen.
Denna nyckel måste stämma överens med nyckeln som angivits för flexiteWEB; parametern portal-initialize-secret-key i flexite.conf.
grandId.json
grandId.json innehåller inställningar för E-ID för flexitePortal.
Sökväg: {flexitePortal}\WEB-INF\classes\settings\grandId.json
E-ID kräver konto och nycklar från Svensk e-identitet:
- En nyckel för Svensk e-identitets API; GrandID.
- En uppsättning nycklar för varje leverantör som ska nyttjas.
För information om konfiguration av E-ID, se kapitel E-ID för identifiering och signering.
Exempel
Exempel med BankID som leverantör (provider):
json
{
"url": "https://client.grandid.com/json1.1/",
"apiKey": "ABCDEFGH1234567890",
"providers": {
"bankid": {
"serviceKey": "ABCDEFGH1234567890",
"nameLetterCase": "none"
}
}
}Inställningar
| Parameter | Beskrivning / Värde |
|---|---|
url | URL för GrandID API. |
apiKey | API-nyckel för GrandID. |
providers | Här specificeras inställningar per leverantör. |
bankid | Anger inställningar för leverantören BankID. |
serviceKey | API-nyckel för leverantören BankID. |
nameLetterCase | Valfri parameter. Anger hur namn-information som mottas från leverantören ska formateras när det sparas till flexite. Namn-information inkluderar attribut som innehåller för- och efternamn och berör inte information såsom unikt ID.
|
nameLetterCase
Valfri parameter som anger hur namn-information som mottas från leverantören ska formateras när det sparas till flexite.
Exempel
| Leverantör | none | uppercase | titlecase |
|---|---|---|---|
anna-lena o'brien | anna-lena o'brien | ANNA-LENA O'BRIEN | Anna-Lena O'Brien |
saml.json
saml.json innehåller inställningar för SAML för flexitePortal.
Sökväg: {flexitePortal}\WEB-INF\classes\settings\saml.json
För information om konfiguration av SAML, se kapitel Single Sign-On — SAML.
Exempel
json
{
"spEntityId": "https://flexite.company.com/flexitePortal/app/authentication/saml/metadata",
"providers": {
"external_idp": {
"idpMetadataPath": "metadata/external/saml_idp.xml",
"authenticationFlow": "external",
"displayName": "External IdP",
"attributeMappings": {
"firstName": "urn:oid:2.4.8.16",
"lastName": "urn:oid:2.4.8.32",
"mail": "urn:oid:2.4.8.64",
"uniqueId": "urn:oid:2.4.8.128"
},
"subjectIdSource": "uniqueId",
"requireSignedResponse": false,
"requireSignedAssertion": true,
"keystorePath": "saml.jks",
"keystoreType": "JKS",
"keystorePassword": "keystore_password",
"signAuthnRequest": true,
"keyAlias": "sign_certificate",
"keyPassword": "sign_password",
"encryptAssertion": true,
"encryptionKeyAlias": "encrypt_certificate",
"encryptionKeyPassword": "encrypt_password",
"nameLetterCase": "none",
"clockSkewSeconds": 120
}
}
}Globala inställningar
| Parameter | Beskrivning / Värde |
|---|---|
spEntityId | Service Provider-identitet som nyttjas av flexitePortal. Denna identitet gäller för samtliga Identity Providers. |
Inställningar för providers
Uppgifter för Identity Providers anges i providers, där en profil skapas per Identity Provider.
| Parameter | Beskrivning / Värde |
|---|---|
providers | Container för Identity Provider-konfigurationer. Varje Identity Provider sparas som en unik profil. |
idpMetadataPath | Relativ sökväg till den metadata-fil som hämtats från Identity Provider. Använder katalogen för SAML som rot. |
authenticationFlow | Anger huruvida SAML-inloggning ska ske med interna flexite-konton eller externa Identiteter.
|
displayName | Valfritt visningsnamn för profilen som presenteras i gränssnittet. Om inget namn anges visas istället profilnamnet. |
attributeMappings | Koppla SAML-attribut till Identitetsattribut och variablar som kan nyttjas av andra funktioner.
|
subjectIdSource | Anger vilket attribut från |
requireSignedResponse | Ange huruvida svar från Identity Provider måste vara signerade med certifikat eller ej.
|
requireSignedAssertion | Ange huruvida Assertions från Identity Provider måste vara signerade med certifikat eller ej.
|
keystorePath | Relativ sökväg till keystore för SAML-certifikat. Använder katalogen för SAML som rot. |
keystoreType | Format på keystore. Stödjer |
keystorePassword | Lösenord i klartext för SAML-keystore. |
signAuthnRequest | Ange huruvida Requests som skickas från flexitePortal till Identity Provider ska signeras med certifikat eller ej. Nyttjar certifikatet som angivits i
|
keyAlias | Namn på det certifikat som ska nyttjas av flexitePortal för signering av Requests. |
keyPassword | Lösenord i klartext för det certifikat som ska nyttjas för signering av Requests. |
encryptAssertion | Ange huruvida Assertions från Identity Provider ska krypteras med certifikat eller ej. Nyttjar certifikatet som angivits i
|
encryptionKeyAlias | Namn på det certifikat som ska nyttjas av Identity Provider för kryptering av Assertions. |
encryptionKeyPassword | Lösenord i klartext för det certifikat som ska nyttjas för kryptering av Assertions. |
nameLetterCase | Ange hur namn-information som mottas från Identity Provider ska formateras när det sparas till flexite.
|
clockSkewSeconds | Tillåten klockskillnad i sekunder mellan Identity Provider och flexitePortal vid validering av tidsstämplar i SAML Assertions. Standardvärde: |
nameLetterCase
Valfri parameter som anger hur namn-information som mottas från leverantören ska formateras när det sparas till flexite.
Exempel
| Leverantör | none | uppercase | titlecase |
|---|---|---|---|
anna-lena o'brien | anna-lena o'brien | ANNA-LENA O'BRIEN | Anna-Lena O'Brien |
flexiteFormAssist
controllers.xml
controllers.xml innehåller konfiguration av gränssnittet för flexiteFormAssist, däribland konfiguration av visningsspråk.
Sökväg: {flexiteFormAssist}\WEB-INF\spring\appServlet\controllers.xml
Ange standardspråk
Som standard visas flexiteFormAssist på två språk beroende på språket i den aktuella webbläsaren:
För webbläsare på svenska visas gränssnittet i flexiteFormAssist på svenska.
För webbläsare på engelska visas gränssnittet i flexiteFormAssist på engelska.
För webbläsare på övriga språk som inte explicit stöds av flexiteFormAssist visas gränssnittet i flexiteFormAssist på standardspråket engelska.
Det är möjligt att ändra detta standardspråk till svenska.
Konfiguration
xml
<bean id="messageSource" class="org.springframework.context.support.ReloadableResourceBundleMessageSource">
<property name="basename" value="classpath:messages/messages" />
<property name="defaultEncoding" value="UTF-8"/>
<property name="defaultLocale" value="en"/>
<!--<property name="fallbackToSystemLocale" value="false" />-->
</bean>Parametern defaultLocale anger standardspråket för gränssnittet i flexiteFormAssist.
Det är möjligt att ange svenska som standardspråk genom att ändra värdet för denna parameter från en till sv:
xml
<property name="defaultLocale" value="sv"/>Tvinga visningsspråk
Det är möjligt att konfigurera flexiteFormAssist att nyttja ett statiskt språk för gränssnittet istället för att följa språket i webbläsaren.
Konfiguration
xml
<bean id="localeResolver" class="org.springframework.web.servlet.i18n.CookieLocaleResolver">
<!--Use this property to force specific language -->
<!--<property name="defaultLocale" value="sv"/>-->
</bean>Den utkommenterade, och därmed inaktiverade, parametern defaultLocale kan nyttjas för att ange ett statiskt språk för gränssnittet i flexiteFormAssist.
Genom att ta bort den inneslutande kommenteringen (<!--...-->) och ange önskat språk (sv eller en) kommer flexiteFormAssist alltid att visas på det önskade språket, oavsett språk i webbläsare:
xml
<property name="defaultLocale" value="sv"/>db.properties
db.properties innehåller konfiguration av anslutning till databasserver för flexiteFormAssist.
Sökväg: {flexiteFormAssist}\WEB-INF\db.properties
| Parameter | Beskrivning |
|---|---|
jdbc.driverClassName | Den drivrutin som ska nyttjas för databasanslutningar. Det enda värde som stöds är standardvärdet |
jdbc.dialect | Den SQL-syntax som ska användas för kommunikation med databasserver. MSSQL (standard): |
jdbc.url | Sökväg för databasen för flexiteFormAssist. Nyttjar samma format som db-server-url i flexiteWEB. Exempel: |
jdbc.username | Användarnamn för konto för databasanslutning. |
jdbc.password | Lösenord i krypterat format för konto för databasanslutning. Lösenord i krypterat format kan hämtas från konfigurationsfilerna för applikationerna flexiteCLIENT ( |
ffa.properties
ffa.properties innehåller globala inställningar för flexiteFormAssist.
Sökväg: {flexiteFormAssist}\WEB-INF\classes\ffa.properties
| Parameter | Beskrivning |
|---|---|
flexiteFormAssist. | Ange vilken typ av inloggning som ska användas.
|
flexiteFormAssist. | Ange stöd för utökad sökfunktionalitet. För mer information om sökfunktioner, se användarmanual för flexiteFormAssist.
|
flexiteFormAssist. | Ange sorteringsordning för hur manuskript visas vid sökning.
|
flexiteFormAssist. | Ange om det ska vara möjligt att öppna en detaljvy av manuskriptet från listvyn.
|
flexiteFormAssist. | Vid enbart en sökträff, expandera ytan för manuskripttext så att hela texten visas.
|
flexiteFormAssist. | Fördröjning i millisekunder från det att sökord angivits tills dess att sökning genomförs. Standardvärde: |
flexiteFormAssist. | Typsnitt för flexiteFormAssist gränssnitt. Standard är 9pt Arial. Standardvärde: |
flexiteFormAssist. | Fönsterbredd i pixlar vid vilken flexiteFormAssist övergår från vertikalt gränssnitt till horisontellt. Standardvärde: |
flexiteFormAssist. | Procentuell bredd på manuskriptmodul i förhållande till fönsterbredd. Standardvärde: |
flexiteFormAssist. | Ange hur ägarskap som standard ska anges för nya manuskript.
|
flexiteFormAssist. | Ange om snabbmeddelanden ska döljas när flexiteFormAssist visas i iframe.
|
Globala Inställningar för synliga manuskriptdelar i listvyn
| Parameter | Beskrivning |
|---|---|
flexiteFormAssist. |
|
flexiteFormAssist. |
|
flexiteFormAssist. |
|
flexiteFormAssist. |
|
flexiteFormAssist. |
|
flexiteFormAssist. |
|
flexiteFormAssist. |
|
flexiteFormAssist. |
|
flexiteFormAssist. |
|
Login.Type FLEXITE, NONE_FLEXITE
När parametern flexiteFormAssist.Demand.Login.Type är satt till FLEXITE eller NONE_FLEXITE används användarnamnet från den aktuella flexite-sessionen för att logga in användaren.
Denna inloggningsmetod är framtagen specifikt för scenariot där flexiteFormAssist publiceras direkt i ett flexite-formulär och är inte kompatibel med andra typer av implementationer.
Autentiseringen sker genom att jämföra användarnamnet från den aktuella flexite-sessionen mot användarnamn i flexiteFormAssist. Varje flexite-användare som ska ges möjlighet måste således ha ett motsvarande användarkonto i flexiteFormAssist.
fullscreen.css
fullscreen.css innehåller konfiguration av utseende av flexiteFormAssist.
Sökväg: {flexiteFormAssist}\css\fullscreen.css
| Parameter | Beskrivning |
|---|---|
div.man_height | Anger utseende för manuskripttext i listvyn vid flera sökträffar.
Exempel: css |
div.qm_height | Anger utseende för snabbmeddelandetext.
Exempel: css För fler konfigurationsmöjligheter, se avsnitt div.qm_height. |
div.qm_height
I likhet med manuskripttext är det möjligt att sätta en statisk maxhöjd även för snabbmeddelandetext. I det fallet ersätts height: auto; med max-height följt av önskad höjd i pixlar, samt att hantering av overflow specificeras.
Exempel
css
div.qm_height {
max-height: 140px;
overflow: auto;
word-break: break-word;
}web.xml
web.xml innehåller systemkonfiguration för flexiteFormAssist.
Sökväg: {flexiteFormAssist}\WEB-INF\web.xml
Sessionshantering
Parametern session-timeout kontrollerar idle timeout för sessioner mellan klienter och webbapplikationen flexiteFormAssist. Parametern anger i hur många minuter från senaste interaktion med flexiteFormAssist, inom en och samma webbläsarflik, som sessionen ska hållas öppen.
Efter att tiden passerat avslutas sessionen mellan klienten och webbapplikationen och användaren loggas ut. Eventuell information som angivits i sessionen men inte sparats går förlorad.
I det fall webbläsarfliken stängs ner utan att användaren först loggar ut, eller kommunikationen mellan klient och server avbryts på grund av annan orsak, överlåts avslutande av sessionen till webbservern Apache Tomcat. Som standard avslutas sessionen av Tomcat efter 5 minuter.
För konfiguration av sessionshantering i Apache Tomcat, se avsnitt Sessionshantering.
Exempel
xml
<session-config>
<session-timeout>60</session-timeout>
</session-config>Apache Tomcat
web.xml
Sessionshantering
Parametern session-timeout kontrollerar idle timeout för sessioner mellan klienter och webbservern Apache Tomcat. Nedräkning börjar efter att användarsessionen i webbapplikationen avslutats alternativt att kommunikation inom användarsessionen upphört, exempelvis på grund av att webbläsaren stängts ner innan utloggning.
Efter att tiden passerat avslutas sessionen mellan klienten och webbservern, och eventuell information som angivits i sessionen men inte sparats går förlorad. En avslutad session betyder att användaren måste logga in på nytt.
Denna inställning används i kombination med konfiguration av sessionshantering i de individuella webbapplikationerna för att hantera sessioner mellan klient och webbserver.
För konfiguration av sessionshantering i flexiteWEB, se avsnitt Sessionshantering och timeout.
För konfiguration av sessionshantering i flexiteAdmin, se avsnitt Inställningar för webbapplikation.
För information om sessionshantering i flexiteFormAssist, se avsnitt Sessionshantering.
| Parameter | Beskrivning / Värde |
|---|---|
session-timeout | Gränsvärde i minuter för tillåten passiv tid efter att användarsessioner i webbapplikationer avslutats eller kommunikation upphört. Efter att denna tid passerat avslutas sessionen mellan klienten och webbservern. Standardvärde: Maxvärde är |
Standardkonfiguration
xml
<session-config>
<session-timeout>5</session-timeout>
</session-config>