Workiva-ondersteuningscentrum

Met de SFTP-connector kunt u commando's in een keten gebruiken om bestanden en mappen op een SFTP-server (Secure File Transfer Protocol) te beheren. Met deze connector kunt u bijvoorbeeld sjablonen gebruiken om een keten te maken om een bestand veilig te downloaden van een SFTP-server en het vervolgens te uploaden naar een Wdatatabel.

Vereisten

Om de SFTP Connector te kunnen gebruiken, moet uw organisatie toegang hebben tot een eigen SFTP-server. Workiva kan deze servers niet hosten of leveren.

Om de verbinding met uw SFTP-server te beveiligen, ondersteunt de connector ofwel basisverificatie met gebruikersnaam en wachtwoord of verificatie met openbare sleutel/privésleutel. Om de verbinding op te zetten, hebt u het volgende nodig:

• Hostnaam of IP-adres van de server
• De poort waarop de server draait
• De gebruikersnaam die wordt gebruikt om toegang te krijgen tot de server
• De verificatiegegevens van de gebruikersnaam
  • Voor basisverificatie is het wachtwoord
  • Voor verificatie met openbare sleutel, het privésleutelbestand als PEM of PPK, en het wachtwoord (indien van toepassing). Meer informatie over privésleutels.

De SFTP-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.

1. Ga naar Chain Builder, klik op Connectionscompare_arrows, en vervolgens op Create rechtsboven.
2. Selecteer onder Connector Verbinding, SFTP Connector en uw loper.
   
3. Voer onder Basisinfo een unieke naam en beschrijving in om de verbinding te helpen identificeren.
4. Als u verificatie met een openbare sleutel gebruikt, upload dan onder Resources het bestand met de privésleutel van de server. 
5. Onder Eigenschappen, voert u de details van de verbinding in:
   

   Eigendom	Details
   Gastheer	Voer de hostnaam of het IP-adres van de SFTP-server in, zoals 34.23.34.45 of sftp.example.net.
   Haven	Voer de poort in waarop de server draait.
   Gebruikersnaam	Voer de gebruikersnaam in die wordt gebruikt om in te loggen op de server.
   Wachtwoord	Voer voor de basisverificatie het wachtwoord in voor Gebruikersnaam. Laat leeg voor verificatie met openbare sleutel.
   Privé sleutel	Voor verificatie met een openbare sleutel voert u de bestandsnaam van de geüploade privésleutel in onder Resources.
   Wachtwoord privésleutel	Voer voor verificatie met openbare sleutel het wachtwoord voor het bestand met de privésleutel in. Laat leeg als de privésleutel geen wachtwoord heeft.
   Time-out verbinding	Voer het aantal minuten in dat moet worden gewacht op de verbinding met de SFTP-server. Als de server traag is of een hoge belasting heeft, voer dan een groot getal in.

   Opmerking: Alle gevoelige gegevens worden automatisch versleuteld en opgeslagen met Advanced Encryption Standard (AES)-256 codering.

6. Selecteer de omgevingen om de verbinding te gebruiken en klik op Opslaan.
7. Als uw netwerk een toestaanlijst van uitgaande domeinen vereist, sta dan het IP-adres toe dat vermeld staat in het document Hosts en e-mails toestaan voor Workiva.
8. Om de verbinding te testen, creëert en voert u een ketting uit met de SFTP Connector's List Directory opdracht, en controleert u of deze een geldige uitvoer geeft.

Probleemoplossing

Als de verbinding met de SFTP-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 of uw wachtwoord niet begint met een "at"-teken (@).
• Als de verbinding een time-out heeft, verhoogt u de Connection timeout.
• Als uw netwerk een lijst met toegestane uitgaande domeinen vereist, volg dan het document Hosts en e-mails toestaan voor Workiva.

Privé sleutels

Als u met uw SFTP-clienttoepassing geen openbaar/privé sleutelpaar kunt genereren, gebruik dan een hulpmiddel zoals PuTTYgen of ssh-keygen. Voor privésleutels ondersteunen wij de volgende formaten:

• PuTTy-gegenereerde sleutels, die meestal eindigen op een .ppk extensie.
• RSA-sleutels met PKCS#1-standaard in PEM-formaat, dat meestal eindigt op een .pem extensie.

U kunt uw RSA-sleutels ook in een teksteditor bekijken. Als de tekst -----BEGIN RSA PRIVATE KEY----- en -----END RSA PRIVATE KEY----- bevat, dan worden deze formaten door Workiva ondersteund. Als deze regels ontbreken of andere termen bevatten, dan moet u de sleutel naar dit formaat converteren of een nieuwe sleutel genereren.

Architectuur