Handleiding om verbinding te maken met SCP

Handleiding om verbinding te maken met SCP

In de Spend Cloud kun je bestanden uploaden om deze vervolgens geautomatiseerd te laten verwerken in de importplanning. Om het uploaden van deze bestanden zo geautomatiseerd en veilig mogelijk te maken, is het mogelijk deze bestanden via SCP te uploaden, via public/private key authenticatie. Het volgende stappenplan legt uit hoe je de verbinding tot stand kunt brengen.
Let op: Om gebruik te maken van de verbinding met SCP zijn kosten verbonden. Mocht je hier nog geen abonnement van hebben, neem dan contact op met jouw accountmanager.

1. Het installeren van WinSCP
  1. Download en installeer WinSCP van https://winscp.net/eng/downloads.php . Indien je WinSCP al geïnstalleerd hebt, zorg dan dat deze is bijgewerkt naar de laatste versie.
2. Het genereren van een key pair
  1. Na de installatie van WinSCP kun je ook gebruik maken van het programma 'puttygen. Start dit programma op. Je krijgt dit scherm te zien:

  1. Klik op 'Generate' om een nieuwe key pair te genereren.  Je krijgt een scherm zoals dit te zien:


  Let erop dat dit een RSA key is (zie Parameters), dus geen SSH-1 (RSA) key. 

  1. Klik op 'Save private key' en sla de private key op een veilige plek op. De private key is, zoals de naam al zegt, 'private'. Hiermee kan straks ingelogd worden op de SCP server van de Spend Cloud. Het is zaak om deze key veilig op te slaan. Iedereen die deze key in bezit heeft, kan inloggen op de SCP server van de Spend Cloud en toegang krijgen tot de upgeloade bestanden. Deze key hebben we straks nodig als we gaan inloggen
  1. Het stuk tekst in het bovenste kader bij "Public key for pasting into OpenSSH authorized_keys file" moet gekopieerd worden naar de Spend Cloud
3. De Public Key in de Spend Cloud toevoegen
  1. Selecteer en kopieer de tekst uit de vorige stap en open de Spend Cloud. Navigeer naar "Applicatiebeheer-->Algemeen-->SCP Authenticatie". Dit scherm ziet er zo uit:

  1. Let goed op of de key altijd begint met ssh-rsa gevolgd door een spatie.
  2. Plak de public key in het input veld en klik vervolgens op 'Sleutel toevoegen' om de sleutel op te slaan. Dit duurt even
  3. De Spend Cloud is nu klaar om verbinding te maken via SCP 
4. Verbinding maken via SCP 
  1. Start WinSCP op. Je krijgt onderstaand scherm te zien: 

  1. Vul de volgende gegevens in:
    1. Hostname voor productie: sftp.spend.cloud
    2. Hostname voor test: sftp.test.spend.cloud
    3. Username: De naam van de omgeving in kleine letters. 
  2. Klik op advanced en selecteer 'Authentication' onder 'SSH'. Hier moet bij "Private key file" het private key bestand worden aangewezen dat bij stap 2, bullet drie is gegenereerd
  3. Klik op OK en "Login". Er wordt nu verbinding gemaakt met de Spend Cloud. Bij de eerste keer inloggen dient de key fingerprint van de server te worden geaccepteerd
  4. Als er succesvol is ingelogd, zie je twee mappen, 'auto_export' en 'auto_import'. De bestanden die je wilt aanbieden om automatisch verwerkt te worden dienen in de map 'auto_import' geplaatst te worden. 
5. Automatische upload, WinSCP batch modus 
  1. Voor automatische verwerking kent WinSCP een batch modus, waarmee het uploaden van bestanden geautomatiseerd kan worden. WinSCP kan door middel van een script opdrachten krijgen. Zo een script kan er zo uitzien: 

          Uiteraard kunnen de paden en bestandsnamen naar wens aangepast worden. 
  1. Het aanroepen van dit script op de console gaat als volgt: WinSCP/console/script=omgevingsnaam.txt. Dit kan uiteraard vanuit de directory waar omgevingsnaam.txt staat en waar de opdracht winscp herkend wordt
  2. Deze aanroep kan vervolgens ingepland worden om op gezette tijden te draaien. In de Spend Cloud kan vervolgens een automatische import opdracht geactiveerd worden. Graag enige tijd tussen deze twee opdrachten laten, zodat het zeker is dat de upload van de gegevens is afgerond zodra de import gaat draaien



    • Related Articles

    • Importplanning

      Met de Spend Cloud is het mogelijk om geautomatiseerde imports in te plannen. In het overzicht in het menu-onderdeel ‘Importplanning’, kun je terugvinden wanneer ingestelde imports worden uitgevoerd en kun je nieuwe importplanningen toevoegen of ...

    • Wat kan ik als beheerder doen als het een collega niet lukt om in te loggen?

      Het kan zijn dat een gebruiker ergens tegenaan loopt met inloggen en zich bij jou meldt. In dit artikel delen we wat je dan als applicatiebeheerder kunt doen. Afhankelijk van de keuze van jouw organisatie kan de gebruiker op twee manieren inloggen: ...

    • Medewerkers- en rollen-import

      In dit artikel staat beschreven hoe een medewerkers- en een rollen-import ingericht kan worden in de Spend Cloud. De combinatie van beide imports zorgt voor een automatisering in het gebruikersbeheer van de Spend Cloud. Medewerkersimport Bij een ...

    • Kostenplaatsen toevoegen en beheren

      In het menu-onderdeel Kostenplaatsen staan alle kostenplaatsen die in Spend Cloud zijn toegevoegd. Hier kun je handmatig een kostenplaats toevoegen of een lijst met kostenplaatsen importeren. Via het overzicht kun je ook een workflow instellen en ...

    • Algemene configinstellingen

      In het menu-onderdeel Configinstellingen / Algemeen, vind je instellingen die van toepassing zijn op de gehele Spend Cloud. Zo kun je hier instellingen vinden voor het inloggen in de Spend Cloud, wachtwoordvereisten, taal-instellingen en de gegevens ...