PuTTY::Key is a Ruby implementation of the PuTTY private key (ppk) format (versions 2 and 3), handling reading and writing .ppk files. It includes a refinement to Ruby's OpenSSL library to add support for converting DSA, EC and RSA private keys to and from PuTTY private key files. This allows OpenSSH ecdsa, ssh-dss and ssh-rsa private keys to be converted to and from PuTTY's private key format.
To install the PuTTY::Key gem, run the following command:
gem install putty-keyTo add PuTTY::Key as a Bundler dependency, add the following line to your
Gemfile:
gem 'putty-key'PuTTY::Key is compatible with Ruby MRI 2.1.0+ and JRuby 9.1.0.0+.
Format 2 and 3 .ppk files are supported. Format 1 (not supported) was only used
briefly early on in the development of the .ppk format and was never included in
a PuTTY release. Format 2 is supported by PuTTY version 0.52 onwards. Format 3
is supported by PuTTY version 0.75 onwards. By default, PuTTY::Key::PPK saves
files using format 2. Format 3 can be selected with the format parameter.
libargon2 is required to load and save encrypted format 3 files. Binaries are typically available with your OS distribution. For Windows, binaries are available from the argon2-windows repository. Use either Argon2OptDll.dll for CPUs supporting AVX or Argon2RefDll.dll otherwise.
To use PuTTY::Key, it must first be loaded with:
require 'putty/key'The included refinement to Ruby's OpenSSL library can then either be activated in the lexical scope (file, class or module) where it will be used with:
using PuTTY::Keyor installed globally by calling:
PuTTY::Key.global_installThe following sections give examples of how PuTTY::Key can be used.
require 'openssl'
require 'putty/key'
using PuTTY::Key # or PuTTY::Key.global_install
pem = File.read('key.pem', mode: 'rb')
pkey = OpenSSL::PKey.read(pem)
ppk = pkey.to_ppk
ppk.comment = 'Optional comment'
ppk.save('key.ppk')Use ppk.save('key.ppk', format: 3) to save a format 3 file instead of
format 2.
require 'openssl'
require 'putty/key'
using PuTTY::Key # or PuTTY::Key.global_install
rsa = OpenSSL::PKey::RSA.generate(2048)
ppk = rsa.to_ppk
ppk.comment = 'RSA 2048'
ppk.save('rsa.ppk', 'Passphrase for encryption')Use ppk.save('rsa.ppk', 'Passphrase for encryption', format: 3) to save a
format 3 file instead of format 2.
require 'openssl'
require 'putty/key'
using PuTTY::Key # or PuTTY::Key.global_install
ppk = PuTTY::Key::PPK.new('key.ppk')
pkey = OpenSSL::PKey.from_ppk(ppk)
pem = pkey.to_pem
File.write('key.pem', pem, mode: 'wb')require 'putty/key'
ppk = PuTTY::Key::PPK.new('rsa.ppk', 'Passphrase for encryption')
ppk.save('rsa-plain.ppk')Use ppk.save('rsa-plain.ppk', format: 3) to save a format 3 file instead of
format 2.
API documentation for PuTTY::Key is available on RubyDoc.info.
PuTTY::Key is distributed under the terms of the MIT license. A copy of this license can be found in the included LICENSE file.
Source code, release information and the issue tracker can be found on the PuTTY::Key GitHub project page.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent