Verbinding maken met bestanden op SFTP-servers via Secure Shell (SSH) vanuit werkstromen in Azure Logic Apps

Van toepassing op: Azure Logic Apps (Verbruik + Standard)

Wanneer uw werkstroom geautomatiseerd bestandsbeheer moet uitvoeren op servers die gebruikmaken van SSH (Secure Shell) File Transfer Protocol (SFTP), gebruikt u de SFTP-SSH of SFTP connectorbewerkingen in de werkstromen die u met Azure Logic Apps maakt.

SFTP is een netwerkprotocol dat bestandstoegang, bestandsoverdracht en bestandsbeheer biedt via een betrouwbare gegevensstroom. Vervolgens kunt u bestanden op uw SFTP-server bewaken, overdragen en beheren zonder aangepaste code te schrijven of infrastructuur te beheren. Anders kan het handmatig beheren van deze bestandsbewerkingen tijdrovend, foutgevoelig en moeilijk te schalen zijn.

Uw werkstroom kan bijvoorbeeld de volgende taken uitvoeren:

• Binnenkomende gegevensbestanden bewaken en verwerken.
• Mappen en bestanden maken en beheren.
• Bestandsinhoud en metagegevens ophalen. Pak archieven uit.
• Rapporten distribueren.
• Inhoud synchroniseren tussen omgevingen.

Deze handleiding laat zien hoe u toegang krijgt tot uw SFTP-server vanuit een werkstroom in Azure Logic Apps.

Voor meer informatie, zie:

• SFTP (SSH File Transfer Protocol)
• Secure Shell (SSH)

Technische referentie voor connectoren

De SFTP-SSH-connector heeft verschillende versies, op basis van het type logische app en de hostomgeving.

Verbruiks- en standaardwerkstromen kunnen gebruikmaken van de SFTP-SSHbeheerde-connector, die rekenkracht deelt met andere resources in multitenant Azure. Standaardwerkstromen kunnen ook gebruikmaken van de runtime-systeemeigen of ingebouwdeSFTP-connector . Beide connectorversies maken gebruik van het SSH-protocol.

Verschillende SFTP-connectorversies bieden verschillende vooraf gedefinieerde bewerkingen. U kunt een lege werkstroom starten met een SFTP-specifieke trigger of een andere trigger kiezen op basis van uw scenario. U kunt uw werkstroom bijvoorbeeld starten met een SFTP-trigger die gebeurtenissen op uw SFTP-server bewaakt en erop reageert. De trigger biedt uitvoer voor gebruik met volgende acties in uw werkstroom. Verschillende SFTP-acties voeren verschillende taken uit, zoals bestanden ophalen, maken en beheren op uw SFTP-server.

Vereisten

• Een Azure-account en -abonnement. Ontvang een gratis Azure-account.

• Informatie over uw SFTP-serververbinding en -verificatie:

  • Serveradres
  • Accountgegevens
  • Toegang tot een persoonlijke SSH-sleutel
  • Wachtwoord voor persoonlijke SSH-sleutel

  Belangrijk

  Wanneer u uw verbinding maakt en uw persoonlijke SSH-sleutel invoert in de parameter voor de persoonlijke SSH-sleutel , moet u de stappen volgen voor het opgeven van de volledige en juiste parameterwaarde. Anders zorgt een ongeldige sleutel ervoor dat de verbinding mislukt.

  Zie de naslaginformatie over beheerde SFTP-SSH-connector - Verificatie en machtigingen voor meer informatie.

• De werkstroom waar u toegang wilt krijgen tot uw SFTP-server.

  Als u uw werkstroom wilt starten met een SFTP-trigger, hebt u een lege werkstroom nodig. Als u een SFTP-actie wilt gebruiken, gebruikt u een trigger die het beste werkt voor uw scenario. In het voorbeeld in deze handleiding wordt de trigger Herhaling gebruikt.

Algemene beperkingen

• Voordat u de beheerde SFTP-SSH-connector gebruikt, raadpleegt u de naslaginformatie over beheerde SFTP-SSH-connectors: bekende problemen en beperkingen.

• Voordat u de ingebouwde SFTP-connector gebruikt, raadpleegt u naslaginformatie over de ingebouwde SFTP-connector: bekende problemen en beperkingen.

Bekende problemen

Triggers die arrays accepteren en retourneren, hebben standaard de Split on-instelling die al is ingeschakeld. nl-NL: Met de trigger wordt automatisch een array opgedeeld door intern een afzonderlijk werkstroomexemplaar te maken om elk array-item te verwerken. Alle werkstroominstanties worden parallel uitgevoerd, zodat de matrixitems tegelijkertijd kunnen worden verwerkt.

