Stork Tutorial: Identities

To start using Stork's enduser utilities, you will first need to create an identity. You can do this using the 'genpair' function. This will create a private key and a public key, which will identify you and the software you wish to distribute. The privatekey is used to sign the files that Stork uses to install your software, so be sure to keep it safe. The public key is distributed to all your nodes (and all others that wish to use your software). Note that Stork will generate an error if you attempt to use it before creating a pair of keys and setting it as your default identity.

To create your keys, just run the command:
./storkutil.py genpair USERNAME
where USERNAME is any username you desire. The username exists so that users can recognize each other without having to base interaction solely on public and private keys. After running the genpair command, Stork will ask you if you want this to be your default identity; if this is your first time using Stork, it is best to set this key as your default. If you've already created keys and would like to use those, you can use the 'storkutil.py setdefault USERNAME' command.

./storkutil.py genpair foo Generated foo.privatekey... Extracted foo.publickey... Would you like to make 'foo' your default identity? (y/n) > y 'foo' is now your default identity ./storkutil.py genpair foo Error: Key files for 'foo' already exist

or, if you have already created foo.privatekey and foo.publickey:

./storkutil.py setdefault foo Previous Identity: someguy 'foo' is now your default identity

Be sure that the privatekey and publickey are in your current directory while using storkutil. The publickey can be distributed to all your nodes through the upload website. Also, note that your public key is embedded in your TPFile filename, such that the filename should be *publickey*Username.tpfile, without the *.

After you have created an identity, you will need to modify your config file.

Return to the tutorial contents.