Commandes CLI invitation

Définitions

Claimer

l’invité qui accepte l’invitation

Greeter

l’hôte qui invite le Claimer dans l’organization. Il peut s’agir du créateur de l’invitation.

Principes généraux

L’invitation se compose de trois étapes

  1. L’invitation est créée (la commande utilisée dépend du type d’invitation)

  2. Le Claimer utilise le lien d’invitation pour revendiquer l’invitation (avec la commande invite claim)

  3. Le Greeter valide la revendication du Claimer’s avec le token d’invitation (avec la commande invite greet)

Les étapes 2 et 3 doivent avoir lieu simultanément car des points de synchronisation entre le Claimer et le Greeter ont lieu. Avant d’être fini un point de synchronisation sera signifié par un point qui tourne qui deviendra un ✔.

L’étape de création va fournir

  • un line d’invitation qui sera utilisé par le Claimer

  • un token d’invitation qui sera utilisé par le Greeter.

L’invitation peut ête envoyé par email selon la configuration du server. Mais le créateur de l’invitation peut la transmettre directement au Claimer par une voie de communication sécurisée de son choix.

Le token d’invitation peut aussi être récupéré en listant toutes les invitations

Invitation utilisateur

Création

La commande suivant créée l’invitation pour <user@example.com>.

parsec-cli invite user 'user@example.com' --device 627
Enter password for the device:
Invitation token: d57c6a64b5bd6eca760c3c41de3b0f61
Invitation URL: http://127.0.0.1:6770/redirect/Org?a=claim_user&p=xBDVfGpktb1uynYMPEHeOw9h

Claim

Ce nouvel utilisateur peut revendiquer l’invitation.

parsec-cli invite claim 'http://127.0.0.1:6770/redirect/Org?a=claim_user&p=xBDVfGpktb1uynYMPEHeOw9h'
✔ Retrieving invitation info
Invitation greeter: Alice <alice@example.com>
✔ Waiting the greeter to start the invitation procedure
Select code provided by greeter: TP9W
Code to provide to greeter: U4SQ
✔ Waiting for greeter
Enter device label:
new_device
Enter email:
user@example.com
Enter name:
User
✔ Waiting for greeter
Enter password for the new device:
Confirm password:
New device created:
19f - Org: User <user@example.com> @ new_device

Greet

Le Greeter peut accueillir le nouvel utilisateur. L’appareil ici est n’importe quel appareil qui appartient au Greeter.

parsec-cli invite greet d57c6a64b5bd6eca760c3c41de3b0f61 -d 627
Enter password for the device:
✔ Poll server for new certificates
✔ Retrieving invitation info
✔ Waiting for claimer
Code to provide to claimer: TP9W
✔ Waiting for claimer
Select code provided by claimer: U4SQ
✔ Waiting for claimer information
New device label: [new_device]
New user: [User <user@example.com>]
Which profile?: STANDARD
✔ Creating the user in the server

Invitation d’appareil

Création

Un utilisateur peut avoir un nombre arbitraire d’appareil. L’appareil ici doit exister au préalable.

parsec-cli invite device -d 19f
Enter password for the device:
Invitation token: 67d55ad91481d806628782c0ebe6307a
Invitation URL: parsec3://127.0.0.1:6770/Org?no_ssl=true&a=claim_device&p=xBBn1VrZFIHYBmKHgsDr5jB6

Claim

L’utilisateur peut revendiquer un nouvel appareil.

parsec-cli invite claim 'parsec3://127.0.0.1:6770/Org?no_ssl=true&a=claim_device&p=xBBn1VrZFIHYBmKHgsDr5jB6'
✔ Retrieving invitation info
Invitation greeter: User <user@example.com>
✔ Waiting the greeter to start the invitation procedure
Select code provided by greeter: SZCA
Code to provide to greeter: 9W6U
✔ Waiting for greeter
Enter device label:
new_new_device
✔ Waiting for greeter
Enter password for the new device:
Confirm password:
New device created:
78b - Org: User <user@example.com> @ new_new_device

Greet

L’utilisateur doit avoir en même temps accès à son appareil existant et exécuter cette commande en revendiquant sont nouvel appareil.

parsec-cli invite greet -d 19f 67d55ad91481d806628782c0ebe6307a`
Enter password for the device:
✔ Poll server for new certificates
✔ Retrieving invitation info
✔ Waiting for claimer
Code to provide to claimer: SZCA
✔ Waiting for claimer
Select code provided by claimer: 9W6U
✔ Waiting for claimer information
New device label: [new_new_device]
✔ Creating the device in the server

Lister les invitations en cours

Cette commande liste les invitations qui ont été créée mais pas encore complétées.

parsec-cli invite list -d 627
Enter password for the device:
✔ Poll server for new certificates
1 invitations found.
d57c6a64b5bd6eca760c3c41de3b0f61    pending user (email=user@example.com)