Stork Tutorial: Identities, Config Files
Creating an Identity
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 *.
Configuration File
You will need to change the stork configuration file included in the
Storkutil tarball to match the
identity you created. Simply open up the file which should be named
sample-stork.conf and change the 'username = ' line
to match the username you chose for your keys. You will also need to modify the
'publickeyfile = ' line, to match the location of your publickey. By default, this should be
"publickeyfile = /usr/local/stork/var/keys/<username>.publickey", where <username> is the
name you generated your keys for.
You will need to distribute this
configuration file to all your
nodes through the upload website.
Note! The stork configuration file is different from the storkutil
configuration file. The setdefault command will appropriately change
the storkutil configuration file, but you will still need to change and distribute
the Stork configuration file manually.
After you have created an identity, you can
create your tarball package. If you already have a package ready,
you can move on to modifying your trusted packages file in
order to let Stork know which packages you trust to be installed. You can also
upload your publickey and your configuration file to the
repository.
Return to the tutorial contents.
Home Top
|
