Tokens

From ShockvoiceWiki

This document explains the Shockvoice Token System that has been introduced with Shockvoice 0.9.5, what it is and how it is used.

What are tokens?

A token in Shockvoice is a pair of files which make your server an authorized Shockvoice Server. They contain information about your license that will be used by the server to determine how many servers and slots you can create. This is how a token will look like:

 <?xml version="1.0" encoding="utf-8"?>
 <Token xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
   <CustomerID>12345</CustomerID>
   <CustomerName>Shockvoice GbR</CustomerName>
   <Slots>-1</Slots>
   <Instances>-1</Instances>
   <TokenData>3306e7821b30a3011b7cce9351abede1</TokenData>
 </Token>

The second file in that pair is a digital signature file that will make sure the token has not been tampered with. That means you should make sure the files do not get changed at all. This can happen easily when transferring an xml file over http for example and will make your token invalid.

How do I use them?

After you installed your version of the Shockvoice Server, you simply put the two files in the server directory and start your server. In your server log file you will see if the token has been correctly recognized and your server is authorized. It should look something like this:

 17.08.2010 13:42:59 - VALID TOKEN FOUND FOR: Shockvoice GbR
 17.08.2010 13:42:59 - VALID FOR UNLIMITED INSTANCES
 17.08.2010 13:42:59 - VALID FOR UNLIMITED SLOTS

You can still run older versions of Shockvoice prior to 0.9.5 without token files of course, also you can run as many servers as you wish with the same token files.

You should make absolutely sure that these token files are not handed out to anybody except you, because they're your identity when it comes to payment. Any server that is run with your token file will automatically be added to your account in our database.

What will be sent over Internet?

In your token file, you will find a 32 digit hash string beween <TokenData> tags. This will be sent when your server registers. No other information like your company name or customer number will be transmitted. The information will stay absolutely anonymous.