Met de FTPS-connector kunt u commando's in een keten gebruiken voor interactie met een file transfer protocol (FTP) of FTP Secure (FTPS) server. Met deze connector kunt u bijvoorbeeld:
- Bestanden uploaden en downloaden op een server
- Mappen maken en verwijderen
- Bestanden verplaatsen of kopiëren
- Bestanden en mappen weergeven
Opmerking: Voor interactie met een Secure Shell FTP (SFTP)-server binnen een keten, gebruikt u de SFTP-connector.
Vereisten
Om de FTPS connector te kunnen gebruiken, moet uw organisatie toegang hebben tot een eigen FTP/S server. Workiva host of levert geen FTP/S servers.
Om de verbinding met uw server te beveiligen, gebruikt de connector basisverificatie met gebruikersnaam en wachtwoord. Om de verbinding op te zetten, hebt u het volgende nodig:
- De hostnaam van de server
- De poort waarop de server draait
- De verificatiegegevens die moeten worden gebruikt om verbinding te maken met de server
- Het protocol dat de server gebruikt om gegevens te verzenden-FTP of FTPS
- Voor een FTPS-server, of het gecodeerde gegevensoverdracht vereist
- Om verbinding te maken met een on-premise server, de GroundRunner om de commando's uit te voeren
Opmerking: De connector ondersteunt expliciet FTP/S, niet impliciet FTP/S.
De FTPS-connector instellen
Opmerking: Om de connector beschikbaar te maken voor gebruik in de ketens van uw organisatie, moet een beveiligingsbeheerder van de org deze eerst inschakelen vanuit Configuratie.
- Ga naar Chain Builder, klik op Connections, en vervolgens op Create rechtsboven.
- Selecteer onder Connector Connection, FTPS Connector en de loper die u met de connector wilt gebruiken.
- Voer onder Basisinfo een unieke naam en beschrijving in om de verbinding te helpen identificeren.
- Onder Eigenschappen, voert u de details van de verbinding in:
Eigendom Details Hostnaam Voer de hostnaam van de server in, zoals ftp.domain.com.Haven Voer de poort in waarop de server draait; standaard 21.Opmerking: De connector ondersteunt expliciet FTP/S over poort 21, niet impliciet FTP/S over poort 990.
Gebruikersnaam Voer de gebruikersnaam in die wordt gebruikt om in te loggen op de server. Wachtwoord Voer het wachtwoord in voor de eigenschap Username. Protocol Selecteer of de server het FTP- of FTPS-protocol gebruikt om gegevens over te dragen. PROT-waarde Als de eigenschap Protocol FTPS is, selecteert u hoe de server gegevens overdraagt. - Als het gecodeerde overdrachten vereist, selecteert u P (Gecodeerd).
- Als het niet-versleutelde overdrachten ondersteunt, selecteert u C (Niet versleuteld).
Sessie hergebruik Stem deze instelling af op uw serverconfiguratie. Wordt standaard ingesteld op True.
Houd er rekening mee dat de connector altijd zal proberen om de SSL/TLS-sessie opnieuw te gebruiken bij het uitvoeren van een opdracht; deze instelling bepaalt alleen wat er daarna gebeurt:
- Indien ingesteld op "True": Als de sessie niet opnieuw kan worden gebruikt, mislukt de opdracht.
- Indien ingesteld op "False": Als de sessie niet opnieuw kan worden gebruikt, schakelt de opdracht over naar een nieuwe sessie. Als de nieuwe sessie nog steeds niet gebruikt kan worden, dan zal de opdracht mislukken.
Opmerking: Alle gevoelige gegevens worden automatisch versleuteld en opgeslagen met Advanced Encryption Standard (AES)-256 codering.
- Selecteer de omgevingen om de verbinding te gebruiken en klik op Opslaan.
- Om de verbinding te testen, maakt een ketting aan en voert deze uit met de opdracht List Files/Folders van de connector en controleert of deze een geldige uitvoer oplevert.
Probleemoplossing
Als de verbinding met de server mislukt:
- Controleer of de verificatiegegevens van de connector correct zijn. Gebruik bijvoorbeeld dezelfde referenties om verbinding te maken met de server via een SFTP-clienttoepassing zoals FileZilla of WinSCP.
- Controleer de hostnaam, poort en het protocol voor de server.
- Controleer uw instelling voor sessiehergebruik. Dit staat standaard op "true" en moet meestal niet veranderd worden.