apps.authenticator
Class FlowBuilder

java.lang.Object
  |
  +--bees.core.Application
        |
        +--apps.authenticator.FlowBuilder

public final class FlowBuilder

extends Application

The FlowBuilder application is used to construct protocol flow descriptions. A description is made up of the protocol tree, consisting of the primary protocol and its companions. After the tree, there can be any number of "pairs", which contain a string identifier and an opaque byte array. Pairs can then be strung together into a "pair chain", which can be flattened and made into the value part of another pair. The arguments accepted by the application are as follows:

• <Primary protocol name> - The name of the primary protocol. This protocol is basically the top of the tree, therefore, the flow will be made up of it and all of its companions.
• [-companion <protocol name>] - Add a companion protocol.
• [-start-chain <pair chain name>] - Start a new pair chain.
• [-end-chain <pair chain name>] - End a pair chain.
• [-push-chain <pair chain name>] - Push an existing chain.
• [-pop-chain <pair chain name>] - Pop a pushed chain.
• [-start-sign <private key>;<algorithm>] - Start a signature.
• [-sign <name>] - Finish and add a signature.
• [-update-sig <name>] - Update a signature with a pair.
• [-pair <name>=<value>] - Add a generic pair.
• [-start-permissions <name>] - Start a PermissionSet.
• [-end-permissions <name>] - End a PermissionSet.
• [-permission <name>=<value>] - Add a permission.

The capability arguments are:

• file - The file to write the description to.
• [<private keys>] - Any private keys needed to sign the description.

An example usage would be:

 bees.core.FlowBuilder
   apps.health.HealthProtocol
   -companion bees.core.UnknownProtocol
   -start-chain source-auth
     -pair source=bob
     -pair algorithm=DSA
     -start-chain capability.files/foo
       -pair destination=user/foo
       -start-permissions revoke
         -permission file=write
       -end-permissions
     -end-chain capability.foo
   -end-chain source-auth
   -start-sign privateKey;DSA
   -update-sig primary-protocol
   -update-sig companion-protocol
   -update-sig source-auth
   -sign source-auth-signature
 

The first argument .

Constructor Summary

FlowBuilder()
Construct a FlowBuilder object.

Method Summary

void	start(Node node, java.lang.String[] args) Method called to set the application in motion.
java.lang.String	toString()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

FlowBuilder

public FlowBuilder()

Construct a FlowBuilder object.

Method Detail

start

public void start(Node node,
                  java.lang.String[] args)

Description copied from class: Application

Method called to set the application in motion.

Overrides:

start in class Application

See Also:

Application.start(Node, String[])

toString

public java.lang.String toString()

Overrides:

toString in class Application

See Also:

Object.toString()