SFTP - Installatie-instructies

Gemaakt door Ashish Chaudhary, Gewijzigd op Za, 4 Okt om 9:35 PM op Ashish Chaudhary

SFTP - Instructies voor het instellen

INHOUDSOPGAVE

SFTP - Instructies voor het instellen

Hosting en verificatie

Uw SFTP-map wordt op een aparte SFTP-server (via AWS) gehost. Iedere klant krijgt een eigen gebruikersaccount met directe toegang tot de eigen SFTP-map. Sleutelgebaseerde verificatie wordt ondersteund. U dient daarom een sleutelpaar aan te maken en de publieke sleutel in te vullen in het veld Publieke sleutel bij het instellen van uw map. De sleutel moet in openSSH RSA formaat zijn. Hoe u deze sleutels aanmaakt, leest u bij Hoe maakt u een publieke SSH-sleutel aan voor de SFTP-server hieronder.

Configuratie

Voer de aangemaakte publieke sleutel in het veld Publieke sleutel in. U kunt eventueel de Gebruikersnaam aanpassen. De waarde in het veld Gebruikersnaam moet beginnen met een letter, cijfer of underscore en tussen de 3 en 100 tekens lang zijn. U mag letters, cijfers, underscores, apenstaarten (@), punten (.) en koppeltekens (-) gebruiken.
Kopieer de Gebruikersnaam, Spotnana domein-URL en het Poortnummer naar een veilige plek. Deze gegevens heeft het team binnen uw organisatie nodig om het verzenden van bestanden naar de nieuwe map in te stellen.
Let op: Nadat de SFTP-map is aangemaakt, kunt u deze gegevens altijd terugvinden onder Beheren.
Voer het e-mailadres of de e-mailadressen in waarop u rapportages over uw bestandsuploads wilt ontvangen in het veld SFTP e-mailnotificatie . Meer informatie hierover vindt u bij Rapportage en foutafhandeling hieronder.
Klik op Verbinden.

Zodra er een publieke sleutel is toegevoegd, krijgt de map de status Onbevestigd. Deze status blijft zichtbaar in de OBT tot er daadwerkelijk een bestand in de map is geplaatst. Dit mag een testbestand zijn of een HR-feed of bestand met aangepaste velden (alleen ondersteunde bestandsformaten worden verwerkt). Als de publieke sleutel later wordt gewijzigd, wordt de status opnieuw op Onbevestigd gezet tot het volgende bestand wordt ontvangen.

Wilt u uw SFTP-map verwijderen? Klik dan op  Verbinding verbreken. Hiermee wordt uw SFTP-map verwijderd. Wilt u deze later opnieuw instellen, dan moet u alle bovenstaande gegevens opnieuw invoeren.

Frequentie en planning

U bepaalt zelf hoe vaak en wanneer u bestanden uploadt. Zodra u een bestand plaatst in uw map op onze SFTP-server, wordt het direct opgepakt en verwerkt door onze applicatie.

Voor adviezen over de beste frequentie en planning per gegevenstype (zoals gebruikers, aangepaste velden, rechtspersonen), kijkt u in het onderdeel  Frequentie en planning  in de SFTP-instructies voor het betreffende gegevenstype.

Rapportage en foutafhandeling

Wij verzamelen gegevens over uw bestandsuploads en stellen na iedere upload een intern rapport op. Dit rapport sturen wij naar het e-mailadres of de adressen die u heeft opgegeven in het veld SFTP e-mailnotificatie bij het instellen. Per geüpload bestand vindt u in het rapport:

de reden(en) waarom een upload eventueel is mislukt (verkeerd formaat, ontbrekende kolomnamen, enzovoort).
de reden(en) waarom een bepaalde rij uit een bestand niet is verwerkt. Wij voeren geen gedeeltelijke updates uit: als er een fout optreedt in een kolom of een verplicht veld ontbreekt, wordt de hele rij overgeslagen.
de status van de upload (in behandeling, geslaagd, mislukt).

U kunt deze informatie gebruiken om eventuele fouten op te lossen. Lukt dit niet, neem dan contact op met de technische ondersteuning.

Accepteren wij een incrementeel bestand dat alleen de te wijzigen of toe te voegen records bevat?
- Ja
Moet het bestand dat u uploadt (via SFTP of handmatig) de optionele kolommen bevatten als u deze niet gebruikt?
- Nee

Hoe maakt u een publieke SSH-sleutel aan voor de SFTP-server

Gebruik de onderstaande instructies om de publieke SSH-sleutel aan te maken die u aan ons doorgeeft.

Formaat

Type: Tekenreeks
Lengtebeperking: maximaal 2048 tekens.

Patroon

^ssh-rsa\s+[A-Za-z0-9+/]+[=]{0,3}(\s+.+)?\s*$

SSH-sleutels aanmaken

Voer deze opdracht uit in de opdrachtprompt van Windows of in de terminal van macOS, Linux of UNIX om SSH-sleutels aan te maken:

ssh-keygen -t rsa -b 4096 -f key_name

Waarbij

-t het type versleuteling is
-b de sleutellengte (in bits) is
-f de sleutelnaam is

Voorbeeldsleutel

ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgQDDJB9oBRPrBegMDPEQo+HmNDb/jKUJL6q2kQpNNMDjNps9mhhwJ1dP/lOavMitBPAndeXlwaNEm2XbGaSrZtD/tbQTX1HQjP6pacy+Alf8kYBm5QFfl/Z6lGC8qHys10fpRXgYE7UhdSv6VyRqt1gELGFQwVBZ2kJJuBGJF1IRywwvG/h68B8iWU1+6KEWYQoUcT45r3j3otnx4NhhzpTiNgDbMk0ix+kar4/IstobRLcb7rt7FoUerTLNrVDi69DqbsGY5LN+NM8jVx0sPQLRC/ruil8pTHP3k4rDCc7a80+sH4sUTW+mHc7MTqbi/CcyyFAD8h7p6WqxEydOaJjMnvqAbE17BOj0TSxv3HMohTf3skzE7PbzVcjIfHTpFPGxmJkghAYAMi5l9VvAs91IpVylxjqPss3xQQJIZEmQdG2k7zk/UpsUFlmaOj6lCHRicFKCixKekzzm3nFuJvDEklurtydOQjZ8WkPzTSJfZBdKMuMUi0SQ9m9ZAw99t0=

Instructies per gegevenstype

Voor meer specifieke instructies over het uploaden van bepaalde gegevenstypen via SFTP, zie de volgende onderwerpen: