latest
⚙️ Administration
Systemeinstellungen

Systemeinstellungen

In den Systemeinstellungen können Sie grundlegende Einstellungen für die Terratwin-API vornehmen. Dazu gehören die Einrichtung der Lizenz, der Zugriffsinformationen für die ArcGIS-Plattform und konfigurieren von Sicherheitseinstellungen.

⚠️ Nehmen Sie Änderungen an den Systemeinstellungen nur mit Bedacht vor. Einige der Einstellungen sind aus Sicherheitsgründen nicht im Web über das Admin Panel konfigurierbar und sollten nur von Systemadministratoren bearbeitet werden.

      • [..]
      • settings.json
  • Beispielkonfiguration

    {
    	"licenseKey": "40c10a4e-71d2-4892-b6e1-faa5a693e16f",
    	"root_path": "path/to/terratwin",
    	"credentials": [
    		{
    			"portalUrl": "https://www.arcgis.com",
    			"appId": "YOUR_APP_ID",
    			"username": "terratwin-admin",
    			"password": "YOUR_HASHED_PASSWORD"
    		}
    	],
    	"security": {
    		"allowed_hosts": [],
    		"max_file_size": 1048576,
    		"rate_limit_get": 5000,
    		"rate_limit_post": 500,
    		"time_window": 60,
    		"token_expiration": 30,
    		"refresh_token_expiration": 1440,
    		"headers": [
    			{
    				"name": "Content-Security-Policy",
    				"value": "default-src 'self'"
    			},
    			{
    				"name": "X-Content-Type-Options",
    				"value": "nosniff"
    			},
    			{
    				"name": "Referrer-Policy",
    				"value": "same-origin"
    			},
    			{
    				"name": "X-Frame-Options",
    				"value": "DENY"
    			},
    			{
    				"name": "Strict-Transport-Security",
    				"value": "max-age=31536000; includeSubDomains"
    			},
    			{
    				"name": "Permissions-Policy",
    				"value": "camera=(), microphone=(), geolocation=()"
    			},
    			{
    				"name": "Cross-Origin-Resource-Policy",
    				"value": "same-origin"
    			}
    		]
    	},
    	"scheduler": {
    		"startup_delay": 10,
    		"loglevel": 10
    	}
    }

    Parameter

    EigenschaftTypBeschreibung
    licenseKeyString, Array <Object>Lizenzschlüssel für Terratwin. Hier kann der Lizenzschlüssel als einfacher Wert angegebenen werden. Für bestimmte Bereitstellungsszenarien kann hier alternativ eine Liste mit key und hostname konfiguriert werden.
    root_pathStringPfad zum Terratwin-Verzeichnis
    credentialsArrayListe von Zugriffsinformationen für die ArcGIS-Plattform. Der erste Eintrag definiert das primäre Portal für Terratwin.
    securityObjektKonfiguration der Sicherheitseinstellungen für die API.
    schedulerObjektKonfiguration des Schedulers für die API.

    Details zu security

    EigenschaftTypBeschreibung
    allowed_hostsArrayListe von erlaubten Hostnamen, die für den Zugriff auf die Terratwin-API autorisiert sind. Laufen Terratwin-Client und das Admin Panel auf demselben Host, ist keine Eintragung hier erforderlich.
    max_file_sizeNumberMaximale Dateigröße bei Uploadvorgängen in Byte.
    rate_limit_getNumberMaximale Anzahl der GET-Anfragen pro Zeitfenster von einer IP.
    rate_limit_postNumberMaximale Anzahl der POST-Anfragen pro Zeitfenster von einer IP.
    time_windowNumberZeitfenster in Sekunden für die Rate-Limitierung.
    token_expirationNumberGültigkeitsdauer eines Tokens in Minuten.
    refresh_token_expirationNumberGültigkeitsdauer eines Refresh-Tokens in Minuten.
    headersArrayListe von HTTP-Headern, die in den Antworten gesetzt werden. Ändern Sie diese Einträge nur in Sonderfällen.

    Details zu scheduler

    EigenschaftTypBeschreibung
    startup_delayNumberVerzögerung in Sekunden, bevor der Scheduler gestartet wird.
    loglevelNumberLog-Level für den Scheduler. 10 = Debug, 20 = Info, 30 = Warn, 40 = Error, 50 = Critical.