Notation

Overview

Mushpup notation is inspired by standard security protocol notation but seeks to simplify it for ordinary users. The basic syntax:

m{site/user > msw}side

where:

• m{} signifies use of the Mushpup algorthim on the variables inside the brackets -- this is constant
• site/user is the value of site-user combo entered in the form
• msw stands for Mushpup secret word -- this is constant (i.e., for security, this should not be replaced with the actual word but always read msw or be left out all together)*
• side indicates the side of the hash from which the password will be copied and its length. l8, for instance, would stand for left 8 characters

* Note: if you had more than one Mushpup Secret Word, you could signify that here by indication, for example, msw1 or msw2.

An Example

m{mushpup.org/klenwell > msw}r8

What this means:

• the first 'm' simply signifies the info within the brackets will be encrypted (hashed) using the ordinary (v.1) mushpup algorithm.
• within the brackets there are two variables separated by the >: mushpup.org/klenwell and msw
• mushpup.org/klenwell (left of the >): this is the site value -- this doesn't need to be secret
• msw (right of the >): this signifies you mushpup secret word. Again, this is redundant.
• r8: indicates that you are going to be using the 8 characters at the right end of the produced mushpup hash -- l means from left, r means from right, and m means middle (as in m8, middle 8 characters of hash)

A Version 2 Example

m{mushpup.org/klenwell/*}r8

The basic notation is the same with version 2. The * is added to indicate the modifier for including alpha, numeric, and special characters is used.

Recommended Notation

Since you are probably going to know the user name you are using to sign in any way, you don't really need to include that. And if you are consistent in using the domain-dot-tld format in your site string, you don't really need to use that either. Similarly with the side value. So for most cases, you can just use the following format:

m{mushpup.org/klenwell}

Or more simply, I could put this on my site's profile page:

m{}

If it required the modifier for alpha, numeric, and special characters:

m{*}