Creare una connessione di base SFTP utilizzando Flow Service API

Una connessione di base rappresenta la connessione autenticata tra un'origine e Adobe Experience Platform.

Questo tutorial illustra i passaggi necessari per creare una connessione di base per SFTP (Secure File Transfer Protocol) tramite il Flow Service API.

Introduzione

Questa guida richiede una buona conoscenza dei seguenti componenti di Adobe Experience Platform:

  • Sorgenti: un Experience Platform consente di acquisire dati da varie origini, consentendoti allo stesso tempo di strutturare, etichettare e migliorare i dati in arrivo tramite i servizi di Platform.
  • Sandbox: Experience Platform fornisce sandbox virtuali che permettono di suddividere una singola istanza Platform in ambienti virtuali separati, utili per le attività di sviluppo e aggiornamento delle applicazioni di esperienza digitale.
IMPORTANTE

Si consiglia di evitare il ritorno a capo o a nuove righe durante l’acquisizione di oggetti JSON con un SFTP connessione sorgente. Per aggirare il limite, utilizza un singolo oggetto JSON per riga e utilizza più righe per i file successivi.

Le sezioni seguenti forniscono informazioni aggiuntive che è necessario conoscere per connettersi correttamente a un SFTP server che utilizza Flow Service API.

Raccogli le credenziali richieste

Per ottenere Flow Service per connettersi a SFTP, è necessario fornire valori per le seguenti proprietà di connessione:

Credenziali Descrizione
host Nome o indirizzo IP associato al SFTP server.
port Porta del server SFTP a cui ti stai connettendo. Se non specificato, il valore predefinito è 22.
username Il nome utente con accesso al SFTP server.
password La password per SFTP server.
privateKeyContent Il contenuto della chiave privata SSH con codifica Base64. Il tipo di chiave OpenSSH deve essere classificato come RSA o DSA.
passPhrase La passphrase o password per decrittografare la chiave privata se il file di chiave o il contenuto della chiave è protetto da una passphrase. Se il privateKeyContent è protetto da password, questo parametro deve essere utilizzato con la passphrase del contenuto della chiave privata come valore.
maxConcurrentConnections Questo parametro consente di specificare un limite massimo per il numero di connessioni simultanee che Platform creerà durante la connessione al server SFTP. Devi impostare questo valore su un valore inferiore al limite impostato da SFTP. Nota: quando questa impostazione è abilitata per un account SFTP esistente, influirà solo sui flussi di dati futuri e non sui flussi di dati esistenti.
folderPath Percorso della cartella a cui desideri fornire l’accesso. SFTP origine, è possibile fornire il percorso della cartella per specificare l'accesso utente alla sottocartella desiderata.
connectionSpec.id La specifica di connessione restituisce le proprietà del connettore di un'origine, incluse le specifiche di autenticazione relative alla creazione delle connessioni di base e di origine. ID della specifica di connessione per SFTP è: b7bf2577-4520-42c9-bae9-cad01560f7bc.

Utilizzo delle API di Platform

Per informazioni su come effettuare correttamente chiamate alle API di Platform, consulta la guida su introduzione alle API di Platform.

Creare una connessione di base

Una connessione di base mantiene le informazioni tra l’origine e Platform, incluse le credenziali di autenticazione dell’origine, lo stato corrente della connessione e l’ID univoco della connessione di base. L’ID della connessione di base consente di esplorare e navigare tra i file dall’interno dell’origine e identificare gli elementi specifici che desideri acquisire, comprese le informazioni relative ai tipi di dati e ai formati.

Il SFTP l'origine supporta sia l'autenticazione di base che l'autenticazione tramite la chiave pubblica SSH. Durante questo passaggio, puoi anche designare il percorso della sottocartella a cui desideri fornire l’accesso.

Per creare un ID di connessione di base, effettua una richiesta POST al /connections endpoint durante la fornitura del SFTP credenziali di autenticazione come parte dei parametri della richiesta.

IMPORTANTE

