Creating a user¶
This is the first and essential step in order to use the ZiSh client. Any actions executed in a "non connected" mode will generate an error.
For instance:
ZiSH:# client oasis You're not in connected state.
You must begin by create an user.
ZiSH:# help user
user <username> <publicname> - Create/Use a user access key
ZiSH:# user ludovic Ludovic Cartier
Creating new user ludovic
Generating key pair
Passphrase: ********
Passphrase (again): ********
Saving private key
Generating CSR
Saving certificate
Enter PEM pass phrase: ********
Ready to use
During the creation process, informations will be requested :
- the username
- the public name
In this example : ludovic is the username, and "Ludovic Cartier" is the public name.
The authentification method with the platform is based on a private key, which is assigned to every user, and signed by the platform's certification authority (CA).
This key's generation requires a "passphrase". After the signature of the key by the CA, your passphrase will be asked again to log yourself.
The ZiSH client will write on your local hard drive both SSL certificate and private key :
~/: cat .zinn/users/certs/ludovic -----BEGIN CERTIFICATE----- MIICdDCCAVygAwIBAgIBEjANBgkqhkiG9w0BAQUFADCBkDELMAkGA1UEBhMCRlIx DTALBgNVBAgTBFBBQ0ExEjAQBgNVBAcTCU1hcnNlaWxsZTENMAsGA1UEChMESWVs bzETMBEGA1UECxMKU2lublVzZXJDQTEZMBcGA1UEAxMQemQuc2lubi5pZWxvLm5l dDEfMB0GCSqGSIb3DQEJARYQY2FAc2lubi5pZWxvLm5ldDAiGA8yMDA5MDMxNjEw NTUwMloYDzIwMTAwMzE2MTA1NTAyWjASMRAwDgYDVQQDEwdMdWRvdmljMFwwDQYJ KoZIhvcNAQEBBQADSwAwSAJBAOk1D1xRFyKOj2E5lOP5jvIzJdzAPamByKKUgXtW ggbtsBa3f0ndvlTMNaa6SvtkowZ6dVEGPRcJkX3Czdfsj5ECAwEAAaMaMBgwCQYD VR0TBAIwADALBgNVHQ8EBAMCBeAwDQYJKoZIhvcNAQEFBQADggEBAH4fy0tZ9db7 Vp/zqu+DPcf0uvBXR9+Cho2zCpTdxA+J+BB9qhBy5ylUl7To6l73dbevnRRqgbZj sGAeypSmGAknNnO/VmKBp7ml6jRQGg4Z88eWcUgZYfI+9MoD1LoQr2A5a24VK6lt 2mBzIbKLz2XMScNZnC/eevDp2JPekDquI6u4fx4FKhQ9Y4u5KU0lixkIH3Z+2ZX9 bDuyIz2zzmWV4UUwT1Kg82bQcfCkYDRDRetRdDC6R7vW80XNh1S+li4LXNQQ/8zy gTo/WqsNu4HlTnE+as1HT/dwVsTZ2IJyJ3Z9ea8iPJbTInwNGgjRD5p1wwNLcI0P sBw4zdFolFs= -----END CERTIFICATE-----
~/: cat .zinn/users/keys/ludovic -----BEGIN RSA PRIVATE KEY----- Proc-Type: 4,ENCRYPTED DEK-Info: BF-CBC,EC67873D75228457 QCrJby/kn5oUCgbzPFqZUE7Z010kCgZxnA6C2BNwP5CzYy3j6h9zYevHZHqvaCMa JBUqD+mVXkr68G1ReM7hilPGPFFgwTo1Pu0lDw68EENq6LkO9dSYTGXXQDGYnSxH N6RCgUk3893zgOfnVpk2DDL5M7wLLh41fsI9z+KtlLidpcKIaXss4REfM80Kl9ch 6re/mz7WOuQkIdWk8GuWaSq9oAoYB0Av983ucyoZIOldMJABcpqLjbXxD4EjiSpa Z1V3/efReQSZfQwlJ3TcT6l84oIs5cKSh8DuvmI8TjZsKKETzbfJfv8CElWp/Odg jcPta4R4gcUKPwisx3wBYMCMCxV/lPnyvlBVTtk0ifKbJwRl27woDVkNvBBszKga DXiGIgdt1/Jze5nWRzWwHsjcP+jdWojceP2dE/kcdAU= -----END RSA PRIVATE KEY-----
Now, the user is created, the ZiSH client connect the user automatically and you can access to the entire platform's fonctionnalities.
Logging a user¶
To log in, nothing easier, just select the local username in the prompt through the "user" command :
~/: ./zish zish 0.9beta Copyright 2009 IELO Lost-Oasis This is free software with ABSOLUTELY NO WARRANTY. For help type `help'. ZiSH:# user ludovic Enter PEM pass phrase: ******** Ready to use ludovic@ZiSH:#
Your passphrase will be asked to confirm your identity and the association with your key.
Nota: In the connected mode, meaning when you have log yourself in, your username is indicated in the ZiSH prompt.