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 Terratwin-Admin konfigurierbar und sollten nur von Systemadministratoren bearbeitet werden.

      • [..]
      • settings.json
  • Beispielkonfiguration

    {
    	"licenseKey": "40c10a4e-71d2-4892-b6e1-faa5a693e16f",
    	// Bitte nur eine Variante von licenseKey verwenden.
    	// Entweder als einfacher String oder als Array von Objekten.
    	"licenseKey": [
    		{
    			"hostname": "example.com",
    			"key": "40c10a4e-71d2-4892-b6e1-faa5a693e16f"
    		},
    		{
    			"hostname": "example.de",
    			"key": "b1c2d3e4-f5g6-7890-h1i2-j3k4l5m6n7o8"
    		}
    	],
    	"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": ["example.com", "example.de"],
    		"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 Terratwin-Admin 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 die API und den Scheduler. 10 = Debug, 20 = Info, 30 = Warn, 40 = Error, 50 = Critical.