Il SFTP il connettore supporta una chiave OpenSSH di tipo RSA o DSA. Assicurati che il contenuto del file chiave inizi con "-----BEGIN [RSA/DSA] PRIVATE KEY-----" e termina con "-----END [RSA/DSA] PRIVATE KEY-----". Se il file della chiave privata è in formato PPK, utilizzare lo strumento PuTTY per convertire il formato PPK in OpenSSH.

Formato API

POST /connections

Richiesta

La richiesta seguente crea una connessione di base per SFTP:

curl -X POST \
  'https://platform.adobe.io/data/foundation/flowservice/connections' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \
  -d  '{
      "name": "SFTP connector with password",
      "description": "SFTP connector password",
      "auth": {
          "specName": "Basic Authentication for sftp",
          "params": {
              "host": "{HOST}",
              "port": 22,
              "userName": "{USERNAME}",
              "password": "{PASSWORD}",
              "maxConcurrentConnections": 5,
              "folderPath": "acme/business/customers/holidaySales"
          }
      },
      "connectionSpec": {
          "id": "b7bf2577-4520-42c9-bae9-cad01560f7bc",
          "version": "1.0"
      }
  }'
Proprietà Descrizione
auth.params.host Il nome host del server SFTP.
auth.params.port Porta del server SFTP. Il valore predefinito è 22.
auth.params.username Il nome utente associato al server SFTP.
auth.params.password La password associata al server SFTP.
auth.params.maxConcurrentConnections Il numero massimo di connessioni simultanee specificate durante la connessione di Platform a SFTP. Se attivato, questo valore deve essere impostato su almeno 1.
auth.params.folderPath Percorso della cartella a cui desideri fornire l’accesso.
connectionSpec.id ID della specifica di connessione al server SFTP: b7bf2577-4520-42c9-bae9-cad01560f7bc 
curl -X POST \
  'https://platform.adobe.io/data/foundation/flowservice/connections' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \
  -d '{
      "name": "SFTP connector with SSH authentication",
      "description": "SFTP connector with SSH authentication",
      "auth": {
          "specName": "SSH PublicKey Authentication for sftp",
          "params": {
              "host": "{HOST}",
              "port": 22,
              "userName": "{USERNAME}",
              "privateKeyContent": "{PRIVATE_KEY_CONTENT}",
              "passPhrase": "{PASSPHRASE}",
              "maxConcurrentConnections": 5,
              "folderPath": "acme/business/customers/holidaySales"
          }
      },
      "connectionSpec": {
          "id": "b7bf2577-4520-42c9-bae9-cad01560f7bc",
          "version": "1.0"
      }
  }'
Proprietà Descrizione
auth.params.host Il nome host del SFTP server.
auth.params.port Porta del server SFTP. Il valore predefinito è 22.
auth.params.username Il nome utente associato al tuo SFTP server.
auth.params.privateKeyContent Il contenuto della chiave privata SSH con codifica Base64. Il tipo di chiave OpenSSH deve essere classificato come RSA o DSA.
auth.params.passPhrase La passphrase o password per decrittografare la chiave privata se il file di chiave o il contenuto della chiave è protetto da una passphrase. Se PrivateKeyContent è protetto da password, questo parametro deve essere utilizzato con la passphrase di PrivateKeyContent come valore.
auth.params.maxConcurrentConnections Il numero massimo di connessioni simultanee specificate durante la connessione di Platform a SFTP. Se attivato, questo valore deve essere impostato su almeno 1.
auth.params.folderPath Percorso della cartella a cui desideri fornire l’accesso.
connectionSpec.id Il SFTP ID specifica connessione server: b7bf2577-4520-42c9-bae9-cad01560f7bc

Risposta

In caso di esito positivo, la risposta restituisce l’identificatore univoco (id) della connessione appena creata. Questo ID è necessario per esplorare il server SFTP nella prossima esercitazione.

{
    "id": "bf367b0d-3d9b-4060-b67b-0d3d9bd06094",
    "etag": "\"1700cc7b-0000-0200-0000-5e3b3fba0000\""
}

Passaggi successivi

Seguendo questa esercitazione, hai creato un’ SFTP connessione tramite Flow Service e hanno ottenuto il valore ID univoco della connessione. Puoi usare questo ID connessione per esplorare gli archivi cloud utilizzando l’API del servizio Flow.

In questa pagina