Swagger
Il connettore Swagger supporta un file Swagger con i tipi di autenticazione seguenti: base, OAuth e con chiave di accesso. Questo connettore supporta le specifiche
OpenAPI 2.0 e
OpenAPI 3.0.
Versione della release del connettore
Il connettore Swagger è ora disponibile nella release 8.4.3.
Azione supportata
Trigger supportati
Nessuno
Autorizzazioni supportate
Il connettore Swagger supporta la seguente autorizzazione:
• Nessuno
• Base
• OAuth
 |
Prima di aggiungere una connessione OAuth, seguire la procedura che illustra
come ottenere ID e segreti client per Swagger.
|
• Chiave di accesso
Autorizzare Swagger
Per ogni azione del connettore Swagger è necessario eseguire l'autorizzazione di Swagger. Nell'elenco degli schemi di autenticazione, selezionare uno degli schemi di autorizzazione:
• Nessuna - Specificare l'URL del file Swagger, ad esempio https://petstore.swagger.io/v2/swagger.json
• Base - Per aggiungere una connessione di base, attenersi alla procedura descritta di seguito.
1. Nell'elenco degli schemi di autenticazione, selezionare Base.
2. Nel campo Swagger Connection, fare clic su Aggiungi nuovo.
3. Nella finestra Aggiungi connessione immettere i dettagli seguenti:
▪ Etichetta connessione - Completato automaticamente. È possibile scegliere l'etichetta di connessione desiderata.
|
|
Alle etichette viene applicata la distinzione tra maiuscole e minuscole. Non utilizzare spazi, alcuni caratteri speciali e numeri iniziali.
|
▪ URL Swagger - URL del file Swagger.json.
▪ Nome utente - Nome utente per l'applicazione di destinazione.
▪ Password - Password per l'applicazione di destinazione.
4. Fare clic su AGGIUNGI. All'elenco viene aggiunta una nuova autorizzazione.
• OAuth - Per aggiungere una connessione OAuth, eseguire le operazioni descritte di seguito.
Prerequisito: prima di aggiungere una nuova connessione OAuth, assicurarsi di seguire i passi descritti nella sezione Swagger nell'argomento
Configurazione delle impostazioni di OAuth per connettori.
1. Nell'elenco degli schemi di autenticazione, selezionare OAuth.
2. Nel campo OAuth Swagger, fare clic su Add new Swagger login.
3. Nella finestra Parametri, immettere l'URL nel campo Swagger URL, quindi fare clic su CONSENTI. Viene visualizzata la finestra Aggiungi autorizzazione.
4. Nella finestra Aggiungi autorizzazione, modificare il campo Etichetta autorizzazione, se necessario, quindi immettere l'URL della risorsa.
5. Fare clic su AGGIUNGI.
• Chiave di accesso - Per aggiungere una nuova connessione con chiave di accesso, attenersi alla procedura descritta di seguito.
1. Nell'elenco degli schemi di autenticazione, selezionare Chiave di accesso.
2. Nel campo Swagger AppKey, fare clic su Aggiungi nuovo.
3. Nella finestra Aggiungi connessione immettere i dettagli seguenti:
▪ Etichetta connessione - Completato automaticamente. È possibile scegliere l'etichetta di connessione desiderata.
|
|
Alle etichette viene applicata la distinzione tra maiuscole e minuscole. Non utilizzare spazi, alcuni caratteri speciali e numeri iniziali.
|
▪ URL Swagger - URL del file Swagger.json, ad esempio https://petstore.swagger.io/v2/swagger.json
▪ Chiave di accesso - Immettere la chiave di accesso per il connettore Swagger.
4. Fare clic su AGGIUNGI.
|
|
Fare clic su TEST per convalidare l'autorizzazione.
|
Limitazioni del connettore Swagger
• Nella specifica OpenAPI 3.0, il campo server presenta un'opzione per definire più URL di base. L'implementazione corrente non supporta questa opzione, ma il primo URL di base viene recuperato dalla matrice del server.
• Nella richiesta sono consentiti i seguenti tipi: application/json e application/x-www-form-urlencoded. I carattere jolly non sono ammessi. Per la risposta è consentito il tipo application/json.
• Il caricamento o il download di file o immagini non è supportato.
• I dati di modulo o multiparte non sono supportati.
• Il metodo di serializzazione dei parametri è di default per tutti i parametri.
• L'utilizzo di "one of", "anyOf", "allOf" e "not" non è supportato nel campo Tipo.
• L'autenticazione multipla non è consentita. Tutte le API devono avere un'autenticazione simile.