Sponsorship

From DOC

Sponsorship provides a means to control new registrations. It is a completely optional feature. If not active, users are free to register a new login without restriction. With Sponsorship enabled, the administrator of an account (the issuer) asks the system for a code which they can distribute as they see fit. Anyone with that code can then create a new Tolven login. The issuer does not need to know the user's login id. The new user is not a made a member of the issuer's account.

An example where this feature is useful is an employer that wants to make a personal health record available to employees but does not want to have any access to the employee's health data. Thus, the number is a "free pass" to use Tolven.

Tolven Invitations are different from Sponsorships: Invitations are direct communications between known Tolven accounts.

The only connection between the issuer and any users that use the code from that issuer is that the issuer can get a list of each user's email address, first and last name that used the code to create a Tolven login. The issuer has no access to the user's data in any way.

A new tolven.properties property has been added to support sponsorship. It's name and default value is:

tolven.register.referenceRequired=false

If true, users will be required to provide a "reference code" in order to create a new Tolven Login. (The code is not required to login).

Before setting this flag to true, bootstrapping is needed. Don't set this flag to true until you've logged in, created an account, and in the account administration page created at least one sponsorship reference code. Make a note of this code so you can hand it out to other people. Once you set:

tolven.register.referenceRequired=true

all subsequent registration requests will require a valid reference code. Once a user login is created, the reference code is no longer needed, it is not required to login. But other users may be able to use the same code.

Turning sponsorship off (tolven.register.referenceRequired=false) and on is allowed. When turned off, references already created will be retained while new references will not be needed or asked for.

Property	Default	Description
tolven.register.referenceRequired	false	For a user to create an account, they must provide a special number on the registration screen. For example, an employer or other kind of sponsor might only allow employees to create a tolven account (but the employer does not want to be privy to the account).