|
Non creare un oggetto dal modello di oggetto IntegrationRuntime.
|
|
-Dencrypted.config.file=true è necessario negli esempi riportati di seguito se si sta crittografando l'intero file di configurazione; deve puntare al file di configurazione di Integration Runtime crittografato. Se si stanno crittografando solo le voci nel file, omettere l'impostazione o impostarla su false.
|
Impostazione
|
Default
|
Descrizione
|
---|---|---|
traceRoutes
|
false
|
Specifica se l'esecuzione dell'instradamento deve registrare messaggi di log quando viene richiamato ciascun processo nell'instradamento.
|
Thingworx
|
Specifica le impostazioni per effettuare la connessione a ThingWorx Platform in formato JSON.
|
|
SSL
|
Specifica le impostazioni SSL (Secure Sockets Layer) in formato JSON.
|
Impostazione
|
Default
|
Descrizione
|
||
---|---|---|---|---|
appKey
|
Specifica la chiave di accesso di ThingWorx Platform configurata per l'utilizzo da parte di questo Integration Runtime. È possibile sostituire questa impostazione con una proprietà del sistema Java.
|
|||
basePath
|
/Thingworx
|
Specifica il percorso di base nell'URI di ThingWorx Platform. È possibile sostituire questa impostazione con una proprietà del sistema Java.
|
||
host
|
localhost
|
Specifica l'host nell'URI di ThingWorx Platform. È possibile sostituire questa impostazione con una proprietà del sistema Java.
|
||
port
|
443
|
Specifica la porta nell'URI di ThingWorx Platform. È possibile sostituire questa impostazione con una proprietà del sistema Java.
|
||
sslEnable
|
true
|
Specifica se è necessario utilizzare SSL per la connessione a ThingWorx Platform tramite WebSocket. Se true, per l'URI viene utilizzato il protocollo "wss". In caso contrario viene utilizzato il protocollo "ws".
|
||
ignoreSSLErrors
|
false
|
Specifica se è necessario ignorare gli errori SSL. In un ambiente di produzione, questo valore non deve essere impostato su true.
|
Impostazione
|
Default
|
Descrizione
|
---|---|---|
verbose
|
false
|
Specifica se il protocollo handshake Java restituisce messaggi dettagliati. Se true, la proprietà del sistema Java javax.net.debug è impostata su ssl:handshake:verbose.
|
Keystore
|
Specifica le impostazioni keystore SSL in formato JSON.
|
|
Truststore
|
Specifica le impostazioni truststore SSL in formato JSON.
|
Impostazione
|
Descrizione
|
---|---|
path
|
Specifica il percorso al file keystore SSL. L'utilizzo di questa impostazione è equivalente all'impostazione della proprietà javax.net.ssl.keyStore del sistema Java.
|
password
|
Specifica la password per il file keystore SSL. L'utilizzo di questa impostazione è equivalente all'impostazione della proprietà javax.net.ssl.keyStorePassword del sistema Java. Per evitare di memorizzare la password come testo semplice, utilizzare il valore encrypt.keystore.password. Vedere la sezione Impostazioni di crittografia delle password riportata di seguito.
|
Impostazione
|
Descrizione
|
---|---|
path
|
Specifica il percorso al file truststore SSL. L'utilizzo di questa impostazione è equivalente all'impostazione della proprietà javax.net.ssl.trustStore del sistema Java.
|
password
|
Specifica la password per il file truststore SSL. L'utilizzo di questa impostazione è equivalente all'impostazione della proprietà javax.net.ssl.trustStorePassword del sistema Java. Per evitare di memorizzare la password come testo semplice, utilizzare il valore encrypt.truststore.password. Vedere la sezione Impostazioni di crittografia delle password riportata di seguito.
|
Impostazione
|
Default
|
Descrizione
|
---|---|---|
MaximumRetries
|
2
|
Specifica il numero di nuovi tentativi da eseguire per una richiesta non riuscita a causa della mancata disponibilità del sistema.
In caso di richieste HTTP, i tentativi si verificano con una risposta 503 dal server.
|
RetryDelay
|
1000
|
Quando una richiesta ha esito negativo ma può essere ripetuta, RetryDelay rappresenta l'intervallo di attesa, in millisecondi, prima di un nuovo tentativo. RetryDelay viene utilizzata insieme a BackoffMultiplier per determinare i tentativi successivi.
|
BackoffMultiplier
|
1
|
Specifica il numero per cui deve essere moltiplicato il valore di RetryDelay nei tentativi successivi. Ad esempio, se BackoffMultiplier è impostata su2 e MaximumRetries è impostata su 3, il primo tentativo viene eseguito dopo 1 secondo; il secondo tentativo 2 secondi dopo il primo; il terzo 4 secondi dopo e così via.
|
UnauthorizedRetries
|
2
|
Specifica il numero di nuovi tentativi da eseguire per una richiesta non riuscita a causa di una richiesta non autorizzata. Questa impostazione si applica a una richiesta HTTP con una risposta 401 dal server.
|
Impostazione
|
Default
|
Descrizione
|
---|---|---|
MaximumRedirects
|
3
|
Specifica il numero di nuovi tentativi da eseguire per un reindirizzamento.
|
EnableRedirect
|
true
|
Specifica se il reindirizzamento è attivato per le richieste che restituiscono un codice di stato di reindirizzamento 3xx.
|
|
È possibile memorizzare il file di configurazione crittografato in qualsiasi posizione. È solo necessario assicurarsi che il file di configurazione della crittografia e le variabili di ambiente indichino il percorso corretto.
|
|
Il contenuto di integrationRuntime-settings.json.decrypted deve corrispondere al contenuto del file integrationRuntime-settings.json originale.
|
|
Rimuovere le versioni non crittografate del file.
|
Configurazione di ThingWorx
|
Impostazioni di Integration Runtime
|
---|---|
ThingWorx non è configurato per SSL.
|
Specificare thingworxUri utilizzando una proprietà del sistema Java e utilizzare il protocollo ws o specificare sslEnable=false nelle impostazioni SSL.
|
ThingWorx è configurato per SSL mediante certificato autofirmato.
|
Specificare sslEnable=true e ignoreSSLErrors=true nelle impostazioni SSL.
|
ThingWorx è configurato per SSL con un certificato autofirmato e il certificato è attendibile.
ThingWorx è configurato per SSL con un certificato firmato da un'autorità di certificazione (CA) e non è stato configurato per fornire l'intera catena di certificati CA.
|
Esportare il certificato dal file keystore e importarlo in un file truststore.
Specificare enable=true e Trustore nelle impostazioni SSL.
La password truststore potrebbe essere crittografata.
In alternativa, aggiungere il certificato al truststore di default JVM di Integration Runtime, generalmente disponibile in questo percorso:$JAVA_HOME/lib/security/cacerts. In questo caso non è necessario specificare esplicitamente il truststore nelle impostazioni SSL.
|
ThingWorx è configurato per SSL con un certificato firmato da un'autorità di certificazione (CA) ed è stato configurato per fornire l'intera catena di certificati CA.
|
Specificare enable=true nelle impostazioni SSL. Questa è l'impostazione di default.
|
Impostazione
|
Default
|
Descrizione
|
---|---|---|
logs.dir
|
Specifica la posizione in cui i file di log vengono generati. Il valore di default è la directory di lavoro corrente.
|
|
logs.maxFileSize
|
5MB
|
Specifica la dimensione del file di log massima che attiva un'azione di rollover per un nuovo file di log.
|
logs.maxIndex
|
9
|
Specifica l'indice massimo della finestra di rollover a dimensione fissa. L'indice iniziale inizia a 1.
|
logs.timestampPattern
|
aaaa-gg-MM HH.mm.ss.SSS
|
Specifica l'espressione di data e ora da utilizzare per ogni evento di log.
|
logs.uniqueId
|
<processId>
|
Specifica un valore che viene aggiunto al nome del file di log. Questa impostazione è utilizzata per generare nomi di file univoci. Il valore di default è ottenuto tramite un callback Java per restituire l'ID del processo di JVM.
|