Configurazione e caricamento di OAuth
Prima di creare un connettore OAuth per un servizio o un'utilità di terze parti, è necessario caricare il relativo provider OAuth sul server ThingWorx Flow. Il modello di file JSON della configurazione OAuth di esempio è disponibile nel parametro oauthConfigurations del servizio LoadOAuthConfiguration in ThingWorx Composer. Di seguito è riportata una panoramica dettagliata del processo di caricamento di OAuth.
1. Creare un'app nel sistema di terze parti.
2. Recuperare la coppia ID client-segreto client dall'app e aggiungerla al file JSON della configurazione OAuth di esempio. Aggiungere i valori di eventuali ulteriori parametri necessari per la configurazione OAuth.
Per rimuovere le impostazioni di OAuth per un servizio o un'utilità di terze parti, è necessario rimuovere l'intero oggetto JSON. Ad esempio, per rimuovere le impostazioni di OAuth per Gmail, rimuovere il seguente oggetto JSON:
"google_gmail": {
"Gmail": {
"CLIENT_ID": "<Client ID>"
"CLIENT_SECRET": "<Secret>"
}
},
"Gmail": {
"CLIENT_ID": "<Client ID>"
"CLIENT_SECRET": "<Secret>"
}
},
Se è stato rimosso un oggetto JSON per un servizio o un'utilità di terze parti e si desidera aggiungere le relative impostazioni di OAuth in un secondo momento, aggiungere lo snippet di codice JSON dal modello di file JSON della configurazione OAuth di esempio e immettere i valori necessari per la configurazione OAuth.
 |