Als de instelling Splitsen is ingeschakeld, retourneren beheerde connectortriggers de uitvoer voor alle matrixitems als lijsten. Alle volgende acties die naar deze uitvoer verwijzen, moeten deze uitvoer eerst als lijsten verwerken. Als u elk element van een array afzonderlijk wilt afhandelen, kunt u extra acties toevoegen. Als u bijvoorbeeld deze array-items wilt doorlopen, kunt u een For Each lus gebruiken. Voor triggers die alleen metagegevens of eigenschappen retourneren, gebruikt u een actie die eerst de metagegevens van het matrixitem ophaalt en gebruikt u vervolgens een actie om de inhoud van de items op te halen.

U moet deze methode alleen toepassen voor triggers van beheerde connectors, niet voor ingebouwde connectortriggers die uitvoer voor één matrixitem tegelijk retourneren met de instelling Splitsen ingeschakeld.

Stel dat u een beheerde connectortrigger hebt met de naam Wanneer een bestand wordt toegevoegd of gewijzigd (alleen eigenschappen) die de metagegevens of eigenschappen voor de nieuwe of bijgewerkte bestanden als matrices retourneert. Als u de metagegevens voor elk bestand afzonderlijk wilt ophalen, kunt u een For-lus gebruiken die door de matrix wordt herhaald. Gebruik in deze lus de volgende beheerde connectoracties in de opgegeven volgorde:

1. Haal bestandsmetagegevens op om de metagegevens van elk bestand op te halen.

2. Bestandsinhoud ophalen-actie om de inhoud van elk bestand te verkrijgen.

Chunking

Met segmenteren kan een bewerking grote bestanden verwerken die de standaardgroottelimieten overschrijden. Zie SFTP-SSH beheerde connectorverwijzing - Chunking voor meer informatie over de SFTP-SSH beheerde connector en chunking-ondersteuning.

Een SFTP-trigger toevoegen

Als u een SFTP-trigger wilt toevoegen aan uw lege werkstroom, volgt u de bijbehorende stappen:

Een trigger voor beheerde SFTP-SSH toevoegen (Verbruik, Standaard)

Voer de volgende stappen uit om een beheerde of gedeelde SFTP-SSH-connectortrigger toe te voegen en in te stellen:

1. Open de resource van de logische app in Azure Portal. Open de lege workflow in de ontwerpmodule.

2. Volg in de ontwerpfunctie de algemene stappen om de gewenste gedeeldeSFTP-SSH-trigger toe te voegen.

   De SFTP-SSH trigger met de naam Wanneer een bestand wordt toegevoegd of gewijzigd , start bijvoorbeeld de werkstroom wanneer een bestand op uw SFTP-server wordt toegevoegd of gewijzigd. U kunt een voorwaardeactie toevoegen waarmee wordt gecontroleerd of de bestandsinhoud voldoet aan de opgegeven criteria. Als de inhoud voldoet aan de criteria, gebruikt u de SFTP-actie Met de naam Bestandsinhoud ophalen en gebruikt u vervolgens een andere actie om de inhoud op te slaan in een andere SFTP-map.

3. Geef de benodigde verbindingsgegevens op als u hierom wordt gevraagd. Wanneer u klaar bent, selecteert u Nieuwe maken.

4. Selecteer in de ontwerpfunctie de trigger, als dit nog niet is geselecteerd. Geef in het triggerinformatievenster de benodigde details op.

   Voor meer informatie, zie de naslaginformatie over triggers voor SFTP-SSH-beheerde connectors.

5. Sla uw werkstroom op wanneer u klaar bent. Selecteer in de werkbalk van de ontwerper Opslaan.

6. Ga door met het bouwen van uw werkstroom door acties toe te voegen.

Een ingebouwde SFTP-trigger toevoegen (alleen standaard)

Volg deze stappen om een ingebouwde SFTP-connectortrigger toe te voegen en in te stellen:

1. Open de resource van de logische app in Azure Portal. Open de lege werkstroom in de ontwerpfunctie.

2. Volg in de ontwerpfunctie de algemene stappen om de gewenste ingebouwde SFTP-trigger toe te voegen.

   De SFTP-trigger met de naam Wanneer een bestand wordt toegevoegd of gewijzigd , start bijvoorbeeld de werkstroom wanneer een bestand op uw SFTP-server wordt toegevoegd of gewijzigd. U kunt een voorwaardeactie toevoegen waarmee wordt gecontroleerd of de bestandsinhoud voldoet aan de opgegeven criteria. Als de inhoud voldoet aan de criteria, gebruikt u de SFTP-actie Met de naam Bestandsinhoud ophalen en gebruikt u vervolgens een andere actie om de inhoud op te slaan in een andere SFTP-map.

