Versions Compared

Old Version 2

changes.mady.by.user Sander DE CANCK

Saved on

compared with

New Version 3

changes.mady.by.user Sander DE CANCK

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

In process mode means that the portal and the runtime will run in the same process. This means that when you start the “Eu.EDelivery.AS4.ServiceHandler.ConsoleHost.exe” then also the portal will be available.
This configuration is managed in the “settings.xml” file with the following option: 

Image Modified

Setting the “FeInProcess” value to true means that the “in process” mode is enabled.

...

In the AS4 package there are 2 configuration files available for the portal. “appsettings.json” & “appsettings.inprocess.json”. All settings in the “appsettings.inprocess.json” are used when running the portal “in process” and settings from “appsettings.json” are used when running in a dedicated process or with IIS.


Setting name

Description

Port

This defines the IP address & port on which the portal should be listening. For ex if you set this to http://127.0.0.1:9000, then the portal will be reachable using a browser at http://127.0.0.1:9000.

Logging

This block is used to configure the internal .NET logging. Since these are settings not specific to the AS4 portal we refer to the Microsoft documentation for this https://docs.microsoft.com/en-us/aspnet/core/fundamentals/logging#log-filtering

Settings

This section contains settings used for the portal.

    • ShowStackTraceInExceptions

If true, then a stack trace will be shown in the error dialog when something went something unexpected wrong. This is will contain the server exception!
For production, it’s best to set this option to false, to avoid leaking sensitive information.

    • SettingsXml

This option indicates where the settings.xml used by the runtime is located.
Default setting is ‘./config/settings.xml’. You can also specify a UNC path.

    • Runtime

The location where all the runtime files are located (DLL’s / exe).
Default is ‘.’.

Authentication

Section for configure the authentication of the portal

    • Provider

The database provider used for authentication.
Default is ‘sqlite’, another possible option id ‘mssql’.

    • ConnectionString

The connection string to the authentication database.
Default is ‘FileName=users.sqlite’, when setting the provider to ‘mssql’ then a mssql connectionstring is expected here.
You can look at https://www.connectionstrings.com/sql-server/ for examples of mssql connection strings.

    • JwtOptions.Issuer

A string indicating who issued the JWT token. This can be any string.
Default is “AS4.NET”.

    • JwtOptions.Audience

A string indicating for which services this JWT token is. This can also be any string.
Default is “http://localhost:5000”.

    • JwtOptions.ValidFor

The amount of days that the JWT token is valid.
Default is 1 day

    • JwtOptions.Key

The secret key used to sign the JWT token.
Default is “auf0i3VsjznH6K6imUl2”, but we strongly advice to change this key! This can be configured when the portal is started for the first time!

Monitor

Section containing settings for the monitor module.

    • Provider

The database provider used to access the runtime database.
Default is “sqlite”, another option is “mssql”.

    • ConnectionString

The connection string for the runtime database.

Default is “FileName=users.sqlite”, when setting the provider to ‘mssql’ then a mssql connectionstring is expected here.
You can look at https://www.connectionstrings.com/sql-server/ for examples of mssql connection strings.

Pmodes

All configuration settings to find PModes.

    • SendingPmodeFolder

The folder containing all the sending PModes. This can also be a UNC path.

Default is “./config/send-pmodes”.

    • ReceivingPmodeFolder

The folder containing all the receiving PModes. This can also be a UNC path.;

Default is “./config/receive-pmodes”.

SubmitTool

This section contains all the settings used in the test message tool.

    • ToHttpAddress

The MSH endpoint to send messages to.

    • PayloadHttpAddress

The HTTP endpoint of a payload service to send payloads to.