uvmac/docs/extras/makekeys/index.html
2020-03-14 15:28:01 -04:00

1 line
7.3 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title> MakeKeys </title>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<meta name="viewport" content="width=device-width, initial-scale=1">
<link rel="canonical" href="index.html">
</head>
<body>
<div>
<i> <a href="https://www.gryphel.com/index.html">www.gryphel.com</a>/c/<a href="../../index.html">minivmac</a>/<a href="../index.html">extras</a>/makekeys
- <a href="https://www.gryphel.com/c/feedback.html">feedback</a> </i>
</div>
<hr>
<h2 align=center>
MakeKeys
</h2>
<hr>
<p> Download </p>
<blockquote>
<p> <a href="https://www.gryphel.com/d/minivmac/extras/makekeys/makekeys-1.1.0.zip">makekeys-1.1.0.zip</a>
(123K) a zipped hfs disk image and checksum file.
The disk image can be mounted with Mini vMac.
Includes source code.
</p>
</blockquote>
<p>
MakeKeys is a tool to make
secret and public key pairs for use in writing and verifying
digital signatures, such as with the
<a href="../sigwrite/index.html">SigWrite</a>
and
<a href="../sigcheck/index.html">SigCheck</a>
tools.
</p>
<p> <img src="https://www.gryphel.com/d/minivmac/extras/makekeys/screen.gif" width=514 height=344 border=0 alt="Screenshot"> </p>
<p> To use MakeKeys, launch the application, and in the editing window
that appears, paste in some truly random (not psuedo-random)
hexadecimal data, which can be generated with
<a href="../makerand/index.html">MakeRand</a>.
For example: </p>
<blockquote>
<pre>
42D8A22109876964FEA9CF70F6DDDC54
D0DBA11B7066D7249369E381872CB523
2E55796E50ACFFE979D43196F041B660
DEB1A6139AFBCD333CE4282CDDE043FF
CD84A6A9307AF6B6EC2ED05D1238D3E6
C30F03EF59E75009CB67CB5D43177831
BE31F973FF8DDA36E1F0AC42AC1C0994
899CBC583E7AA20EC72BBEFEC06BBC84
</pre>
</blockquote>
<p>
Copy all of the indented text above. Then paste it into MakeKeys,
which requires getting the clipboard into the emulated Macintosh, if
MakeKeys is run inside Mini vMac. You can get
text into the emulated Macintosh using the &ldquo;Host Paste&rdquo;
command in the Edit Menu of MakeKeys. It is like the &ldquo;Paste&rdquo; command,
except that it uses the clipboard of the real computer instead
of the clipboard of the emulated computer. The keyboard shortcut
is Command-Option-V. (The &ldquo;Host Paste&rdquo; command has
similar effect to using
<a href="../clipin/index.html">ClipIn</a>
and then the normal &ldquo;Paste&rdquo; command.)
</p>
<p> MakeKeys only uses multiples of 128 bits, which equals
32 hexadecimal digits, as on the lines above. Any excess digits
are discarded. The above 8 lines add up to 1024 bits. </p>
<p>
Before continuing, it would be a good idea to set Mini vMac to
<a href="../../hardware.html#processor">All Out speed</a>.
Then, on a modern computer, MakeKeys should
take less than 5 minutes to run (for a 1024 bit key, as
in this example).
At 1x speed, or on a real Macintosh Plus, it takes much longer.
(Up to a day.)
The code of MakeKeys is intended to be simple
to understand and maintain, as opposed to fast.
</p>
<p> Now, click on the status bar, at the bottom
of the window below the editing area.
(Choosing the &lsquo;Go&rsquo; command from the File menu,
of the emulated Macintosh, will also work.) </p>
<p>
After a long while, if
all is well, the edit area is replaced with a new secret key:
</p>
<blockquote>
<pre>
----- BEGIN GRY SECRET KEY -----
Gry+SKAIAAA/AXuKqWsF8Rh5Ie4/vORBnTxYf8FPpRl/n6hpgDgfJ5MAOsAEyePE
nSfjmL3I9emNTuW/iCIHlCl/WkaWyMQZ+NDb1ZsnSLyOKwOycVkR3JwJbUamM4wy
jUuoWV6jzuhqWZobpGPMSN4B3ivHXtcNVm5SVmnAL13T4FCLnx+TxaYRAQAB9n9N
yEapaUzZs3Pdv2zNzs77wWHev2/i0qAIFxBLWI5VvPd6NuXEefADAtAJHhzm9koz
gWrLZ9pVF+D537ewv3/mZJPGS0u7Ino5F3AQ20NhDvX3JwovUSgUkmy59PbJgZ2M
0zNCvKuephFJbT4Pgi2oc7ZT/qZagkNNDErbyLb7NvBAU6+Ezbb2ejBd0C7s5tM4
Eu8DD8MJUOdZXctnyzF4F0Nz+TG+NtqN/0Ks8OGUCRysWLyciQ6iej7+vivHhLxr
wPBA26XYQmRphwlwz6n+VNzd9huh29Ak12ZwgeNpkyO1LIdueVUu6f+sUJYx1Hlg
tkHwE6ax3jPN+5osKOQ8/0Pg3fY/8CwOIpqLB6QDLCtY2ZrfM69mWkw/QTyGNSDU
FIkI5corJbgms5mGMGQ2CyEZZ3RjzDtP5YwVAdzd4oNdKLHsK+k4nA==
------ END GRY SECRET KEY ------
</pre>
</blockquote>
<p>
The above secret key is only an example. Normally, a secret key
should never be given to anyone else. The random hexadecimal data
used to create the secret key should of course also be kept
secret.
</p>
<p>
Again, click on the status bar. The edit area is
then replaced with the corresponding public key:
</p>
<blockquote>
<pre>
----- BEGIN GRY PUBLIC KEY -----
Gry+PKAIAAA/AXuKqWsF8Rh5Ie4/vORBnTxYf8FPpRl/n6hpgDgfJ5MAOsAEyePE
nSfjmL3I9emNTuW/iCIHlCl/WkaWyMQZ+NDb1ZsnSLyOKwOycVkR3JwJbUamM4wy
jUuoWV6jzuhqWZobpGPMSN4B3ivHXtcNVm5SVmnAL13T4FCLnx+TxaYRAQABwA54
------ END GRY PUBLIC KEY ------
</pre>
</blockquote>
<p>
When MakeKeys is run inside Mini vMac, you can get
text out of the emulated Macintosh using the &ldquo;Host Copy&rdquo;
command in the Edit Menu. It is like the &ldquo;Copy&rdquo; command,
except that it uses the clipboard of the real computer instead
of the clipboard of the emulated computer. The keyboard shortcut
is Command-Option-C. (The &ldquo;Host Copy&rdquo; command has
similar effect to using the normal &ldquo;Copy&rdquo; command and then
<a href="../clipout/index.html">ClipOut</a>.)
</p>
<p>
MakeKeys is in part descended from MacPGP source code, which, as far as
I can tell, allows derived works for noncommercial use.
</p>
<p>
<!-- MakeKeys generates keys compatibile with MacPGP, but it
does not encrypt the secret key. -->
MacPGP has various code to try
to protect secrets from other software running on the computer.
MakeKeys does not, instead you should try to secure the entire virtual
machine that it is run in. Such as by putting the Mini vMac disk
image on an encrypted volume of the host computer, for a start.
</p>
<!--
<p>
Another difference with MacPGP is that MakeKeys sets the user name
field to "anon", rather than asking for one.
</p>
-->
<p>
<a href="../mkkeystl/index.html">MkKeysTl</a>
is a command line version of MakeKeys.
</p>
<p>
MakeKeys is a successor to
<a href="../pmakkeys/index.html">PMakKeys</a>,
which uses a different format that is more or less compatible
with MacPGP.
</p>
<p>
Here is the md5 checksum for the download, signed with
<a href="https://www.gryphel.com/c/keys/k5.html">Gryphel Key 5</a>:
</p>
<blockquote>
<pre>
--------- GRY SIGNED TEXT ---------
92e878f7a80ff7d89d61c5a36db27d00 makekeys-1.1.0.zip
------- BEGIN GRY SIGNATURE -------
Gry/4Xa8CFcUzxdN/HjXdzoGq3PR347yuAykIJEVfJOMAerU/3vCWD+0NphsDqzO
7hb/RLJ8f/+bcPfp4wkOgK9JA/uL/G5UwSYxoMWlPbLK5WDgZINrFIgWxACZdO9f
ipXPlHirzjjUnB6mi7ZMmX+H7HgTkppxAzCNGGbsvxzcOeC56qI+NCwtf5sQjp/V
-------- END GRY SIGNATURE --------
</pre>
</blockquote>
<p> See the
<a href="../../appc/index.html">Compiling</a>
page for instructions on compiling MakeKeys from the source code. </p>
<p> : </p>
<p> If you find MakeKeys useful, please consider
<a href="https://www.gryphel.com/c/help/index.html">helping the Gryphel Project</a>,
of which it is a part. </p>
<a href="https://www.gryphel.com/index.html">
<img src="https://www.gryphel.com/d/gryphel-32.gif" width=32 height=32 border=0
alt="gryphel logo, 1K"
>
</a>
<hr>
<div>
<i> <a href="https://www.gryphel.com/index.html">www.gryphel.com</a>/c/<a href="../../index.html">minivmac</a>/<a href="../index.html">extras</a>/makekeys
- <a href="https://www.gryphel.com/c/feedback.html">feedback</a> </i>
<br>
copyright (c) 2018 Paul C. Pratt - last update 10/19/2018
</div>
</body>
</html>