...
Content
| Table of Contents |
|---|
...
General
Die Konfiguration des Connect Servers erfolgt in der Regel mit Hilfe von JSON-Dateien, welche sich im Installationsverzeichnis der Applikation befinden. In Spezialfällen ist eine Übersteuerung über Umgebungsvariablen oder über Kommandozeilenparameter möglich.
Standardkonfiguration
Die Standardkonfiguration befindet sich in der Datei The Connect Server is usually configured using JSON files, which are located in the installation directory of the application. In special cases, overriding via environment variables or via command line parameters is possible.
Standard configuration
The default configuration is located in the “appsettings.Default.json” . Diese Datei sollte nicht direkt verändert werden, da diese Änderungen ggf. durch ein späteres Upgrade überschrieben werden.
Installationsspezifische Konfiguration
Soll eine installationsspezifische Konfiguration angelegt werden, so empfiehlt es sich die Datei „appsettings.Default.json“ in eine Datei mit dem Namen “appsettings.json” zu kopieren. Diese Datei wird bei einem eventuellen Upgrade nicht überschrieben, somit bleiben die hier hinterlegten Konfigurationseinstellungen bestehen.
Die Standardkonfiguration wird hierbei weiterhin berücksichtigt. Die installationsspezifische Konfiguration muss daher nur die gewünschten Deltas enthalten.
Umgebungsspezifische Konfiguration
Wird ein Installationsverzeichnis in verschiedenen Umgebungen genutzt (z. B. in einem Template für Container), so können umgebungsspezifische Konfigurationen angelegt werden. Hierfür wird die Datei „appsettings.Default.json“ in eine Datei mit dem Namen “appsettings.{environment}.json” kopiert ({environment} ist hierbei durch den Namen der entsprechenden Umgebung zu ersetzen).
In diesem Szenario kann die Umgebung zur Laufzeit mit Hilfe der Umgebungsvariablen “ASPNETCORE_ENVIRONMENT” spezifiziert werden. In der Regel werden hier die Werte “Development”, “Staging” und “Production” verwendet, der Standardwert ist “Production”.
Die Standardkonfiguration sowie ein evtl. vorhandene installationsspezifische Konfiguration werden weiterhin berücksichtigt. Die umgebungsspezifischen Konfigurationen müssen daher nur die gewünschten Deltas enthalten.
Die Verwendung der Umgebung “Development” sollte in Produktionsumgebungen vermieden werden, da hierbei zusätzliche Debugging-Funktionalitäten aktiviert werden.
Explizite Konfiguration
Bei Bedarf können in der Kommandozeile über das Argument “settings=…”, “-settings=…”, “—settings=…” oder “/settings=…” zusätzliche Konfigurationsdateien angegeben werden. Hierbei wird geprüft, ob die angegebene Konfigurationsdatei vorhanden ist und gegebenenfalls eine Fehlermeldung ausgegeben. Diese Prüfung kann deaktiviert werden, indem an den Dateinamen ein Fragezeichen angehängt wird. Dadurch lassen sich auch optionale Konfigurationsdateien in der Kommandozeile spezifizieren.
Die Standardkonfiguration sowie die installationsspezifische Konfiguration und die umgebungsspezifische(n) Konfiguration(en) werden weiterhin berücksichtigt. Die expliziten Konfigurationen müssen in diesem Fall nur die gewünschten Deltas enthalten.
Struktur der Konfigurationsdatei
Die Konfigurationsdatei für den Connect Server ist eine JSON Datei mit eine JSON Objekt als Wurzelelement. Die entsprechenden untergeordneten Elemente werden in den folgenden Kapiteln beschrieben.
Der Abschnitt „Logging“ (JSON Objekt)
Dieser Abschnitt enthält ein weiteres JSON Objekte mit dem Namen “LogLevel”, welches den Detailgrad der Protokollausgaben festlegt. Hierbei enthält die Eigenschaft “Default” die Standardeinstellung, weitere vorhandene Eigenschaften definieren ggf. abweichende Einstellungen für bestimmte .NET Namensräume. Für den Detailgrad werden folgende die Werte “Trace”, “Debug”, “Information”, “Warning” und “Error” unterstützt.
Beispiel:
... "Logging": { "LogLevel": { "Default": "Information", "IdentityServer4": "Warning", "Microsoft": "Warning",
file. This file should not be changed directly, because these changes may be overwritten by a later upgrade.
Installation-specific configuration
If an installation-specific configuration is to be created, it is recommended to copy the file "appsettings.Default.json" into a file with the name "appsettings.json". This file will not be overwritten in case of an upgrade, so the configuration settings stored here will remain.
The default configuration is still considered, the installation-specific configuration must therefore only contain the desired deltas.
Environment-specific configuration
If an installation directory is used in different environments (e.g., in a template for containers), environment-specific configurations can be created. For this the file "appsettings.Default.json" is copied into a file with the name "appsettings.{environment}.json" ({environment} has to be replaced by the name of the corresponding environment).
In this scenario, the environment can be specified at runtime using the environment variable "ASPNETCORE_ENVIRONMENT". Usually the values "Development", "Staging" and "Production" are used here, the default value is "Production".
The default configuration and any existing installation-specific configuration are still considered, the environment-specific configurations must therefore only contain the desired deltas.
The use of the "Development" environment should be avoided in production environments, as this activates additional debugging functionalities.
Explicit configuration
If required, additional configuration files can be specified on the command line using the argument "settings=...", "-settings=...", "--settings=..." or "/settings=...". The system checks whether the specified configuration file exists and displays an error message if it is not found. This check can be deactivated by appending a question mark to the file name. This allows optional configuration files to be specified on the command line.
The default configuration as well as the installation-specific configuration and the environment-specific configuration(s) are still considered. In this case, the explicit configurations only have to contain the desired deltas.
Structure of the configuration file
The configuration file for the Connect Server is a JSON file with a JSON object as the root element. The corresponding child elements are described in the following chapters.
The “Logging” section (JSON object)
This section contains another JSON object named "LogLevel", which defines the level of detail of the log outputs. The property "Default" contains the standard setting, other existing properties define different settings for certain .NET namespaces. The following values are supported for the level of detail: "Trace", "Debug", "Information", "Warning" and "Error".
Example:
| Code Block |
|---|
... "Logging": { "LogLevel": { "Default": "Information", "IdentityServer4": "Warning", "Microsoft": "Warning", "Microsoft.Hosting.Lifetime": "Information" |
...
} |
...
}, |
...
... |
Bei Bedarf kann der Detailgrad in Abhängigkeit vom Protokollierungsziel (Konsole, Event LogIf required, the level of detail can be specified depending on the logging target (console, event log, etc.) spezifiziert werden. Weitergehende Informationen finden sie unter folgendem Link. Further information can be found under the following link:
...
...
The “IdentityServer” section (JSON
...
object)
Dieser Abschnitt Konfigurationen für den im Connect Server integrierten Identity Server. Dieser ist für die Authentifizierung der Benutzer zuständig. Die Standardkonfiguration ist für Entwicklungsumgebungen oder für abgeschlossene Netzwerke sinnvoll, da sie keinerlei weitergehende Einstellungen benötigt. Soll der Connect Server jedoch über das Internet erreichbar sein, so sollten diese Einstellungen unbedingt angepasst werden. Weitere Informationen hierzu finden Sie unter folgendem LinkThis section provides configurations for the Connect Server's built-in Identity Server used for authenticating users. The default configuration is useful for development environments or for closed networks since it does not require any additional adjustments. However, if the Connect Server is to be accessible via the Internet, these settings should be adapted. More information about this can be found at the following link:
...
BeispielExample:
| Code Block | ||
|---|---|---|
| ||
... |
...
"IdentityServer": { |
...
"Key": { |
...
"Type": "Development" |
...
}, |
...
"Clients": { |
...
"GalileoGroup.Connect.Server.Frontend": { |
...
"Profile": "IdentityServerSPA" |
...
} |
...
} |
...
}, |
...
... |
...
The “AllowedHosts” section (JSON
...
value of type String)
This section allows you to restrict the host names to which the web server is bound. Thus, access via unwanted host names or via IP addresses can be prevented. Multiple values can be separated by a semicolon. For more information, see the following link:
...
BeispielExample:
| Code Block | ||
|---|---|---|
| ||
... |
...
"AllowedHosts": "connect.mycompany.com;localhost", |
...
... |
...
The “Connect” section (JSON
...
object)
Dieser Abschnitt fasst sämtliche This section summarizes all Connect Framework spezifischen Konfigurationen zusammenspecific configurations.
...
The “Connect/Server” section (JSON
...
Dieser Abschnitt enthält alle Einstellungen im Zusammenhang mit den integrierten Serverfunktionalitäten.
Der Abschnitt „BaseUri“ (JSON Wert vom Typ String)
Dieser Wert gib die Basis URI an, unter welcher der Connect Server von extern erreichbar ist. Die hier angegebene URI muss nicht zwangsläufig einem Endpoint der Webservers entsprechen, es kann sich auch um eine von extern erreichbare URI handeln, welche durch einen Router auf einen der Endpoints des Webservers weitergeleitet wird.
Wird dieser Wert auf “auto” gesetzt, so versucht der Server die Basis URI aus den Daten des ersten Webserver Endpoints automatisch zu ermitteln.
Der Abschnitt „Debug“ (JSON Objekt)
Dieser Abschnitt enthält Einstellungen zur Fehleranalyse. Derzeit werden folgende Einstellungen unterstützt:
...
Eigenschaft
...
Typ
...
Funktion
...
EnableHttpRequestLogging
...
Boolean
...
Aktiviert die Protokollierung aller eingehenden http-Anfragen.
Der Abschnitt „Passwords“ (JSON Objekt)
Dieser Abschnitt hat in der aktuellen Version des Connect Servers noch keine Funktionalität. In Zukünftigen Versionen können hier die Parameter für eine reversible Verschlüsselung der Passwörter für SSL-Zertifikate und Verbindungszeichenfolgen definiert werden, so dass diese nicht mehr im Klartext hinterlegt werden müssen.
Der Abschnitt „Paths“ (JSON Objekt)
In diesem Abschnitt können Variablen für die Benutzung in Dateipfaden definiert werden. Nachfolgende Variablen können bereits zuvor definierte Variablen verwenden. Unabhängig vom Betriebssystem muss stets das Zeichen „/“ als Trennzeichen zwischen Verzeichnissen verwendet werden.
Folgende Variablen sind vom Connect Framework vordefiniert, können jedoch redefiniert werden:
...
Variable
...
Standardwert
...
ApplicationPath
...
object)
This section contains all settings related to the integrated server functionalities.
The "BaseUri" section (JSON value of type String)
This value specifies the base URI under which the Connect server can be reached. The URI specified here does not necessarily have to correspond to an endpoint of the web server; it can also be an externally reachable URI that is forwarded by a router to one of the endpoints of the web server.
If this value is set to "auto", the server tries to determine the base URI automatically from the data of the first web server endpoint.
The "Debug" section (JSON object)
This section contains settings for error analysis. The following settings are currently supported:
Property | Type | Function |
EnableHttpRequestLogging | Boolean | Enables logging of all incoming http requests. |
The “Passwords” section (JSON object)
This section has no functionality in the current version of Connect Server. In future versions, the parameters for reversible encryption of the passwords for SSL certificates and connection strings can be defined here, so that they no longer need to be stored in plain text.
The “Paths” section (JSON object)
In this section variables for use in file paths can be defined. Subsequent variables can use previously defined variables. Regardless of the operating system, the "/" character must always be used as directory separator.
The following variables are predefined by the Connect Framework, but can be redefined:
Variable | Default value |
ApplicationPath | The installation directory of the Connect Server. |
CertificatePath | {ApplicationPath}/Certificates |
RepositoryPath | {ApplicationPath}/Repositories |
Diese Voreinstellungen werden immer dann verwendet, wenn kein anderer Variablenwert definiert oder wenn der Variable der Wert „auto“ zugewiesen wurde.
Zur Verwendung innerhalb eines Dateipfads müssen die Pfadvariablen in geschweifte Klammern gesetzt werden.
Der Abschnitt „Database“ (JSON Objekt)
Dieser Abschnitt enthält Konfigurationsdaten für die Verbindung zu den von der Applikation verwendeten Datenbanken. Für jede Datenbank muss ein untergeordnetes JSON Objekt angelegt werden, dessen Name der internen ID der zugehörigen Datenbank entspricht. Der Connect Server verwendet im Moment folgende Datenbanken:
...
Datenbank ID
...
Funktion
...
Identity
...
Benutzer und Berechtigungen des Identity Servers
...
Monitoring
...
Datenbank zur Sammlung von Monitoring-Daten
...
Operations
...
Datenbank zur Speicherung von Ablaufdaten
Für jede Datenbank können die folgenden Informationen hinterlegt werden:
...
Eigenschaft
...
Typ
...
Funktion
...
Type
...
String
...
Typ der Datenbank. Normalerweise wird hier “Sqlite” verwendet, ”SqlServer” wird aktuell experimentell unterstützt. Eine Unterstützung für “MySql” ist in Planung, derzeit ist jedoch die finale Implementierung der EF Core Adapter für .NET 5.0 noch nicht verfügbar.
...
ConnectionString
...
String
...
Die Verbindungszeichenfolge für die zu verwendete Datenbank.
...
LogLevel
...
String
...
Der gewünschte Detailgrad für Datenbank-spezifische Protokollausgaben. Es werden die Werte “Trace”, “Debug”, “Information”, “Warning” und “Error” unterstützt.
...
EnableSensitiveDataLogging
...
Boolean
...
Wird dieser Wert auf “true” gesetzt, so werden bei der Protokollierung auch Feldinhalte mit ausgegeben, andernfalls werden diese stets unterdrückt.
...
EnableDetailedErrors
...
Boolean
...
Wird dieser Wert auf “true” gesetzt, so werden bei der Protokollierung detaillierte Fehlermeldungen der Datenbank ausgegeben.
Der Abschnitt „SupportedLanguages“ (JSON Array mit Werten vom Typ String)
Dieser Abschnitt definiert die im Dialog zur Pflege von Sprachabhängigen Texte auswählbaren Sprachen. Hierbei werden sowohl generische Sprachschlüssel (wie „en“ oder „de“) als auch gebietsspezifische Sprachschlüssel (wie „en-US“, „en-UK“, „de-DE“ oder „de-AT“) unterstützt.
Der Abschnitt „Webserver“ (JSON Objekt)
Dieser Abschnitt dient zur Konfiguration des integrierten Webservers. Hier können folgende Werte hinterlegt werden:
...
Eigenschaft
...
Typ
...
Funktion
...
Type
...
String
Um den integrierten Webserver zu verwenden, sollte hier der Wert “Kestrel” stehen. Da es sich hierbei um die Standradeinstellung handelt, wird auch beim Fehlen dieser Eigenschaft der Wert “Kestrel” angenommen.
Unter Windows kann auch der Wert “IIS” verwendet werden. In diesem Fall wird der Modus für das Hosting innerhalb eines IIS aktiviert. Die hier konfigurierten Endpoints haben im IIS Modus keine Funktionalität, da diese über die Bindings im IIS definiert werden.
...
These defaults are always used if no other variable value is defined or if the variable has been assigned the value “auto”.
For use within a file path, the path variables must be enclosed in curly braces.
The “Database” section (JSON object)
This section contains configuration data for connecting to the databases used by the application. For each database, a child JSON object must be created whose name corresponds to the internal ID of the associated database. The Connect Server uses the following databases:
Database ID | Function |
Identity | Identity Server Users and Permissions |
Monitoring | Database for the collection of monitoring data |
Operations | Database for storing expiration data |
The following information can be stored for each database:
Property | Type | Function |
Type | String | Type of database. Normally "Sqlite" is used here, "SqlServer" is currently supported experimentally. Support for "MySql" is planned, but currently the final implementation of the EF Core Adapter for .NET 5.0 is not yet available. |
ConnectionString | String | The connection string for the database to use. |
LogLevel | String | The desired level of detail for database-specific log output. The values "Trace", "Debug", "Information", "Warning" and "Error" are supported. |
EnableSensitiveDataLogging | Boolean | If this value is set to "true", field contents are also output during logging, otherwise they are always suppressed. |
EnableDetailedErrors | Boolean | If this value is set to "true", detailed error messages from the database are output during logging. |
The “RetentionPeriods” section (JSON object)
For the Operations database, additional retention periods can be defined for workflow contexts. The periods are defined in a separate section "RetentionPeriods" and can contain the following information.
Property | Type | Function |
|---|---|---|
OpenContexts | Number | Retention period for uncompleted transactions in days. |
CompletedContexts | Number | Retention period for completed transactions in days. |
Example:
| Code Block |
|---|
...
"Operations": {
"RetentionPeriods": {
"OpenContexts": 3,
"CompletedContexts": 1
}
}
... |
The "SupportedLanguages" section (JSON array with values of type String)
This section defines the languages that can be selected in the dialog for maintaining language-dependent texts. Both generic language keys (such as "en" or "de") and region-specific language keys (such as "en-US", "en-UK", "de-DE" or "de-AT") are supported.
The "Webserver" section (JSON object)
This section is used to configure the integrated web server. The following values can be stored here:
Property | Type | Function |
Type | String | To use the integrated web server, use the value "Kestrel". Since this is the default setting, the value "Kestrel" is also used if this property is missing. On Windows, the value "IIS" can be used to enable hosting within IIS. In this scenario, the endpoints configured here are ignored, as these are defined via the bindings in IIS. You can find more information about hosting in IIS under the following link: https://docs.microsoft.com/en-us/aspnet/core/host-and-deploy/iis/?view=aspnetcore-5.0 |
RootPath | String |
Specifies the root directory of the web server. It is recommended not to change this value, as this may cause page effects when hosting the WebAssembly based frontend. | |
Endpoints | Array |
Dieses Array von JSON Objekten spezifiziert die Endpoints des integrierten Webservers. Die Eigenschaft “Uri” enthält die URI des gewünschten Endpoints. Schema und Host werden zwingend benötigt, die Angabe eines Ports ist optional. Ist kein Port angegeben, so werden die jeweiligen Standard-Ports (80 bei HTTP und 443 bei HTTPS) verwendet. Wird als Host keine IP-Adresse angegeben, so wird der angegebene Name mittels DNS Lockup in eine IP-Adresse umgewandelt. Die IP-Adressen 0.0.0.0 oder * stehen für alle verfügbaren IP-Adressen des Servers.
Bei der Verwendung von HTTPS muss zusätzlich die Eigenschaft “CertificateSource” angegeben werden, welche unterschiedliche Werte annehmen kann. Welcher Wert angegeben werden muss wird dadurch definiert, wo sich das Zertifikat befindet. Wenn sich das Zertifikat im Store befindet, muss der Wert dem Antragssteller entsprechen. Wenn z. B. der Antragssteller des Zertifikats “CN = localhost” lautet, muss der Wert für “CertificateSource” “localhost” lauten.
Es kann auch der direkte Pfad zu einem Zertifikat bzw. dessen Dateiname angegeben werden. Wird nur ein Dateiname angegeben, so wird diese in dem durch die Pfadvariable “CertificatePath” definierten Pfad gesucht. Hierfür kann der Wert z.B. wie “test.cer|” oder “test.cer|NochEinPassword” aussehen. Hierbei ist “test.cer” ist der Dateiname des Zertifikats und “NochEinPassword” das Passwort für den Zugriff auf den privaten Schlüssel des Zertifikats. Das Trennzeichen “|” ist obligatorische, egal ob ein Password eingetragen wird oder nicht. Falls es kein Password gibt, endet der Wert mit einem “|”.
Die Verwendung mehrerer Zertifikate am selben Endpoint wird derzeit nicht unterstützt. Ist ein Endpoint über verschiedene Hostnamen erreichbar, so müssen diese in einem Zertifikat aufgelistet sein. Wildcard-Zertifikate werden ohne Einschränkungen unterstützt.
Besonderheiten bei der Konfiguration des Identity Servers
In der Standardkonfiguration verwendet der Connect Server den Identity Server zur Authentifizierung und Autorisierung der Benutzer. Hierbei gibt es eine Konfigurationsvariante, welche vom Standard abweicht:
Wird innerhalb des Abschnitts „Key“ ein Wert mit dem Namen „AutoCreate“ und dem Wert „true“ erstellt, so wird, sofern die referenzierte Zertifikatdatei nicht vorhanden ist, beim Start ein selbstsigniertes Zertifikat generiert. Dieses Verhalten dient im Wesentlichen dazu, das der Server ohne manuelle Eingriffe in die Konfiguration gestartet werden kann.
Beispiel:
... "IdentityServer": { "Key": { "Type": "File", "FilePath": "connect.pfx", "Password": "Connect!", "AutoCreate": true },...
Ist im unter “CertificatePath” spezifizierten Verzeichnis keine Datei mit dem Namen “connect.pfx” vorhanden, so wird bei Start ein selbstsigniertes Zertifikat erstellt und unter diesem Namen gespeichert. Für die Verschlüsselung des privaten Schlüssels wird das hier hinterlegte Passwort „Connect!“ verwendet.
Beispielkonfiguration
Das folgende Beispiel zeigt die möglichen Connect-spezifischen Konfigurationseinstellungen:
...
This array of JSON objects specifies the endpoints of the integrated web server. The property "Uri" contains the URI of the desired endpoint. Schema and host are mandatory, the specification of a port is optional. If no port is specified, the respective default ports (80 for HTTP and 443 for HTTPS) are used. If no IP address is specified as the host, the specified name is converted into an IP address using DNS lockup. The IP addresses 0.0.0.0 or * represent all available IP addresses of the server. When using HTTPS, the property "CertificateSource" must also be specified, which can have different values. Which value must be specified is defined by where the certificate is located. If the certificate is located in the store, the value must correspond to the requestor. For example, if the requestor of the certificate is "CN = localhost", the value for "CertificateSource" must be "localhost". The direct path to a certificate or its file name can also be specified. If only a file name is specified, this is searched for in the path defined by the "CertificatePath" path variable. For this the value can be e.g. like "test.cer|" or "test.cer|NochEinPassword". Here "test.cer" is the filename of the certificate and "NochEinPassword" is the password to access the private key of the certificate. The separator "|" is mandatory, no matter if a password is entered or not. If there is no password, the value ends with a "|". The use of multiple certificates on the same endpoint is currently not supported. If an endpoint can be reached via different hostnames, these must be listed in a certificate. Wildcard certificates are supported without restrictions. |
Special considerations when configuring the Identity Server
In the default configuration, the Connect Server uses the Identity Server to authenticate and authorize users. There is one configuration variant that differs from the standard:
If a value with the name "AutoCreate" and the value "true" is created within the "Key" section, then, if the referenced certificate file does not exist, a self-signed certificate is generated at startup. This behavior is primarily intended to allow the server to start without manual configuration changes.
Example:
| Code Block | ||
|---|---|---|
| ||
...
"IdentityServer": {
"Key": {
"Type": "File",
"FilePath": "connect.pfx",
"Password": "Connect!",
"AutoCreate": true
},
... |
If there is no file with the name "connect.pfx" in the directory specified under "CertificatePath", a self-signed certificate is created at startup and stored using this name. The password "Connect!" specified here is used for the encryption of the private key.
Example configuration
The following example shows the possible Connect-specific configuration settings:
| Code Block | ||
|---|---|---|
| ||
... "Connect": { "Server": { "BaserUri": "connect.mycompany.com", |
...
"Debug": { |
...
"EnableHttpRequestLogging": false |
...
}, |
...
"Passwords": { |
...
"EnableEncryption": false, |
...
"EncryptionAlgorithm": "None", |
...
"EncryptionKey": "" |
...
}, |
...
"Paths": { |
...
"ApplicationPath": "auto", |
...
"CertificatePath": "{ApplicationPath}/Certificates", |
...
"RepositoryPath": "{ApplicationPath}/Repositories" |
...
}, |
...
"Database": { |
...
"Identity": { |
...
"Type": "Sqlite", |
...
"ConnectionString": "Data Source={RepositoryPath}/identity.db", |
...
"LogLevel": "Error", |
...
"EnableSensitiveDataLogging": false, |
...
"EnableDetailedErrors": false |
...
}, |
...
"Monitoring": { |
...
"Type": "Sqlite", |
...
"ConnectionString": "Data Source={RepositoryPath}/monitoring.db", |
...
"LogLevel": "Error", |
...
"EnableSensitiveDataLogging": false, |
...
"EnableDetailedErrors": false |
...
}, |
...
"Operations": { |
...
"Type": "Sqlite", |
...
"ConnectionString": "Data Source={RepositoryPath}/operations.db", |
...
"LogLevel": "Error", |
...
"EnableSensitiveDataLogging": false, |
...
"EnableDetailedErrors": false |
...
} |
...
}, |
...
"SupportedLanguages": [ "de", "en", "it", "es", "fr", "nl" ] |
...
, "Webserver": { |
...
"Type": "Kestrel", |
...
"RootPath": "{ApplicationPath}/wwwroot", |
...
"Endpoints": [ |
...
{ |
...
"Uri": "http://*:8080" |
...
}, |
...
{ |
...
"Uri": "https://*:8443", |
...
"CertificateSource": "certificate.pfx|" |
...
} |
...
] |
...
} |
...
} |
...
} |
...
... |
Übersteuerung von Konfigurationseinstellungen
Die in den JSON-Dateien hinterlegten Konfigurationseinstellungen können bei Bedarf übersteuert werden. Diese Vorgehensweise macht insbesondere bei der Automatisierung von Docker-basierten Umgebungen Sinn.
Übersteuerung mit Hilfe von Umgebungsvariablen
Um den Wert einer Konfigurationseinstellung zu übersteuern kann eine Umgebungsvariable mit dem Präfix “DOTNET_” oder “ASPNETCORE_” gefolgt vom Pfad der Einstellung in der JSON Datei definiert werden. Als Pfadtrennzeichen sollte hier ein doppelter Underscore (__) verwendet werden.
...
Overriding configuration settings
The configuration settings stored in the JSON files can be overridden if necessary. This approach makes sense especially when automating Docker-based environments.
Overriding using environment variables
To override the value of a configuration setting an environment variable can be defined with the prefix "DOTNET_" or "ASPNETCORE_" followed by the path to the setting in the JSON file. A double underscore (__) should be used as path separator.
You can find more information on this topic at the following link:
...
BeispielExample:
| Code Block | ||
|---|---|---|
| ||
SET DOTNET_Connect__Server__Webserver__Type=IIS |
Übersteuerung über die Kommandozeile
Bei Bedarf können Konfigurationen auch mit Hilfe von Schlüssel-Wert-Paaren als Kommandozeilenparameter übersteuert werden. Der Name entspricht hierbei dem Pfad der Einstellung, wobei das Zeichen „:“ als Pfadtrennzeichen verwendet wird. Die Angabe von Schlüssel-Wert-Paaren kann auf verschiedene Art und Weisen erfolgen:
<name1>=<wert1> <name2>=<wert2> …/<name1> <wert1> /<name2> <wert2> …--<name1> <wert1> --<name2> <wert2> …
...
Override via the command line
If required, configurations can also be overridden using key value pairs as command line parameters. The name here corresponds to the path to the setting using the ":" character as the path separator. Key value pairs can be specified in various ways:
<name1>=<value1> <name2>=<value2> .../<name1> <value1> /<name2> <value2> ...--<name1> <value1> --<name2> <value2> ...
You can find more information on this topic at the following link:
...
BeispielExample:
| Code Block | ||
|---|---|---|
| ||
GalileoGroup.Connect.Server.Backend.exe Connect:Server:Webserver:Type=IIS |