Configurazione dell'accesso pubblico a ThingWorx

In Vuforia Studio, le esperienze contenute in un progetto pubblicato possono essere rese accessibili pubblicamente impostando la proprietà Accesso del progetto su Pubblico. In questo modo, il contenuto pubblicato in Experience Service diventa accessibile senza bisogno di autenticazione. Se le esperienze pubbliche richiedono l'accesso ai dati in ThingWorx, Experience Service deve essere configurato in modo da consentire alle esperienze pubbliche di accedere a ThingWorx in forma anonima.

Experience Service funge da proxy per il server ThingWorx. Quando un'esperienza invia a ThingWorx una richiesta di recupero del valore di una proprietà o di richiamo di un servizio, la richiesta viene prima instradata attraverso Experience Service. Se l'esperienza è pubblica, il proxy di Experience Service aggiunge una chiave di accesso alla richiesta prima di inoltrarla al server ThingWorx. La chiave di accesso identifica le credenziali ThingWorx utilizzate per eseguire la richiesta. È necessario configurare Experience Service con una chiave di accesso appropriata affinché alle esperienze venga concesso il necessario accesso pubblico a ThingWorx.

Se un'esperienza fornisce dati da ThingWorx, è necessario che venga concesso anche l'accesso pubblico ai dati in ThingWorx.

Quando si configura il server ThingWorx nel programma di installazione, se si sceglie l'opzione Configura l'accesso pubblico al server ThingWorx Core, la configurazione della chiave di accesso per l'accesso pubblico descritta in questa sezione viene completata automaticamente dal programma di installazione. Se si decide di creare manualmente la chiave di accesso, attenersi alle istruzioni riportate di seguito.

Per consentire l'accesso delle esperienze pubbliche a ThingWorx senza richiedere agli utenti di eseguire l'autenticazione, Experience Service e il server ThingWorx associato devono essere configurati in modo da consentire l'accesso pubblico. Per consentire l'accesso pubblico a ThingWorx, è necessario creare in ThingWorx una chiave di accesso che possa essere utilizzata per accedere a tutte le proprietà o tutti i servizi in ThingWorx richiesti dalle esperienze pubblicamente connesse. Per creare la chiave di accesso necessaria in ThingWorx, attenersi alla procedura riportata di seguito.

4. Configurare l'utente in modo che disponga dei permessi necessari ad accedere ai dati ThingWorx richiesti dalle esperienze pubbliche. Per ulteriori informazioni sui permessi che devono essere concessi all'utente es-public-access, vedere la sezione "Autorizzazione dell'utente" disponibile di seguito.

5. Configurare l'organizzazione es-public-access-org in modo che disponga dei permessi di visibilità necessari per accedere ai dati ThingWorx richiesti dalle esperienze pubbliche. Per ulteriori informazioni sui permessi di visibilità che devono essere concessi all'organizzazione es-public-access-org, vedere la sezione "Autorizzazione dell'utente" disponibile di seguito.

6. Creare una chiave di accesso e associarla all'utente es-public-access. Per ulteriori informazioni, vedere Generare una chiave di accesso.

7. Modificare il file configuration.json che si trova nella directory di installazione di Experience Service e impostare come valore del parametro proxies.0.appKey un valore uguale a quello della proprietà keyId della chiave di accesso creata al passo 6.

Quando si configura il server ThingWorx nel programma di installazione, se si sceglie l'opzione Configura accesso pubblico al server ThingWorx Core, la configurazione del controllo di accesso descritta in questa sezione viene completata automaticamente dal programma di installazione. Le istruzioni sono incluse nel caso in cui si decida di configurare manualmente i permessi richiesti.

Per consentire agli utenti di esperienze pubbliche di accedere alle proprietà e ai servizi richiesti in ThingWorx, è necessario concedere all'utente es-public-access definito in precedenza i seguenti permessi in ThingWorx per le connessioni WebSocket:

Per ulteriori informazioni in merito alla concessione di tali permessi, vedere la sezione "Attivazione delle connessioni WebSocket" in Concessione di permessi agli utenti.

La presente sezione illustra i permessi che devono essere concessi per consentire agli utenti delle esperienze pubbliche connesse di accedere a proprietà, servizi ed eventi ThingWorx richiesti da dette esperienze. Poiché ogni esperienza presenta i propri requisiti specifici per l'accesso a proprietà, servizi ed eventi ThingWorx, la configurazione descritta in questa sezione non viene eseguita dal programma di installazione e deve essere completata manualmente.

Per consentire agli utenti di esperienze pubbliche di accedere a proprietà, servizi ed eventi ThingWorx utilizzati dalle esperienze pubbliche connesse, è necessario concedere all'utente es-public-access definito in precedenza i seguenti permessi in ThingWorx:

• Lettura proprietà in fase di esecuzione - Permesso per le proprietà aggiuntive i cui valori sono visualizzati in un'esperienza pubblica

• Scrittura proprietà in fase di esecuzione - Permesso per le proprietà aggiuntive i cui valori sono modificati in un'esperienza pubblica

Per ulteriori informazioni in merito alla concessione di tali permessi, vedere la sezione "Attivazione dell'accesso a proprietà, servizi ed eventi" in Concessione di permessi agli utenti.