3. Geef de benodigde verbindingsgegevens op als u hierom wordt gevraagd. Wanneer u klaar bent, selecteert u Nieuwe maken.

4. Selecteer in de ontwerpfunctie de trigger, indien niet geselecteerd. Geef in het triggerinformatievenster de benodigde details op.

   Voor meer informatie, zie de naslaginformatie over de ingebouwde SFTP-connectortrigger.

5. Sla uw werkstroom op wanneer u klaar bent. Selecteer in de werkbalk van de ontwerper Opslaan.

6. Ga door met het bouwen van uw werkstroom door acties toe te voegen.

Een SFTP-actie toevoegen

Voordat u een SFTP-actie toevoegt, is voor uw werkstroom een trigger vereist. Dit kan het beste zijn voor uw scenario.

In dit voorbeeld wordt de ingebouwde trigger Terugkerend gebruikt, die uw werkstroom uitvoert op basis van een opgegeven planning. U kunt een SFTP toevoegen

Een actie voor beheerde SFTP-SSH toevoegen (Verbruik, Standaard)

Voer de volgende stappen uit om een beheerde SFTP-SSH-connectoractie toe te voegen en in te stellen:

1. In het Azure-portaal, open je logic app-resource. Open uw werkstroom in de ontwerper.

2. Volg in de ontwerpfunctie de algemene stappen om de gewenste gedeelde SFTP-SSH actie toe te voegen.

   De actie SFTP-SSH met de naam Bestandsinhoud ophalen met behulp van het pad haalt bijvoorbeeld bestandsinhoud op van een SFTP-server door het bestandspad op te geven. U kunt de SFTP-SSH trigger gebruiken om te controleren op nieuwe of bijgewerkte bestanden en een voorwaardeactie die criteria aangeeft waaraan de inhoud moet voldoen. Als de inhoud voldoet aan de criteria, gebruikt u de bestandsinhoud ophalen met behulp van padactie en een volgende actie om de inhoud op te slaan in een andere SFTP-map.

3. Geef de benodigde verbindingsgegevens op als u hierom wordt gevraagd. Wanneer u klaar bent, selecteert u Nieuwe maken.

4. Selecteer in de ontwerpfunctie de actie, indien niet geselecteerd. Geef in het deelvenster actiegegevens de benodigde details op.

   Zie de naslaginformatie over acties voor beheerde SFTP-SSH-connectors voor meer informatie.

5. Sla uw werkstroom op wanneer u klaar bent. Selecteer in de werkbalk van de ontwerper Opslaan.

Een ingebouwde SFTP-actie toevoegen (alleen standaard)

Voer de volgende stappen uit om een ingebouwde SFTP-actie toe te voegen en in te stellen:

1. In het Azure-portaal, open je logic app-resource. Open uw werkstroom in de ontwerper.

2. Volg in de ontwerpfunctie de algemene stappen om de gewenste ingebouwde SFTP-SSH actie toe te voegen.

   De SFTP-actie Get file content haalt bijvoorbeeld de bestandsinhoud op een SFTP-server op. U kunt de SFTP-trigger gebruiken die controleert op nieuwe of bijgewerkte bestanden en een voorwaardeactie die criteria specificeert waaraan de bestandsinhoud moet voldoen. Als de inhoud aan de criteria voldoet, gebruikt u de actie Bestandsinhoud ophalen en een volgende actie om de inhoud op te slaan in een andere SFTP-map.

3. Geef de benodigde verbindingsgegevens op als u hierom wordt gevraagd. Wanneer u klaar bent, selecteert u Nieuwe maken.

4. Selecteer in de designer de actie, indien deze nog niet is geselecteerd. Geef in het deelvenster actiegegevens de benodigde details op.

   Zie voor meer informatie de naslaginformatie over acties van de ingebouwde SFTP-connector.

5. Sla uw werkstroom op wanneer u klaar bent. Selecteer in de werkbalk van de ontwerper Opslaan.

Problemen oplossen

Voor meer informatie, zie:

• Naslaginformatie voor beheerde SFTP-SSH-connector - Problemen oplossen
• Naslaginformatie over geïntegreerde SFTP-connectors - Probleemoplossing

Verwante inhoud

• Beheerde connectors voor Azure Logic Apps
• Ingebouwde connectors voor Azure Logic Apps