2 * Code for PuTTY to import and export private key files in other
3 * SSH clients' formats.
14 #define PUT_32BIT(cp, value) do { \
15 (cp)[3] = (unsigned char)(value); \
16 (cp)[2] = (unsigned char)((value) >> 8); \
17 (cp)[1] = (unsigned char)((value) >> 16); \
18 (cp)[0] = (unsigned char)((value) >> 24); } while (0)
20 #define GET_32BIT(cp) \
21 (((unsigned long)(unsigned char)(cp)[0] << 24) | \
22 ((unsigned long)(unsigned char)(cp)[1] << 16) | \
23 ((unsigned long)(unsigned char)(cp)[2] << 8) | \
24 ((unsigned long)(unsigned char)(cp)[3]))
26 int openssh_encrypted(char *filename
);
27 struct ssh2_userkey
*openssh_read(char *filename
, char *passphrase
);
28 int openssh_write(char *filename
, struct ssh2_userkey
*key
, char *passphrase
);
30 int sshcom_encrypted(char *filename
, char **comment
);
31 struct ssh2_userkey
*sshcom_read(char *filename
, char *passphrase
);
32 int sshcom_write(char *filename
, struct ssh2_userkey
*key
, char *passphrase
);
35 * Given a key type, determine whether we know how to import it.
37 int import_possible(int type
)
39 if (type
== SSH_KEYTYPE_OPENSSH
)
41 if (type
== SSH_KEYTYPE_SSHCOM
)
47 * Given a key type, determine what native key type
48 * (SSH_KEYTYPE_SSH1 or SSH_KEYTYPE_SSH2) it will come out as once
51 int import_target_type(int type
)
54 * There are no known foreign SSH1 key formats.
56 return SSH_KEYTYPE_SSH2
;
60 * Determine whether a foreign key is encrypted.
62 int import_encrypted(char *filename
, int type
, char **comment
)
64 if (type
== SSH_KEYTYPE_OPENSSH
) {
65 *comment
= filename
; /* OpenSSH doesn't do key comments */
66 return openssh_encrypted(filename
);
68 if (type
== SSH_KEYTYPE_SSHCOM
) {
69 return sshcom_encrypted(filename
, comment
);
77 int import_ssh1(char *filename
, int type
, struct RSAKey
*key
, char *passphrase
)
85 struct ssh2_userkey
*import_ssh2(char *filename
, int type
, char *passphrase
)
87 if (type
== SSH_KEYTYPE_OPENSSH
)
88 return openssh_read(filename
, passphrase
);
89 if (type
== SSH_KEYTYPE_SSHCOM
)
90 return sshcom_read(filename
, passphrase
);
97 int export_ssh1(char *filename
, int type
, struct RSAKey
*key
, char *passphrase
)
103 * Export an SSH2 key.
105 int export_ssh2(char *filename
, int type
,
106 struct ssh2_userkey
*key
, char *passphrase
)
108 if (type
== SSH_KEYTYPE_OPENSSH
)
109 return openssh_write(filename
, key
, passphrase
);
110 if (type
== SSH_KEYTYPE_SSHCOM
)
111 return sshcom_write(filename
, key
, passphrase
);
115 /* ----------------------------------------------------------------------
116 * Helper routines. (The base64 ones are defined in sshpubk.c.)
119 #define isbase64(c) ( ((c) >= 'A' && (c) <= 'Z') || \
120 ((c) >= 'a' && (c) <= 'z') || \
121 ((c) >= '0' && (c) <= '9') || \
122 (c) == '+' || (c) == '/' || (c) == '=' \
125 extern int base64_decode_atom(char *atom
, unsigned char *out
);
126 extern int base64_lines(int datalen
);
127 extern void base64_encode_atom(unsigned char *data
, int n
, char *out
);
128 extern void base64_encode(FILE *fp
, unsigned char *data
, int datalen
, int cpl
);
131 * Read an ASN.1/BER identifier and length pair.
133 * Flags are a combination of the #defines listed below.
135 * Returns -1 if unsuccessful; otherwise returns the number of
136 * bytes used out of the source data.
139 /* ASN.1 tag classes. */
140 #define ASN1_CLASS_UNIVERSAL (0 << 6)
141 #define ASN1_CLASS_APPLICATION (1 << 6)
142 #define ASN1_CLASS_CONTEXT_SPECIFIC (2 << 6)
143 #define ASN1_CLASS_PRIVATE (3 << 6)
144 #define ASN1_CLASS_MASK (3 << 6)
146 /* Primitive versus constructed bit. */
147 #define ASN1_CONSTRUCTED (1 << 5)
149 int ber_read_id_len(void *source
, int sourcelen
,
150 int *id
, int *length
, int *flags
)
152 unsigned char *p
= (unsigned char *) source
;
157 *flags
= (*p
& 0xE0);
158 if ((*p
& 0x1F) == 0x1F) {
161 *id
= (*id
<< 7) | (*p
& 0x7F);
166 *id
= (*id
<< 7) | (*p
& 0x7F);
183 *length
= (*length
<< 8) | (*p
++);
190 return p
- (unsigned char *) source
;
194 * Write an ASN.1/BER identifier and length pair. Returns the
195 * number of bytes consumed. Assumes dest contains enough space.
196 * Will avoid writing anything if dest is NULL, but still return
197 * amount of space required.
199 int ber_write_id_len(void *dest
, int id
, int length
, int flags
)
201 unsigned char *d
= (unsigned char *)dest
;
206 * Identifier is one byte.
209 if (d
) *d
++ = id
| flags
;
213 * Identifier is multiple bytes: the first byte is 11111
214 * plus the flags, and subsequent bytes encode the value of
215 * the identifier, 7 bits at a time, with the top bit of
216 * each byte 1 except the last one which is 0.
219 if (d
) *d
++ = 0x1F | flags
;
220 for (n
= 1; (id
>> (7*n
)) > 0; n
++)
221 continue; /* count the bytes */
224 if (d
) *d
++ = (n ?
0x80 : 0) | ((id
>> (7*n
)) & 0x7F);
230 * Length is one byte.
233 if (d
) *d
++ = length
;
237 * Length is multiple bytes. The first is 0x80 plus the
238 * number of subsequent bytes, and the subsequent bytes
239 * encode the actual length.
241 for (n
= 1; (length
>> (8*n
)) > 0; n
++)
242 continue; /* count the bytes */
244 if (d
) *d
++ = 0x80 | n
;
247 if (d
) *d
++ = (length
>> (8*n
)) & 0xFF;
254 static int put_string(void *target
, void *data
, int len
)
256 unsigned char *d
= (unsigned char *)target
;
259 memcpy(d
+4, data
, len
);
263 static int put_mp(void *target
, void *data
, int len
)
265 unsigned char *d
= (unsigned char *)target
;
266 unsigned char *i
= (unsigned char *)data
;
271 memcpy(d
+5, data
, len
);
275 memcpy(d
+4, data
, len
);
280 /* Simple structure to point to an mp-int within a blob. */
281 struct mpint_pos
{ void *start
; int bytes
; };
283 int ssh2_read_mpint(void *data
, int len
, struct mpint_pos
*ret
)
286 unsigned char *d
= (unsigned char *) data
;
290 bytes
= GET_32BIT(d
);
301 return len
; /* ensure further calls fail as well */
304 /* ----------------------------------------------------------------------
305 * Code to read and write OpenSSH private keys.
308 enum { OSSH_DSA
, OSSH_RSA
};
313 unsigned char *keyblob
;
314 int keyblob_len
, keyblob_size
;
317 struct openssh_key
*load_openssh_key(char *filename
)
319 struct openssh_key
*ret
;
325 int base64_chars
= 0;
327 ret
= smalloc(sizeof(*ret
));
329 ret
->keyblob_len
= ret
->keyblob_size
= 0;
331 memset(ret
->iv
, 0, sizeof(ret
->iv
));
333 fp
= fopen(filename
, "r");
335 errmsg
= "Unable to open key file";
338 if (!fgets(buffer
, sizeof(buffer
), fp
) ||
339 0 != strncmp(buffer
, "-----BEGIN ", 11) ||
340 0 != strcmp(buffer
+strlen(buffer
)-17, "PRIVATE KEY-----\n")) {
341 errmsg
= "File does not begin with OpenSSH key header";
344 if (!strcmp(buffer
, "-----BEGIN RSA PRIVATE KEY-----\n"))
345 ret
->type
= OSSH_RSA
;
346 else if (!strcmp(buffer
, "-----BEGIN DSA PRIVATE KEY-----\n"))
347 ret
->type
= OSSH_DSA
;
349 errmsg
= "Unrecognised key type";
355 if (!fgets(buffer
, sizeof(buffer
), fp
)) {
356 errmsg
= "Unexpected end of file";
359 if (0 == strncmp(buffer
, "-----END ", 9) &&
360 0 == strcmp(buffer
+strlen(buffer
)-17, "PRIVATE KEY-----\n"))
362 if ((p
= strchr(buffer
, ':')) != NULL
) {
364 errmsg
= "Header found in body of key data";
368 while (*p
&& isspace((unsigned char)*p
)) p
++;
369 if (!strcmp(buffer
, "Proc-Type")) {
370 if (p
[0] != '4' || p
[1] != ',') {
371 errmsg
= "Proc-Type is not 4 (only 4 is supported)";
375 if (!strcmp(p
, "ENCRYPTED\n"))
377 } else if (!strcmp(buffer
, "DEK-Info")) {
380 if (strncmp(p
, "DES-EDE3-CBC,", 13)) {
381 errmsg
= "Ciphers other than DES-EDE3-CBC not supported";
385 for (i
= 0; i
< 8; i
++) {
386 if (1 != sscanf(p
, "%2x", &j
))
392 errmsg
= "Expected 16-digit iv in DEK-Info";
400 while (isbase64(*p
)) {
401 base64_bit
[base64_chars
++] = *p
;
402 if (base64_chars
== 4) {
403 unsigned char out
[3];
408 len
= base64_decode_atom(base64_bit
, out
);
411 errmsg
= "Invalid base64 encoding";
415 if (ret
->keyblob_len
+ len
> ret
->keyblob_size
) {
416 ret
->keyblob_size
= ret
->keyblob_len
+ len
+ 256;
417 ret
->keyblob
= srealloc(ret
->keyblob
, ret
->keyblob_size
);
420 memcpy(ret
->keyblob
+ ret
->keyblob_len
, out
, len
);
421 ret
->keyblob_len
+= len
;
423 memset(out
, 0, sizeof(out
));
431 if (ret
->keyblob_len
== 0 || !ret
->keyblob
) {
432 errmsg
= "Key body not present";
436 if (ret
->encrypted
&& ret
->keyblob_len
% 8 != 0) {
437 errmsg
= "Encrypted key blob is not a multiple of cipher block size";
441 memset(buffer
, 0, sizeof(buffer
));
442 memset(base64_bit
, 0, sizeof(base64_bit
));
446 memset(buffer
, 0, sizeof(buffer
));
447 memset(base64_bit
, 0, sizeof(base64_bit
));
450 memset(ret
->keyblob
, 0, ret
->keyblob_size
);
453 memset(&ret
, 0, sizeof(ret
));
459 int openssh_encrypted(char *filename
)
461 struct openssh_key
*key
= load_openssh_key(filename
);
466 ret
= key
->encrypted
;
467 memset(key
->keyblob
, 0, key
->keyblob_size
);
469 memset(&key
, 0, sizeof(key
));
474 struct ssh2_userkey
*openssh_read(char *filename
, char *passphrase
)
476 struct openssh_key
*key
= load_openssh_key(filename
);
477 struct ssh2_userkey
*retkey
;
479 int ret
, id
, len
, flags
;
481 struct ssh2_userkey
*retval
= NULL
;
484 int blobsize
, blobptr
, privptr
;
491 if (key
->encrypted
) {
493 * Derive encryption key from passphrase and iv/salt:
495 * - let block A equal MD5(passphrase || iv)
496 * - let block B equal MD5(A || passphrase || iv)
497 * - block C would be MD5(B || passphrase || iv) and so on
498 * - encryption key is the first N bytes of A || B
500 struct MD5Context md5c
;
501 unsigned char keybuf
[32];
504 MD5Update(&md5c
, passphrase
, strlen(passphrase
));
505 MD5Update(&md5c
, key
->iv
, 8);
506 MD5Final(keybuf
, &md5c
);
509 MD5Update(&md5c
, keybuf
, 16);
510 MD5Update(&md5c
, passphrase
, strlen(passphrase
));
511 MD5Update(&md5c
, key
->iv
, 8);
512 MD5Final(keybuf
+16, &md5c
);
515 * Now decrypt the key blob.
517 des3_decrypt_pubkey_ossh(keybuf
, key
->iv
,
518 key
->keyblob
, key
->keyblob_len
);
520 memset(&md5c
, 0, sizeof(md5c
));
521 memset(keybuf
, 0, sizeof(keybuf
));
525 * Now we have a decrypted key blob, which contains an ASN.1
526 * encoded private key. We must now untangle the ASN.1.
528 * We expect the whole key blob to be formatted as a SEQUENCE
529 * (0x30 followed by a length code indicating that the rest of
530 * the blob is part of the sequence). Within that SEQUENCE we
531 * expect to see a bunch of INTEGERs. What those integers mean
532 * depends on the key type:
534 * - For RSA, we expect the integers to be 0, n, e, d, p, q,
535 * dmp1, dmq1, iqmp in that order. (The last three are d mod
536 * (p-1), d mod (q-1), inverse of q mod p respectively.)
538 * - For DSA, we expect them to be 0, p, q, g, y, x in that
544 /* Expect the SEQUENCE header. Take its absence as a failure to decrypt. */
545 ret
= ber_read_id_len(p
, key
->keyblob_len
, &id
, &len
, &flags
);
547 if (ret
< 0 || id
!= 16) {
548 errmsg
= "ASN.1 decoding failure";
549 retval
= SSH2_WRONG_PASSPHRASE
;
553 /* Expect a load of INTEGERs. */
554 if (key
->type
== OSSH_RSA
)
556 else if (key
->type
== OSSH_DSA
)
560 * Space to create key blob in.
562 blobsize
= 256+key
->keyblob_len
;
563 blob
= smalloc(blobsize
);
565 if (key
->type
== OSSH_DSA
)
566 memcpy(blob
+4, "ssh-dss", 7);
567 else if (key
->type
== OSSH_RSA
)
568 memcpy(blob
+4, "ssh-rsa", 7);
572 for (i
= 0; i
< num_integers
; i
++) {
573 ret
= ber_read_id_len(p
, key
->keyblob
+key
->keyblob_len
-p
,
576 if (ret
< 0 || id
!= 2 ||
577 key
->keyblob
+key
->keyblob_len
-p
< len
) {
578 errmsg
= "ASN.1 decoding failure";
584 * The first integer should be zero always (I think
585 * this is some sort of version indication).
587 if (len
!= 1 || p
[0] != 0) {
588 errmsg
= "Version number mismatch";
591 } else if (key
->type
== OSSH_RSA
) {
593 * Integers 1 and 2 go into the public blob but in the
594 * opposite order; integers 3, 4, 5 and 8 go into the
595 * private blob. The other two (6 and 7) are ignored.
598 /* Save the details for after we deal with number 2. */
601 } else if (i
!= 6 && i
!= 7) {
602 PUT_32BIT(blob
+blobptr
, len
);
603 memcpy(blob
+blobptr
+4, p
, len
);
606 PUT_32BIT(blob
+blobptr
, modlen
);
607 memcpy(blob
+blobptr
+4, modptr
, modlen
);
612 } else if (key
->type
== OSSH_DSA
) {
614 * Integers 1-4 go into the public blob; integer 5 goes
615 * into the private blob.
617 PUT_32BIT(blob
+blobptr
, len
);
618 memcpy(blob
+blobptr
+4, p
, len
);
624 /* Skip past the number. */
629 * Now put together the actual key. Simplest way to do this is
630 * to assemble our own key blobs and feed them to the createkey
631 * functions; this is a bit faffy but it does mean we get all
632 * the sanity checks for free.
634 assert(privptr
> 0); /* should have bombed by now if not */
635 retkey
= smalloc(sizeof(struct ssh2_userkey
));
636 retkey
->alg
= (key
->type
== OSSH_RSA ?
&ssh_rsa
: &ssh_dss
);
637 retkey
->data
= retkey
->alg
->createkey(blob
, privptr
,
638 blob
+privptr
, blobptr
-privptr
);
641 errmsg
= "unable to create key data structure";
645 retkey
->comment
= dupstr("imported-openssh-key");
646 errmsg
= NULL
; /* no error */
651 memset(blob
, 0, blobsize
);
654 memset(key
->keyblob
, 0, key
->keyblob_size
);
656 memset(&key
, 0, sizeof(key
));
661 int openssh_write(char *filename
, struct ssh2_userkey
*key
, char *passphrase
)
663 unsigned char *pubblob
, *privblob
, *spareblob
;
664 int publen
, privlen
, sparelen
;
665 unsigned char *outblob
;
667 struct mpint_pos numbers
[9];
668 int nnumbers
, pos
, len
, seqlen
, i
;
669 char *header
, *footer
;
676 * Fetch the key blobs.
678 pubblob
= key
->alg
->public_blob(key
->data
, &publen
);
679 privblob
= key
->alg
->private_blob(key
->data
, &privlen
);
680 spareblob
= outblob
= NULL
;
683 * Find the sequence of integers to be encoded into the OpenSSH
684 * key blob, and also decide on the header line.
686 if (key
->alg
== &ssh_rsa
) {
688 struct mpint_pos n
, e
, d
, p
, q
, iqmp
, dmp1
, dmq1
;
689 Bignum bd
, bp
, bq
, bdmp1
, bdmq1
;
691 pos
= 4 + GET_32BIT(pubblob
);
692 pos
+= ssh2_read_mpint(pubblob
+pos
, publen
-pos
, &e
);
693 pos
+= ssh2_read_mpint(pubblob
+pos
, publen
-pos
, &n
);
695 pos
+= ssh2_read_mpint(privblob
+pos
, privlen
-pos
, &d
);
696 pos
+= ssh2_read_mpint(privblob
+pos
, privlen
-pos
, &p
);
697 pos
+= ssh2_read_mpint(privblob
+pos
, privlen
-pos
, &q
);
698 pos
+= ssh2_read_mpint(privblob
+pos
, privlen
-pos
, &iqmp
);
700 assert(e
.start
&& iqmp
.start
); /* can't go wrong */
702 /* We also need d mod (p-1) and d mod (q-1). */
703 bd
= bignum_from_bytes(d
.start
, d
.bytes
);
704 bp
= bignum_from_bytes(p
.start
, p
.bytes
);
705 bq
= bignum_from_bytes(q
.start
, q
.bytes
);
708 bdmp1
= bigmod(bd
, bp
);
709 bdmq1
= bigmod(bd
, bq
);
714 dmp1
.bytes
= (bignum_bitcount(bdmp1
)+8)/8;
715 dmq1
.bytes
= (bignum_bitcount(bdmq1
)+8)/8;
716 sparelen
= dmp1
.bytes
+ dmq1
.bytes
;
717 spareblob
= smalloc(sparelen
);
718 dmp1
.start
= spareblob
;
719 dmq1
.start
= spareblob
+ dmp1
.bytes
;
720 for (i
= 0; i
< dmp1
.bytes
; i
++)
721 spareblob
[i
] = bignum_byte(bdmp1
, dmp1
.bytes
-1 - i
);
722 for (i
= 0; i
< dmq1
.bytes
; i
++)
723 spareblob
[i
+dmp1
.bytes
] = bignum_byte(bdmq1
, dmq1
.bytes
-1 - i
);
727 numbers
[0].start
= zero
; numbers
[0].bytes
= 1; zero
[0] = '\0';
738 header
= "-----BEGIN RSA PRIVATE KEY-----\n";
739 footer
= "-----END RSA PRIVATE KEY-----\n";
740 } else if (key
->alg
== &ssh_dss
) {
742 struct mpint_pos p
, q
, g
, y
, x
;
744 pos
= 4 + GET_32BIT(pubblob
);
745 pos
+= ssh2_read_mpint(pubblob
+pos
, publen
-pos
, &p
);
746 pos
+= ssh2_read_mpint(pubblob
+pos
, publen
-pos
, &q
);
747 pos
+= ssh2_read_mpint(pubblob
+pos
, publen
-pos
, &g
);
748 pos
+= ssh2_read_mpint(pubblob
+pos
, publen
-pos
, &y
);
750 pos
+= ssh2_read_mpint(privblob
+pos
, privlen
-pos
, &x
);
752 assert(y
.start
&& x
.start
); /* can't go wrong */
754 numbers
[0].start
= zero
; numbers
[0].bytes
= 1; zero
[0] = '\0';
762 header
= "-----BEGIN DSA PRIVATE KEY-----\n";
763 footer
= "-----END DSA PRIVATE KEY-----\n";
765 assert(0); /* zoinks! */
769 * Now count up the total size of the ASN.1 encoded integers,
770 * so as to determine the length of the containing SEQUENCE.
773 for (i
= 0; i
< nnumbers
; i
++) {
774 len
+= ber_write_id_len(NULL
, 2, numbers
[i
].bytes
, 0);
775 len
+= numbers
[i
].bytes
;
778 /* Now add on the SEQUENCE header. */
779 len
+= ber_write_id_len(NULL
, 16, seqlen
, ASN1_CONSTRUCTED
);
780 /* And round up to the cipher block size. */
785 * Now we know how big outblob needs to be. Allocate it.
788 outblob
= smalloc(outlen
);
791 * And write the data into it.
794 pos
+= ber_write_id_len(outblob
+pos
, 16, seqlen
, ASN1_CONSTRUCTED
);
795 for (i
= 0; i
< nnumbers
; i
++) {
796 pos
+= ber_write_id_len(outblob
+pos
, 2, numbers
[i
].bytes
, 0);
797 memcpy(outblob
+pos
, numbers
[i
].start
, numbers
[i
].bytes
);
798 pos
+= numbers
[i
].bytes
;
800 while (pos
< outlen
) {
801 outblob
[pos
++] = random_byte();
809 * Invent an iv. Then derive encryption key from passphrase
812 * - let block A equal MD5(passphrase || iv)
813 * - let block B equal MD5(A || passphrase || iv)
814 * - block C would be MD5(B || passphrase || iv) and so on
815 * - encryption key is the first N bytes of A || B
817 struct MD5Context md5c
;
818 unsigned char keybuf
[32];
820 for (i
= 0; i
< 8; i
++) iv
[i
] = random_byte();
823 MD5Update(&md5c
, passphrase
, strlen(passphrase
));
824 MD5Update(&md5c
, iv
, 8);
825 MD5Final(keybuf
, &md5c
);
828 MD5Update(&md5c
, keybuf
, 16);
829 MD5Update(&md5c
, passphrase
, strlen(passphrase
));
830 MD5Update(&md5c
, iv
, 8);
831 MD5Final(keybuf
+16, &md5c
);
834 * Now encrypt the key blob.
836 des3_encrypt_pubkey_ossh(keybuf
, iv
, outblob
, outlen
);
838 memset(&md5c
, 0, sizeof(md5c
));
839 memset(keybuf
, 0, sizeof(keybuf
));
843 * And save it. We'll use Unix line endings just in case it's
844 * subsequently transferred in binary mode.
846 fp
= fopen(filename
, "wb"); /* ensure Unix line endings */
851 fprintf(fp
, "Proc-Type: 4,ENCRYPTED\nDEK-Info: DES-EDE3-CBC,");
852 for (i
= 0; i
< 8; i
++)
853 fprintf(fp
, "%02X", iv
[i
]);
856 base64_encode(fp
, outblob
, outlen
, 64);
863 memset(outblob
, 0, outlen
);
867 memset(spareblob
, 0, sparelen
);
871 memset(privblob
, 0, privlen
);
875 memset(pubblob
, 0, publen
);
881 /* ----------------------------------------------------------------------
882 * Code to read ssh.com private keys.
886 * The format of the base64 blob is largely ssh2-packet-formatted,
887 * except that mpints are a bit different: they're more like the
888 * old ssh1 mpint. You have a 32-bit bit count N, followed by
889 * (N+7)/8 bytes of data.
891 * So. The blob contains:
893 * - uint32 0x3f6ff9eb (magic number)
894 * - uint32 size (total blob size)
895 * - string key-type (see below)
896 * - string cipher-type (tells you if key is encrypted)
897 * - string encrypted-blob
899 * (The first size field includes the size field itself and the
900 * magic number before it. All other size fields are ordinary ssh2
901 * strings, so the size field indicates how much data is to
904 * The encrypted blob, once decrypted, contains a single string
905 * which in turn contains the payload. (This allows padding to be
906 * added after that string while still making it clear where the
907 * real payload ends. Also it probably makes for a reasonable
910 * The payload blob, for an RSA key, contains:
913 * - mpint n (yes, the public and private stuff is intermixed)
914 * - mpint u (presumably inverse of p mod q)
915 * - mpint p (p is the smaller prime)
916 * - mpint q (q is the larger)
918 * For a DSA key, the payload blob contains:
926 * Alternatively, if the parameters are `predefined', that
927 * (0,p,g,q) sequence can be replaced by a uint32 1 and a string
928 * containing some predefined parameter specification. *shudder*,
929 * but I doubt we'll encounter this in real life.
931 * The key type strings are ghastly. The RSA key I looked at had a
934 * `if-modn{sign{rsa-pkcs1-sha1},encrypt{rsa-pkcs1v2-oaep}}'
936 * and the DSA key wasn't much better:
938 * `dl-modp{sign{dsa-nist-sha1},dh{plain}}'
940 * It isn't clear that these will always be the same. I think it
941 * might be wise just to look at the `if-modn{sign{rsa' and
942 * `dl-modp{sign{dsa' prefixes.
944 * Finally, the encryption. The cipher-type string appears to be
945 * either `none' or `3des-cbc'. Looks as if this is SSH2-style
946 * 3des-cbc (i.e. outer cbc rather than inner). The key is created
947 * from the passphrase by means of yet another hashing faff:
949 * - first 16 bytes are MD5(passphrase)
950 * - next 16 bytes are MD5(passphrase || first 16 bytes)
951 * - if there were more, they'd be MD5(passphrase || first 32),
955 #define SSHCOM_MAGIC_NUMBER 0x3f6ff9eb
958 char comment
[256]; /* allowing any length is overkill */
959 unsigned char *keyblob
;
960 int keyblob_len
, keyblob_size
;
963 struct sshcom_key
*load_sshcom_key(char *filename
)
965 struct sshcom_key
*ret
;
972 int base64_chars
= 0;
974 ret
= smalloc(sizeof(*ret
));
975 ret
->comment
[0] = '\0';
977 ret
->keyblob_len
= ret
->keyblob_size
= 0;
979 fp
= fopen(filename
, "r");
981 errmsg
= "Unable to open key file";
984 if (!fgets(buffer
, sizeof(buffer
), fp
) ||
985 0 != strcmp(buffer
, "---- BEGIN SSH2 ENCRYPTED PRIVATE KEY ----\n")) {
986 errmsg
= "File does not begin with ssh.com key header";
992 if (!fgets(buffer
, sizeof(buffer
), fp
)) {
993 errmsg
= "Unexpected end of file";
996 if (!strcmp(buffer
, "---- END SSH2 ENCRYPTED PRIVATE KEY ----\n"))
998 if ((p
= strchr(buffer
, ':')) != NULL
) {
1000 errmsg
= "Header found in body of key data";
1004 while (*p
&& isspace((unsigned char)*p
)) p
++;
1006 * Header lines can end in a trailing backslash for
1009 while ((len
= strlen(p
)) > sizeof(buffer
) - (p
-buffer
) -1 ||
1010 p
[len
-1] != '\n' || p
[len
-2] == '\\') {
1011 if (len
> (p
-buffer
) + sizeof(buffer
)-2) {
1012 errmsg
= "Header line too long to deal with";
1015 if (!fgets(p
+len
-2, sizeof(buffer
)-(p
-buffer
)-(len
-2), fp
)) {
1016 errmsg
= "Unexpected end of file";
1020 p
[strcspn(p
, "\n")] = '\0';
1021 if (!strcmp(buffer
, "Comment")) {
1022 /* Strip quotes in comment if present. */
1023 if (p
[0] == '"' && p
[strlen(p
)-1] == '"') {
1025 p
[strlen(p
)-1] = '\0';
1027 strncpy(ret
->comment
, p
, sizeof(ret
->comment
));
1028 ret
->comment
[sizeof(ret
->comment
)-1] = '\0';
1034 while (isbase64(*p
)) {
1035 base64_bit
[base64_chars
++] = *p
;
1036 if (base64_chars
== 4) {
1037 unsigned char out
[3];
1041 len
= base64_decode_atom(base64_bit
, out
);
1044 errmsg
= "Invalid base64 encoding";
1048 if (ret
->keyblob_len
+ len
> ret
->keyblob_size
) {
1049 ret
->keyblob_size
= ret
->keyblob_len
+ len
+ 256;
1050 ret
->keyblob
= srealloc(ret
->keyblob
, ret
->keyblob_size
);
1053 memcpy(ret
->keyblob
+ ret
->keyblob_len
, out
, len
);
1054 ret
->keyblob_len
+= len
;
1062 if (ret
->keyblob_len
== 0 || !ret
->keyblob
) {
1063 errmsg
= "Key body not present";
1072 memset(ret
->keyblob
, 0, ret
->keyblob_size
);
1073 sfree(ret
->keyblob
);
1075 memset(&ret
, 0, sizeof(ret
));
1081 int sshcom_encrypted(char *filename
, char **comment
)
1083 struct sshcom_key
*key
= load_sshcom_key(filename
);
1084 int pos
, len
, answer
;
1091 * Check magic number.
1093 if (GET_32BIT(key
->keyblob
) != 0x3f6ff9eb)
1094 return 0; /* key is invalid */
1097 * Find the cipher-type string.
1101 if (key
->keyblob_len
< pos
+4)
1102 goto done
; /* key is far too short */
1103 pos
+= 4 + GET_32BIT(key
->keyblob
+ pos
); /* skip key type */
1104 if (key
->keyblob_len
< pos
+4)
1105 goto done
; /* key is far too short */
1106 len
= GET_32BIT(key
->keyblob
+ pos
); /* find cipher-type length */
1107 if (key
->keyblob_len
< pos
+4+len
)
1108 goto done
; /* cipher type string is incomplete */
1109 if (len
!= 4 || 0 != memcmp(key
->keyblob
+ pos
+ 4, "none", 4))
1113 *comment
= dupstr(key
->comment
);
1114 memset(key
->keyblob
, 0, key
->keyblob_size
);
1115 sfree(key
->keyblob
);
1116 memset(&key
, 0, sizeof(key
));
1121 int sshcom_read_mpint(void *data
, int len
, struct mpint_pos
*ret
)
1125 unsigned char *d
= (unsigned char *) data
;
1129 bits
= GET_32BIT(d
);
1131 bytes
= (bits
+ 7) / 8;
1142 return len
; /* ensure further calls fail as well */
1145 static int sshcom_put_mpint(void *target
, void *data
, int len
)
1147 unsigned char *d
= (unsigned char *)target
;
1148 unsigned char *i
= (unsigned char *)data
;
1149 int bits
= len
* 8 - 1;
1152 if (*i
& (1 << (bits
& 7)))
1158 PUT_32BIT(d
, bits
+1);
1159 memcpy(d
+4, i
, len
);
1163 struct ssh2_userkey
*sshcom_read(char *filename
, char *passphrase
)
1165 struct sshcom_key
*key
= load_sshcom_key(filename
);
1168 const char prefix_rsa
[] = "if-modn{sign{rsa";
1169 const char prefix_dsa
[] = "dl-modp{sign{dsa";
1170 enum { RSA
, DSA
} type
;
1174 struct ssh2_userkey
*ret
= NULL
, *retkey
;
1175 const struct ssh_signkey
*alg
;
1176 unsigned char *blob
= NULL
;
1177 int blobsize
, publen
, privlen
;
1183 * Check magic number.
1185 if (GET_32BIT(key
->keyblob
) != SSHCOM_MAGIC_NUMBER
) {
1186 errmsg
= "Key does not begin with magic number";
1191 * Determine the key type.
1194 if (key
->keyblob_len
< pos
+4 ||
1195 (len
= GET_32BIT(key
->keyblob
+ pos
)) > key
->keyblob_len
- pos
- 4) {
1196 errmsg
= "Key blob does not contain a key type string";
1199 if (len
> sizeof(prefix_rsa
) - 1 &&
1200 !memcmp(key
->keyblob
+pos
+4, prefix_rsa
, sizeof(prefix_rsa
) - 1)) {
1202 } else if (len
> sizeof(prefix_dsa
) - 1 &&
1203 !memcmp(key
->keyblob
+pos
+4, prefix_dsa
, sizeof(prefix_dsa
) - 1)) {
1206 errmsg
= "Key is of unknown type";
1212 * Determine the cipher type.
1214 if (key
->keyblob_len
< pos
+4 ||
1215 (len
= GET_32BIT(key
->keyblob
+ pos
)) > key
->keyblob_len
- pos
- 4) {
1216 errmsg
= "Key blob does not contain a cipher type string";
1219 if (len
== 4 && !memcmp(key
->keyblob
+pos
+4, "none", 4))
1221 else if (len
== 8 && !memcmp(key
->keyblob
+pos
+4, "3des-cbc", 8))
1224 errmsg
= "Key encryption is of unknown type";
1230 * Get hold of the encrypted part of the key.
1232 if (key
->keyblob_len
< pos
+4 ||
1233 (len
= GET_32BIT(key
->keyblob
+ pos
)) > key
->keyblob_len
- pos
- 4) {
1234 errmsg
= "Key blob does not contain actual key data";
1237 ciphertext
= key
->keyblob
+ pos
+ 4;
1239 if (cipherlen
== 0) {
1240 errmsg
= "Length of key data is zero";
1245 * Decrypt it if necessary.
1249 * Derive encryption key from passphrase and iv/salt:
1251 * - let block A equal MD5(passphrase)
1252 * - let block B equal MD5(passphrase || A)
1253 * - block C would be MD5(passphrase || A || B) and so on
1254 * - encryption key is the first N bytes of A || B
1256 struct MD5Context md5c
;
1257 unsigned char keybuf
[32], iv
[8];
1259 if (cipherlen
% 8 != 0) {
1260 errmsg
= "Encrypted part of key is not a multiple of cipher block"
1266 MD5Update(&md5c
, passphrase
, strlen(passphrase
));
1267 MD5Final(keybuf
, &md5c
);
1270 MD5Update(&md5c
, passphrase
, strlen(passphrase
));
1271 MD5Update(&md5c
, keybuf
, 16);
1272 MD5Final(keybuf
+16, &md5c
);
1275 * Now decrypt the key blob.
1277 memset(iv
, 0, sizeof(iv
));
1278 des3_decrypt_pubkey_ossh(keybuf
, iv
, ciphertext
, cipherlen
);
1280 memset(&md5c
, 0, sizeof(md5c
));
1281 memset(keybuf
, 0, sizeof(keybuf
));
1284 * Hereafter we return WRONG_PASSPHRASE for any parsing
1285 * error. (But only if we've just tried to decrypt it!
1286 * Returning WRONG_PASSPHRASE for an unencrypted key is
1290 ret
= SSH2_WRONG_PASSPHRASE
;
1294 * Strip away the containing string to get to the real meat.
1296 len
= GET_32BIT(ciphertext
);
1297 if (len
> cipherlen
-4) {
1298 errmsg
= "containing string was ill-formed";
1305 * Now we break down into RSA versus DSA. In either case we'll
1306 * construct public and private blobs in our own format, and
1307 * end up feeding them to alg->createkey().
1309 blobsize
= cipherlen
+ 256;
1310 blob
= smalloc(blobsize
);
1313 struct mpint_pos n
, e
, d
, u
, p
, q
;
1315 pos
+= sshcom_read_mpint(ciphertext
+pos
, cipherlen
-pos
, &e
);
1316 pos
+= sshcom_read_mpint(ciphertext
+pos
, cipherlen
-pos
, &d
);
1317 pos
+= sshcom_read_mpint(ciphertext
+pos
, cipherlen
-pos
, &n
);
1318 pos
+= sshcom_read_mpint(ciphertext
+pos
, cipherlen
-pos
, &u
);
1319 pos
+= sshcom_read_mpint(ciphertext
+pos
, cipherlen
-pos
, &p
);
1320 pos
+= sshcom_read_mpint(ciphertext
+pos
, cipherlen
-pos
, &q
);
1322 errmsg
= "key data did not contain six integers";
1328 pos
+= put_string(blob
+pos
, "ssh-rsa", 7);
1329 pos
+= put_mp(blob
+pos
, e
.start
, e
.bytes
);
1330 pos
+= put_mp(blob
+pos
, n
.start
, n
.bytes
);
1332 pos
+= put_string(blob
+pos
, d
.start
, d
.bytes
);
1333 pos
+= put_mp(blob
+pos
, q
.start
, q
.bytes
);
1334 pos
+= put_mp(blob
+pos
, p
.start
, p
.bytes
);
1335 pos
+= put_mp(blob
+pos
, u
.start
, u
.bytes
);
1336 privlen
= pos
- publen
;
1337 } else if (type
== DSA
) {
1338 struct mpint_pos p
, q
, g
, x
, y
;
1340 if (GET_32BIT(ciphertext
) != 0) {
1341 errmsg
= "predefined DSA parameters not supported";
1344 pos
+= sshcom_read_mpint(ciphertext
+pos
, cipherlen
-pos
, &p
);
1345 pos
+= sshcom_read_mpint(ciphertext
+pos
, cipherlen
-pos
, &g
);
1346 pos
+= sshcom_read_mpint(ciphertext
+pos
, cipherlen
-pos
, &q
);
1347 pos
+= sshcom_read_mpint(ciphertext
+pos
, cipherlen
-pos
, &y
);
1348 pos
+= sshcom_read_mpint(ciphertext
+pos
, cipherlen
-pos
, &x
);
1350 errmsg
= "key data did not contain five integers";
1356 pos
+= put_string(blob
+pos
, "ssh-dss", 7);
1357 pos
+= put_mp(blob
+pos
, p
.start
, p
.bytes
);
1358 pos
+= put_mp(blob
+pos
, q
.start
, q
.bytes
);
1359 pos
+= put_mp(blob
+pos
, g
.start
, g
.bytes
);
1360 pos
+= put_mp(blob
+pos
, y
.start
, y
.bytes
);
1362 pos
+= put_mp(blob
+pos
, x
.start
, x
.bytes
);
1363 privlen
= pos
- publen
;
1366 assert(privlen
> 0); /* should have bombed by now if not */
1368 retkey
= smalloc(sizeof(struct ssh2_userkey
));
1370 retkey
->data
= alg
->createkey(blob
, publen
, blob
+publen
, privlen
);
1371 if (!retkey
->data
) {
1373 errmsg
= "unable to create key data structure";
1376 retkey
->comment
= dupstr(key
->comment
);
1378 errmsg
= NULL
; /* no error */
1383 memset(blob
, 0, blobsize
);
1386 memset(key
->keyblob
, 0, key
->keyblob_size
);
1387 sfree(key
->keyblob
);
1388 memset(&key
, 0, sizeof(key
));
1393 int sshcom_write(char *filename
, struct ssh2_userkey
*key
, char *passphrase
)
1395 unsigned char *pubblob
, *privblob
;
1396 int publen
, privlen
;
1397 unsigned char *outblob
;
1399 struct mpint_pos numbers
[6];
1400 int nnumbers
, initial_zero
, pos
, lenpos
, i
;
1408 * Fetch the key blobs.
1410 pubblob
= key
->alg
->public_blob(key
->data
, &publen
);
1411 privblob
= key
->alg
->private_blob(key
->data
, &privlen
);
1415 * Find the sequence of integers to be encoded into the OpenSSH
1416 * key blob, and also decide on the header line.
1418 if (key
->alg
== &ssh_rsa
) {
1420 struct mpint_pos n
, e
, d
, p
, q
, iqmp
;
1422 pos
= 4 + GET_32BIT(pubblob
);
1423 pos
+= ssh2_read_mpint(pubblob
+pos
, publen
-pos
, &e
);
1424 pos
+= ssh2_read_mpint(pubblob
+pos
, publen
-pos
, &n
);
1426 pos
+= ssh2_read_mpint(privblob
+pos
, privlen
-pos
, &d
);
1427 pos
+= ssh2_read_mpint(privblob
+pos
, privlen
-pos
, &p
);
1428 pos
+= ssh2_read_mpint(privblob
+pos
, privlen
-pos
, &q
);
1429 pos
+= ssh2_read_mpint(privblob
+pos
, privlen
-pos
, &iqmp
);
1431 assert(e
.start
&& iqmp
.start
); /* can't go wrong */
1442 type
= "if-modn{sign{rsa-pkcs1-sha1},encrypt{rsa-pkcs1v2-oaep}}";
1443 } else if (key
->alg
== &ssh_dss
) {
1445 struct mpint_pos p
, q
, g
, y
, x
;
1447 pos
= 4 + GET_32BIT(pubblob
);
1448 pos
+= ssh2_read_mpint(pubblob
+pos
, publen
-pos
, &p
);
1449 pos
+= ssh2_read_mpint(pubblob
+pos
, publen
-pos
, &q
);
1450 pos
+= ssh2_read_mpint(pubblob
+pos
, publen
-pos
, &g
);
1451 pos
+= ssh2_read_mpint(pubblob
+pos
, publen
-pos
, &y
);
1453 pos
+= ssh2_read_mpint(privblob
+pos
, privlen
-pos
, &x
);
1455 assert(y
.start
&& x
.start
); /* can't go wrong */
1465 type
= "dl-modp{sign{dsa-nist-sha1},dh{plain}}";
1467 assert(0); /* zoinks! */
1471 * Total size of key blob will be somewhere under 512 plus
1472 * combined length of integers. We'll calculate the more
1473 * precise size as we construct the blob.
1476 for (i
= 0; i
< nnumbers
; i
++)
1477 outlen
+= 4 + numbers
[i
].bytes
;
1478 outblob
= smalloc(outlen
);
1481 * Create the unencrypted key blob.
1484 PUT_32BIT(outblob
+pos
, SSHCOM_MAGIC_NUMBER
); pos
+= 4;
1485 pos
+= 4; /* length field, fill in later */
1486 pos
+= put_string(outblob
+pos
, type
, strlen(type
));
1488 char *ciphertype
= passphrase ?
"3des-cbc" : "none";
1489 pos
+= put_string(outblob
+pos
, ciphertype
, strlen(ciphertype
));
1491 lenpos
= pos
; /* remember this position */
1492 pos
+= 4; /* encrypted-blob size */
1493 pos
+= 4; /* encrypted-payload size */
1495 PUT_32BIT(outblob
+pos
, 0);
1498 for (i
= 0; i
< nnumbers
; i
++)
1499 pos
+= sshcom_put_mpint(outblob
+pos
,
1500 numbers
[i
].start
, numbers
[i
].bytes
);
1501 /* Now wrap up the encrypted payload. */
1502 PUT_32BIT(outblob
+lenpos
+4, pos
- (lenpos
+8));
1503 /* Pad encrypted blob to a multiple of cipher block size. */
1505 int padding
= -(pos
- (lenpos
+4)) & 7;
1507 outblob
[pos
++] = random_byte();
1509 ciphertext
= outblob
+lenpos
+4;
1510 cipherlen
= pos
- (lenpos
+4);
1511 assert(!passphrase
|| cipherlen
% 8 == 0);
1512 /* Wrap up the encrypted blob string. */
1513 PUT_32BIT(outblob
+lenpos
, cipherlen
);
1514 /* And finally fill in the total length field. */
1515 PUT_32BIT(outblob
+4, pos
);
1517 assert(pos
< outlen
);
1524 * Derive encryption key from passphrase and iv/salt:
1526 * - let block A equal MD5(passphrase)
1527 * - let block B equal MD5(passphrase || A)
1528 * - block C would be MD5(passphrase || A || B) and so on
1529 * - encryption key is the first N bytes of A || B
1531 struct MD5Context md5c
;
1532 unsigned char keybuf
[32], iv
[8];
1535 MD5Update(&md5c
, passphrase
, strlen(passphrase
));
1536 MD5Final(keybuf
, &md5c
);
1539 MD5Update(&md5c
, passphrase
, strlen(passphrase
));
1540 MD5Update(&md5c
, keybuf
, 16);
1541 MD5Final(keybuf
+16, &md5c
);
1544 * Now decrypt the key blob.
1546 memset(iv
, 0, sizeof(iv
));
1547 des3_encrypt_pubkey_ossh(keybuf
, iv
, ciphertext
, cipherlen
);
1549 memset(&md5c
, 0, sizeof(md5c
));
1550 memset(keybuf
, 0, sizeof(keybuf
));
1554 * And save it. We'll use Unix line endings just in case it's
1555 * subsequently transferred in binary mode.
1557 fp
= fopen(filename
, "wb"); /* ensure Unix line endings */
1560 fputs("---- BEGIN SSH2 ENCRYPTED PRIVATE KEY ----\n", fp
);
1561 fprintf(fp
, "Comment: \"");
1563 * Comment header is broken with backslash-newline if it goes
1564 * over 70 chars. Although it's surrounded by quotes, it
1565 * _doesn't_ escape backslashes or quotes within the string.
1566 * Don't ask me, I didn't design it.
1569 int slen
= 60; /* starts at 60 due to "Comment: " */
1570 char *c
= key
->comment
;
1571 while (strlen(c
) > slen
) {
1572 fprintf(fp
, "%.*s\\\n", slen
, c
);
1574 slen
= 70; /* allow 70 chars on subsequent lines */
1576 fprintf(fp
, "%s\"\n", c
);
1578 base64_encode(fp
, outblob
, pos
, 70);
1579 fputs("---- END SSH2 ENCRYPTED PRIVATE KEY ----\n", fp
);
1585 memset(outblob
, 0, outlen
);
1589 memset(privblob
, 0, privlen
);
1593 memset(pubblob
, 0, publen
);