SFTP

Generate an SSH Key with PuTTYgen or Terminal (for SFTP Integrations)

  • Chirag Kumar DeoChirag Kumar Deo
  • 07 Oct 2026
Terminal running ssh-keygen to create an RSA key pair

Key-based SFTP needs a key pair: a private key that stays with you and a public key you share with the server owner. Here are both common ways to create one.

Which key type?

  • RSA, 4096 bits is accepted almost everywhere and is the safest choice for integrations with older servers.
  • Ed25519 is modern, short and fast, but check that the server (and your integration platform) supports it before choosing it.

When in doubt, use RSA 4096.

Option 1: Terminal (macOS, Linux, Windows 10/11)

ssh-keygen is included with macOS, Linux and current versions of Windows (via the OpenSSH client).

ssh-keygen -t rsa -b 4096 -m PEM -C "boomi-sftp-partner" -f ~/.ssh/boomi_sftp_partner
  • -t rsa -b 4096: RSA key, 4096 bits.
  • -m PEM: the classic PEM format, which integration tools read most reliably.
  • -C: a comment so you can tell keys apart later.
  • -f: where to save it. This creates boomi_sftp_partner (private) and boomi_sftp_partner.pub (public).

You are asked for a passphrase. A passphrase encrypts the private key file; if you set one, you will enter it in the integration’s connection settings as well.

Show the public key to copy it:

cat ~/.ssh/boomi_sftp_partner.pub

Check its fingerprint, which is useful for confirming with the server owner:

ssh-keygen -lf ~/.ssh/boomi_sftp_partner.pub

Option 2: PuTTYgen (Windows)

PuTTYgen comes with PuTTY.

PuTTYgen: generate, protect, save, then export in OpenSSH format.
PuTTYgen: generate, protect, save, then export in OpenSSH format.
  1. Open PuTTYgen. Choose RSA and set the number of bits to 4096.
  2. Click Generate and move the mouse over the blank area until the bar fills; this provides randomness.
  3. Enter a Key comment and, ideally, a Key passphrase.
  4. Click Save private key. This saves a .ppk file for PuTTY tools.
  5. Choose Conversions → Export OpenSSH key and save it too. This is the file integration platforms such as Boomi need.
  6. Copy the text in the box at the top (Public key for pasting into OpenSSH authorized_keys file). That single line is the public key you send.

Watch out: A .ppk file is not an OpenSSH private key. If a tool rejects your key, you probably gave it the .ppk instead of the exported OpenSSH file.

Install the public key on the server

If you manage the server yourself, append the public key line to the user’s ~/.ssh/authorized_keys and set strict permissions:

mkdir -p ~/.ssh && chmod 700 ~/.ssh
cat boomi_sftp_partner.pub >> ~/.ssh/authorized_keys
chmod 600 ~/.ssh/authorized_keys

Otherwise, send the .pub line to the server administrator and tell them which user it is for.

Test the login

sftp -i ~/.ssh/boomi_sftp_partner partneruser@sftp.partner.com

Keep keys safe

  • Never email or commit the private key.
  • Use one key pair per integration or partner, so you can revoke one without affecting the others.
  • Record where each key is used and when it should be rotated.

Next: Connect SFTP in Boomi with an SSH key.