Il file di configurazione di esempio contiene
valori di configurazione dei connettori che rappresentano il servizio o l'utilità di terze parti. Ad esempio, per Gmail non modificare google_gmail nell'oggetto JSON. Per aggiungere più provider OAuth per Gmail, ad esempio Gmail-1 e Gmail-2, aggiungere il seguente oggetto JSON al file di esempio:
{
"google_gmail": { "Gmail-1": { "CLIENT_ID": "<client id for Gmail - 1 account here>", "CLIENT_SECRET": "<client secret for Gmail - 1 account here>" }, "Gmail-2": { "CLIENT_ID": "<client id for Gmail - 2 account here>", "CLIENT_SECRET": "<client secret for Gmail - 2 account here>" } } } |
3.
Eseguire il servizio LoadOAuthConfiguration da ThingWorx Composer per caricare il provider OAuth sul server ThingWorx Flow.
Nella tabella seguente sono riportati i servizi e le utilità per cui ThingWorx Flow supporta OAuth e i rispettivi valori di configurazione dei connettori:
|
Servizio o utilità
|
Valore di configurazione connettore
|
|---|---|
|
azure
|
|
|
bitly
|
|
|
box
|
|
|
dropbox
|
|
|
dynamics365
|
|
|
excel
|
|
|
github
|
|
|
google_gmail
|
|
|
google_drive
|
|
|
google_form
|
|
|
google_sheet
|
|
|
google_task
|
|
|
google_translator
|
|
|
integrity
|
|
|
odata
|
|
|
microsoft_365
|
|
|
onedrive
|
|
|
salesforce
|
|
|
servicemax
|
|
|
slack
|
|
|
soap
|
|
|
swagger
|
|
|
trello
|
|
|
windchill
|
|
|
youtube
|
|
|
zendesk
|
Configurazione e caricamento di OAuth per servizi e utilità
Azure
Attenersi alla procedura descritta di seguito ogni volta che si desidera aggiungere un provider OAuth per un'applicazione Azure.
Durante la creazione dell'applicazione impostare i valori appropriati dei parametri seguenti:
▪ Permessi API - Gestione del servizio Azure.
▪ URI di reindirizzamento - Immettere l'URL restituito di ThingWorx Flow nel formato https://<NomeHost:Porta>/Thingworx/Oauths/oauth/return.
2. Per aggiungere un provider OAuth per Azure, immettere i valori seguenti nel file JSON della configurazione OAuth:
|
Parametro
|
Descrizione
|
Valore
|
|---|---|---|
|
CLIENT_ID
|
Specifica l'identificatore client da utilizzare per la convalida dei token di accesso dal server di autorizzazione.
|
Recuperare il valore dall'applicazione Azure.
|
|
CLIENT_SECRET
|
Valore segreto del client.
|
Recuperare il valore dall'applicazione Azure.
|
"azure": {
"Azure": {
"CLIENT_SECRET": "<client secret here>",
"CLIENT_ID": "<client id here>"
}
}
"Azure": {
"CLIENT_SECRET": "<client secret here>",
"CLIENT_ID": "<client id here>"
}
}
3.
Eseguire il servizio LoadOAuthConfiguration da ThingWorx Composer per caricare il provider OAuth sul server ThingWorx Flow.
Bitly
Attenersi alla procedura descritta di seguito ogni volta che si desidera aggiungere un provider OAuth per un'app Bitly.
Durante la creazione dell'app impostare l'URI di reindirizzamento su un URL restituito di ThingWorx Flow nel formato https://<NomeHost:Porta>/Thingworx/Oauths/oauth/return.
2. Per aggiungere un provider OAuth per Bitly, immettere i valori seguenti nel file JSON della configurazione OAuth:
|
Parametro
|
Descrizione
|
Valore
|
|---|---|---|
|
CLIENT_ID
|
Specifica l'identificatore client da utilizzare per la convalida dei token di accesso dal server di autorizzazione.
|
Recuperare il valore dall'app Bitly.
|
|
CLIENT_SECRET
|
Valore segreto del client.
|
Recuperare il valore dall'app Bitly.
|
"bitly": {
"Bitly": {
"CLIENT_SECRET": "<client secret here>",
"CLIENT_ID": "<client id here>"
}
}
"Bitly": {
"CLIENT_SECRET": "<client secret here>",
"CLIENT_ID": "<client id here>"
}
}
3.
Eseguire il servizio LoadOAuthConfiguration da ThingWorx Composer per caricare il provider OAuth sul server ThingWorx Flow.
Box
Attenersi alla procedura descritta di seguito ogni volta che si desidera aggiungere un provider OAuth per un'app Box.
Durante la creazione dell'app impostare i valori appropriati dei parametri seguenti:
▪ Ambiti applicazione - Selezionare tutti gli ambiti.
▪ URI di reindirizzamento - Immettere l'URL restituito di ThingWorx Flow nel formato https://<NomeHost:Porta>/Thingworx/Oauths/oauth/return.
Nel video seguente vengono illustrati i passi necessari per attivare la configurazione OAuth per Box:
2. Per aggiungere un provider OAuth per Box, immettere i valori seguenti nel file JSON della configurazione OAuth:
Parametro | Descrizione | Valore |
|---|---|---|
CLIENT_ID | Specifica l'identificatore client da utilizzare per la convalida dei token di accesso dal server di autorizzazione. | Recuperare il valore dall'app Box. |
CLIENT_SECRET | Valore segreto del client. | Recuperare il valore dall'app Box. |
"box": {
"Box": {
"CLIENT_SECRET": "client secret here>",
"CLIENT_ID": "<client id here>"
}
}
"Box": {
"CLIENT_SECRET": "client secret here>",
"CLIENT_ID": "<client id here>"
}
}
3.
Eseguire il servizio LoadOAuthConfiguration da ThingWorx Composer per caricare il provider OAuth sul server ThingWorx Flow.
Dropbox
Attenersi alla procedura descritta di seguito ogni volta che si desidera aggiungere un provider OAuth per un'app Dropbox.
Durante la creazione dell'app impostare i valori appropriati per i parametri seguenti:
▪ API - Selezionare l'API di Dropbox.
▪ Tipo di accesso - Dropbox completo.
▪ URI di reindirizzamento - Immettere l'URL restituito di ThingWorx Flow nel formato https://<NomeHost:Porta>/Thingworx/Oauths/oauth/return.
2. Per aggiungere un provider OAuth per Dropbox, immettere i valori seguenti nel file JSON della configurazione OAuth:
Parametro | Descrizione | Valore |
|---|---|---|
CLIENT_ID | Specifica l'identificatore client da utilizzare per la convalida dei token di accesso dal server di autorizzazione. | Recuperare il valore dall'app Dropbox. |
CLIENT_SECRET | Valore segreto del client. | Recuperare il valore dall'app Dropbox. |
"dropbox": {
"Dropbox": {
"CLIENT_SECRET": "<client secret here>",
"CLIENT_ID": "<client id here>"
}
}
"Dropbox": {
"CLIENT_SECRET": "<client secret here>",
"CLIENT_ID": "<client id here>"
}
}
3.
Eseguire il servizio LoadOAuthConfiguration da ThingWorx Composer per caricare il provider OAuth sul server ThingWorx Flow.
Dynamics 365 CRM
Attenersi alla procedura descritta di seguito ogni volta che si desidera aggiungere un provider OAuth per un'applicazione Dynamics 365 CRM.
Durante la creazione dell'app impostare l'URI di reindirizzamento su un URL restituito di ThingWorx Flow nel formato https://<NomeHost:Porta>/Thingworx/Oauths/oauth/return.
2. Per aggiungere un provider OAuth per Dynamics 365 CRM, immettere i valori seguenti nel file JSON della configurazione OAuth:
Parametro | Descrizione | Valore |
|---|---|---|
CLIENT_ID | Specifica l'identificatore client da utilizzare per la convalida dei token di accesso dal server di autorizzazione. | Recuperare il valore dall'applicazione Azure. |
CLIENT_SECRET | Valore segreto del client. | Recuperare il valore dall'applicazione Azure. |
"dynamics365": {
"Dynamics365": {
"CLIENT_SECRET": "<client secret here>",
"CLIENT_ID": "<client id here>"
}
}
"Dynamics365": {
"CLIENT_SECRET": "<client secret here>",
"CLIENT_ID": "<client id here>"
}
}
3.
Eseguire il servizio LoadOAuthConfiguration da ThingWorx Composer per caricare il provider OAuth sul server ThingWorx Flow.
Excel Online, Office 365, OneDrive
Attenersi alla procedura descritta di seguito ogni volta che si desidera aggiungere un provider OAuth per un'applicazione Excel Online, Office 365 o OneDrive.
Durante la creazione dell'applicazione impostare i valori appropriati dei parametri seguenti:
▪ Permessi API - Gestione del servizio Azure.
▪ URI di reindirizzamento - Immettere l'URL restituito di ThingWorx Flow nel formato https://<NomeHost:Porta>/Thingworx/Oauths/oauth/return.
2. Per aggiungere un provider OAuth per Excel Online, Office 365 o OneDrive, immettere i valori seguenti nel file JSON della configurazione OAuth:
Parametro | Descrizione | Valore |
|---|---|---|
CLIENT_ID | Specifica l'identificatore client da utilizzare per la convalida dei token di accesso dal server di autorizzazione. | Recuperare il valore dall'applicazione Azure. |
CLIENT_SECRET | Valore segreto del client. | Recuperare il valore dall'applicazione Azure. |
Excel Online "excel": { "Excel Online": { "CLIENT_SECRET": "<client secret here>", "CLIENT_ID": "<client id here>" } } | Office 365 "microsoft_365": { "Office 365": { "CLIENT_SECRET": "<client secret here>", "CLIENT_ID": "<client id here>" } } | OneDrive "onedrive": { "OneDrive": { "CLIENT_SECRET": "<client secret here>", "CLIENT_ID": "<client id here>" } } |
3.
Eseguire il servizio LoadOAuthConfiguration da ThingWorx Composer per caricare il provider OAuth sul server ThingWorx Flow.
GitHub
Attenersi alla procedura descritta di seguito ogni volta che si desidera aggiungere un provider OAuth per un'app GitHub.
Durante la creazione dell'app impostare l'URL di callback di autorizzazione su un URL restituito di ThingWorx Flow nel formato https://<NomeHost:Porta>/Thingworx/Oauths/oauth/return.
2. Per aggiungere un provider OAuth per GitHub, immettere i valori seguenti nel file JSON della configurazione OAuth:
Parametro | Descrizione | Valore |
|---|---|---|
CLIENT_ID | Specifica l'identificatore client da utilizzare per la convalida dei token di accesso dal server di autorizzazione. | Recuperare il valore dall'app GitHub. |
CLIENT_SECRET | Valore segreto del client. | Recuperare il valore dall'app GitHub. |
"github": {
"Github": {
"CLIENT_SECRET": "<client secret here>",
"CLIENT_ID": "<client id here>"
}
}
"Github": {
"CLIENT_SECRET": "<client secret here>",
"CLIENT_ID": "<client id here>"
}
}
3.
Eseguire il servizio LoadOAuthConfiguration da ThingWorx Composer per caricare il provider OAuth sul server ThingWorx Flow.
Gmail, Google Drive, Moduli Google, Fogli Google, Google Tasks, Google Traduttore, YouTube
Attenersi alla procedura descritta di seguito ogni volta che si desidera aggiungere un provider OAuth per un'app Google.
Durante la creazione dell'app immettere l'URI di reindirizzamento come URL restituito di ThingWorx Flow, ad esempio https://<NomeHost:Porta>/Thingworx/Oauths/oauth/return.
2. Per aggiungere un provider OAuth per l'app Google, immettere i valori seguenti nel file JSON della configurazione OAuth:
Parametro | Descrizione | Valore |
|---|---|---|
CLIENT_ID | Specifica l'identificatore client da utilizzare per la convalida dei token di accesso dal server di autorizzazione. | Recuperare il valore dall'app Google. |
CLIENT_SECRET | Valore segreto del client. | Recuperare il valore dall'app Google. |
Gmail "google_gmail": { "Gmail": { "CLIENT_SECRET": "<client secret here>", "CLIENT_ID": "<client id here>" } } | Google Drive "google_drive": { "Google Drive": { "CLIENT_SECRET": "<client secret here>", "CLIENT_ID": "<client id here>" } } |
Moduli Google "google_form": { "Google Form": { "CLIENT_SECRET": "<client secret here>", "CLIENT_ID": "<client id here>" } } | Fogli Google "google_sheet": { "Google Sheet": { "CLIENT_SECRET": "<client secret here>", "CLIENT_ID": "<client id here>" } } |
Google Tasks "google_task": { "Google Tasks": { "CLIENT_SECRET": "<client secret here>", "CLIENT_ID": "<client id here>" } } | Google Traduttore "google_translator": { "Google Translator": { "CLIENT_SECRET": "<client secret here>", "CLIENT_ID": "<client id here>" } } |
Youtube "youtube": { "Youtube": { "CLIENT_SECRET": "<client secret here>", "CLIENT_ID": "<client id here>" } } |
3.
Eseguire il servizio LoadOAuthConfiguration da ThingWorx Composer per caricare il provider OAuth sul server ThingWorx Flow.
Integrity Lifecycle Manager
Attenersi alla procedura descritta di seguito ogni volta che si desidera aggiungere un provider OAuth per un server Integrity Lifecycle Manager.
2. Per aggiungere un provider OAuth per Integrity Lifecycle Manager, immettere i valori seguenti nel file JSON della configurazione OAuth:
Parametro | Descrizione | Valore |
|---|---|---|
CLIENT_ID | Specifica l'identificatore client da utilizzare per la convalida dei token di accesso dal server di autorizzazione. | Recuperare il valore dal client OAuth PingFederate. |
CLIENT_SECRET | Valore segreto del client. | Recuperare il valore dal client OAuth PingFederate. |
BASE_URL | Specifica l'URL OAuth PingFederate. | https://<FQDN Pingfederate>:<Porta>/as |
"integrity": {
"integrity": {
"CLIENT_SECRET": "<client secret here>",
"CLIENT_ID": "<client id here>",
"base_url": "<base url here>"
}
}
"integrity": {
"CLIENT_SECRET": "<client secret here>",
"CLIENT_ID": "<client id here>",
"base_url": "<base url here>"
}
}
3.
Eseguire il servizio LoadOAuthConfiguration da ThingWorx Composer per caricare il provider OAuth sul server ThingWorx Flow.
OData
Attenersi alla procedura descritta di seguito ogni volta che si desidera aggiungere un provider OAuth per l'istanza di OData.
1. Configurare OAuth nell'istanza di OData.
2. In base alla configurazione di OAuth, immettere i valori nel file JSON della configurazione OAuth. Fare riferimento al file
config.json di esempio. Di seguito sono riportati i valori di esempio che è possibile immettere per il caricamento di OAuth.
Parametro | Descrizione | Valore |
|---|---|---|
CLIENT_ID | Specifica l'identificatore client da utilizzare per la convalida dei token di accesso dal server di autorizzazione. | Recuperare il valore dall'applicazione OAuth. |
CLIENT_SECRET | Valore segreto del client. | Recuperare il valore dall'applicazione OAuth. |
VALIDATE_URL | Specifica l'URL utilizzato per convalidare il token di accesso. | Recuperare il valore dal client OAuth. |
REFRESH_URL | Specifica l'URL da utilizzare per ottenere i token di accesso. | Recuperare il valore dal client OAuth. |
TOKEN_URL | Fornisce il token di accesso. | Recuperare il valore dal client OAuth. |
AUTH_URL | Specifica l'endpoint OAuth per le richieste di token. | Recuperare il valore dal client OAuth. |
▪ Fornire le informazioni sull'intestazione nella matrice "oauth2_validate_headers", come illustrato nella matrice di esempio:
{
"oauth2_validate_headers": [
"{\"Authorization\":\"Bearer {access_token}\"}",
"{\"Content-Type\":\"application/json\"}"
]
}
"oauth2_validate_headers": [
"{\"Authorization\":\"Bearer {access_token}\"}",
"{\"Content-Type\":\"application/json\"}"
]
}
▪ Fornire le informazioni sull'ambito nella matrice "oauth2_params_scope", come illustrato nella matrice di esempio:
{
"oauth2_params_scope": [
"{\"READ\":\"READ_PRIVILEGES\"}"
]
}
"oauth2_params_scope": [
"{\"READ\":\"READ_PRIVILEGES\"}"
]
}
3.
Eseguire il servizio LoadOAuthConfiguration da ThingWorx Composer per caricare il provider OAuth sul server ThingWorx Flow.
SOAP
Attenersi alla procedura descritta di seguito ogni volta che si desidera aggiungere un provider OAuth per un'istanza di SOAP.
1. Configurare OAuth nell'istanza di SOAP.
2. In base alla configurazione di OAuth, immettere i valori nel file JSON della configurazione OAuth. Fare riferimento al file
config.json di esempio. Di seguito sono riportati i valori di esempio che è possibile immettere per il caricamento di OAuth.
Parametro | Descrizione | Valore |
|---|---|---|
CLIENT_ID | Specifica l'identificatore client da utilizzare per la convalida dei token di accesso dal server di autorizzazione. | Recuperare il valore dall'applicazione OAuth. |
CLIENT_SECRET | Valore segreto del client. | Recuperare il valore dall'applicazione OAuth. |
VALIDATE_URL | Specifica l'URL utilizzato per convalidare il token di accesso. | Recuperare il valore dal client OAuth. |
REFRESH_URL | Specifica l'URL da utilizzare per ottenere i token di accesso. | Recuperare il valore dal client OAuth. |
TOKEN_URL | Fornisce il token di accesso. | Recuperare il valore dal client OAuth. |
AUTH_URL | Specifica l'endpoint OAuth per le richieste di token. | Recuperare il valore dal client OAuth. |
▪ Fornire le informazioni sull'intestazione nella matrice "oauth2_validate_headers", come illustrato nella matrice di esempio:
{
"oauth2_validate_headers": [
"{\"Authorization\":\"Bearer {access_token}\"}",
"{\"Content-Type\":\"application/json\"}"
]
}
"oauth2_validate_headers": [
"{\"Authorization\":\"Bearer {access_token}\"}",
"{\"Content-Type\":\"application/json\"}"
]
}
▪ Fornire le informazioni sull'ambito nella matrice "oauth2_params_scope", come illustrato nella matrice di esempio:
{
"oauth2_params_scope": [
"{\"READ\":\"READ_PRIVILEGES\"}"
]
}
"oauth2_params_scope": [
"{\"READ\":\"READ_PRIVILEGES\"}"
]
}
3.
Eseguire il servizio LoadOAuthConfiguration da ThingWorx Composer per caricare il provider OAuth sul server ThingWorx Flow.
Salesforce
Attenersi alla procedura descritta di seguito ogni volta che si desidera aggiungere un provider OAuth per un'app Salesforce.
Durante la creazione dell'applicazione impostare i valori appropriati dei parametri seguenti:
▪ Ambiti - Fornire ambiti appropriati all'app.
▪ URL di callback - Immettere l'URL restituito di ThingWorx Flow, ad esempio https://<NomeHost:Porta>/Thingworx/Oauths/oauth/return.
2. Per aggiungere un provider OAuth per Salesforce, immettere i valori seguenti nel file JSON della configurazione OAuth:
Parametro | Descrizione | Valore |
|---|---|---|
CLIENT_ID | Specifica l'identificatore client da utilizzare per la convalida dei token di accesso dal server di autorizzazione. | Recuperare il valore dall'app Salesforce. |
CLIENT_SECRET | Valore segreto del client. | Recuperare il valore dall'app Salesforce. |
"salesforce": {
"Salesforce": {
"CLIENT_SECRET": "<client secret here>",
"CLIENT_ID": "<client id here>"
}
}
"Salesforce": {
"CLIENT_SECRET": "<client secret here>",
"CLIENT_ID": "<client id here>"
}
}
3.
Eseguire il servizio LoadOAuthConfiguration da ThingWorx Composer per caricare il provider OAuth sul server ThingWorx Flow.
Nel video seguente vengono illustrati i passi necessari per attivare la configurazione OAuth per Salesforce:
ServiceMax
Attenersi alla procedura descritta di seguito ogni volta che si desidera aggiungere un provider OAuth per un'app ServiceMax.
Durante la creazione dell'applicazione impostare i valori appropriati dei parametri seguenti:
▪ Ambiti - Fornire ambiti appropriati all'app.
▪ URL di callback - Immettere l'URL restituito di ThingWorx Flow, ad esempio https://<NomeHost:Porta>/Thingworx/Oauths/oauth/return.
2. Per aggiungere un provider OAuth per ServiceMax, immettere i valori seguenti nel file JSON della configurazione OAuth:
Parametro | Descrizione | Valore |
|---|---|---|
CLIENT_ID | Specifica l'identificatore client da utilizzare per la convalida dei token di accesso dal server di autorizzazione. | Recuperare il valore dall'app ServiceMax. |
CLIENT_SECRET | Valore segreto del client. | Recuperare il valore dall'app ServiceMax. |
"servicemax": {
"Servicemax": {
"CLIENT_SECRET": "<client secret here>",
"CLIENT_ID": "<client id here>"
}
}
"Servicemax": {
"CLIENT_SECRET": "<client secret here>",
"CLIENT_ID": "<client id here>"
}
}
3.
Eseguire il servizio LoadOAuthConfiguration da ThingWorx Composer per caricare il provider OAuth sul server ThingWorx Flow.
Slack
Attenersi alla procedura descritta di seguito ogni volta che si desidera aggiungere un provider OAuth per un'app Slack.
Durante la creazione dell'applicazione impostare i valori appropriati dei parametri seguenti:
▪ Ambiti - Fornire ambiti appropriati all'app.
▪ URL di reindirizzamento - Immettere l'URL restituito di ThingWorx Flow, ad esempio https://<NomeHost:Porta>/Thingworx/Oauths/oauth/return.
2. Per aggiungere un provider OAuth per Slack, immettere i valori seguenti nel file JSON della configurazione OAuth:
Parametro | Descrizione | Valore |
|---|---|---|
CLIENT_ID | Specifica l'identificatore client da utilizzare per la convalida dei token di accesso dal server di autorizzazione. | Recuperare il valore dall'app Slack. |
CLIENT_SECRET | Valore segreto del client. | Recuperare il valore dall'app Slack. |
"slack": {
"Slack": {
"CLIENT_SECRET": "<client secret here>",
"CLIENT_ID": "<client id here>"
}
}
"Slack": {
"CLIENT_SECRET": "<client secret here>",
"CLIENT_ID": "<client id here>"
}
}
3.
Eseguire il servizio LoadOAuthConfiguration da ThingWorx Composer per caricare il provider OAuth sul server ThingWorx Flow.
Swagger
Attenersi alla procedura descritta di seguito ogni volta che si desidera aggiungere un provider OAuth per un'istanza di Swagger.
1. Configurare OAuth nell'istanza di Swagger.
2. In base alla configurazione di OAuth, immettere i valori nel file JSON della configurazione OAuth. Fare riferimento al file
config.json di esempio. Di seguito sono riportati i valori di esempio che è possibile immettere per il caricamento di OAuth.
Parametro | Descrizione | Valore |
|---|---|---|
CLIENT_ID | Specifica l'identificatore client da utilizzare per la convalida dei token di accesso dal server di autorizzazione. | Recuperare il valore dall'applicazione OAuth. |
CLIENT_SECRET | Valore segreto del client. | Recuperare il valore dall'applicazione OAuth. |
VALIDATE_URL | Specifica l'URL utilizzato per convalidare il token di accesso. | Recuperare il valore dal client OAuth. |
REFRESH_URL | Specifica l'URL da utilizzare per ottenere i token di accesso. | Recuperare il valore dal client OAuth. |
TOKEN_URL | Fornisce il token di accesso. | Recuperare il valore dal client OAuth. |
AUTH_URL | Specifica l'endpoint OAuth per le richieste di token. | Recuperare il valore dal client OAuth. |
▪ Fornire le informazioni sull'intestazione nella matrice "oauth2_validate_headers", come illustrato nella matrice di esempio:
{
"oauth2_validate_headers": [
"{\"Authorization\":\"Bearer {access_token}\"}",
"{\"Content-Type\":\"application/json\"}"
]
}
"oauth2_validate_headers": [
"{\"Authorization\":\"Bearer {access_token}\"}",
"{\"Content-Type\":\"application/json\"}"
]
}
▪ Fornire le informazioni sull'ambito nella matrice "oauth2_params_scope", come illustrato nella matrice di esempio:
{
"oauth2_params_scope": [
"{\"READ\":\"READ_PRIVILEGES\"}"
]
}
"oauth2_params_scope": [
"{\"READ\":\"READ_PRIVILEGES\"}"
]
}
3.
Eseguire il servizio LoadOAuthConfiguration da ThingWorx Composer per caricare il provider OAuth sul server ThingWorx Flow.
Trello
Attenersi alla procedura descritta di seguito ogni volta che si desidera aggiungere un provider OAuth per un account Trello.
Nelle impostazioni, definire i valori appropriati per il parametro seguente:
▪ URL di reindirizzamento - Immettere l'URL restituito di ThingWorx Flow in Allowed Origins, ad esempio https://<NomeHost:Porta>/Thingworx/Oauths/oauth/return.
2. Per aggiungere un provider OAuth per Trello, immettere i valori seguenti nel file JSON della configurazione OAuth:
Parametro | Descrizione | Valore |
|---|---|---|
CONSUMER_KEY | Specifica la chiave utente da utilizzare per la convalida dei token di accesso dal server di autorizzazione. | |
CONSUMER_SECRET | Valore segreto utente. |
"trello": {
"Trello": {
"CONSUMER_SECRET": "<client secret here>",
"CONSUMER_KEY": "<client id here>"
}
}
"Trello": {
"CONSUMER_SECRET": "<client secret here>",
"CONSUMER_KEY": "<client id here>"
}
}
3.
Eseguire il servizio LoadOAuthConfiguration da ThingWorx Composer per caricare il provider OAuth sul server ThingWorx Flow.
Windchill
Attenersi alla procedura descritta di seguito ogni volta che si desidera aggiungere un provider OAuth per un server Windchill.
2. Per aggiungere un provider OAuth per Windchill, immettere i valori seguenti nel file JSON della configurazione OAuth:
Parametro | Descrizione | Valore |
|---|---|---|
CLIENT_ID | Specifica l'identificatore client da utilizzare per la convalida dei token di accesso dal server di autorizzazione. | Recuperare il valore dal client OAuth PingFederate. |
CLIENT_SECRET | Valore segreto del client. | Recuperare il valore dal client OAuth PingFederate. |
BASE_URL | Specifica l'URL OAuth PingFederate. | https://<FQDN Pingfederate>:<Porta>/as |
PF_IDP_ADAPTER_ID | Facoltativo. Specifica l'ID dell'adattatore IdP PingFederate della configurazione. Specificare solo se in PingFederate sono presenti più adattatori IdP. | PingFederateAdapterID |
RESOURCE_URL | Facoltativo. Specifica l'URL di Windchill. Si consiglia di specificare RESOURCE_URL durante la configurazione di OAuth. In caso contrario l'utente deve specificare RESOURCE_URL durante l'aggiunta di un connettore OAuth. | <protocollo>://<FQDN Windchill>:<Porta>/Windchill |
"windchill": {
"Windchill": {
"CLIENT_SECRET": "<client secret here>",
"CLIENT_ID": "<client id here>",
"base_url": "<base url here>"
}
}
"Windchill": {
"CLIENT_SECRET": "<client secret here>",
"CLIENT_ID": "<client id here>",
"base_url": "<base url here>"
}
}
3.
Eseguire il servizio LoadOAuthConfiguration da ThingWorx Composer per caricare il provider OAuth sul server ThingWorx Flow.
Zendesk
Attenersi alla procedura descritta di seguito ogni volta che si desidera aggiungere un provider OAuth per un'app Zendesk.
Durante la creazione dell'applicazione impostare i valori appropriati dei parametri seguenti:
▪ Ambiti - Fornire ambiti appropriati all'app.
▪ URL di reindirizzamento - Immettere l'URL restituito di ThingWorx Flow, ad esempio https://<NomeHost:Porta>/Thingworx/Oauths/oauth/return.
Nel video seguente vengono illustrati i passi necessari per attivare la configurazione OAuth per Zendesk:
2. Per aggiungere un provider OAuth per Zendesk, immettere i valori seguenti nel file JSON della configurazione OAuth:
Parametro | Descrizione | Valore |
|---|---|---|
CLIENT_ID | Specifica l'identificatore client da utilizzare per la convalida dei token di accesso dal server di autorizzazione. | Recuperare il valore dall'app Zendesk. |
CLIENT_SECRET | Valore segreto del client. | Recuperare il valore dall'app Zendesk. |
"zendesk": {
"Zendesk": {
"CLIENT_SECRET": "<client secret here>",
"CLIENT_ID": "<client id here>"
}
}
"Zendesk": {
"CLIENT_SECRET": "<client secret here>",
"CLIENT_ID": "<client id here>"
}
}
3.
Eseguire il servizio LoadOAuthConfiguration da ThingWorx Composer per caricare il provider OAuth sul server ThingWorx Flow.
Risoluzione dei problemi
Scenario | Soluzione | ||
|---|---|---|---|
Non è possibile aggiungere un provider OAuth se un connettore OAuth utilizza un provider OAuth esistente con lo stesso nome.
| • Aggiungere un nome di provider OAuth univoco e quindi caricare la configurazione OAuth. Ad esempio, se nella configurazione OAuth esiste Gmail-1, aggiungere Gmail-2 al file JSON della configurazione OAuth, come mostrato nel codice di esempio seguente: { "google_gmail": { "Gmail-1": { "CLIENT_ID": "<client id for Gmail - 1 account here>", "CLIENT_SECRET": "<client secret for Gmail - 1 account here>" }, "Gmail-2": { "CLIENT_ID": "<client id for Gmail - 2 account here>", "CLIENT_SECRET": "<client secret for Gmail - 2 account here>" } } } OPPURE • Eliminare tutti i connettori che utilizzano il provider OAuth esistente, caricare nuovamente il provider OAuth, quindi riavviare il servizio OAuth. Per riavviare il servizio OAuth, attenersi alla procedura descritta di seguito. 1. Nel sistema in cui è installato ThingWorx Flow, avviare il prompt dei comandi come amministratore. 2. Eseguire il comando pm2 ls per ottenere il numero del servizio OAuth. 3. Eseguire il comando pm2 restart <numero_servizio_OAuth> per riavviare il server OAuth. OPPURE Nel sistema in cui è installato ThingWorx Flow avviare il prompt dei comandi come amministratore ed eseguire il comando pm2 restart flow-oauth-server per riavviare il server OAuth. |