Skeptic Authority Template

A basic template for a Skeptic authority.

Overview

A Skeptic authority is an application, written in Coq and utilising Coq.io, that accepts or rejects passwords based on password composition policies refined from configuration parameters specified with respect to some piece of password composition policy enforecment software. Because we do this from within Coq, we are granted the freedom to write theorems to verify that our transformation of software-specific configuration parameters to a low-level predicate-based representation of password composition policies is correct.

The low-level model of password composition policies used in this library is based on the 2013 work by Blocki et al. [1] extended with meta-rules, which are just predicates that allow us to create rules from attacks using set abstraction.

Prerequisites

To build and use this project, the following software is required:

Python v3.6.8 [^]
Coq v8.8.1 [^]
Coq.io v3.1.0 [^]

Other versions of the above might work, but haven't been tested. Definitely will not work with Python 2. Other utilities including ocamlfind, ocamlbuild etc. are required too, but should be installable via opam without too much of an issue if not already present.

Setup

Every piece of password composition policy enforecment software is different. For this reason, it's necessary to specify the type of their configuration options before we get started writing any proofs etc. An interactive script named init.py is provided to get you started with this. What follows is an example of how we would go about setting this project up for a piece of hypothetical password composition policy enforcement software that takes password length, required number of digits and a blacklist as input.

Firstly, run init.py like so:

python3 init.py

We'll then be asked to specify a root namespace for our project. In this case, let's just call it HypotheticalAuthority:

Copied ./src/Makefile.dist to ./src/Makefile
What root namespace would you like your code to reside under? HypotheticalAuthority
Root namespace populated in ./src/Makefile

Your Coq project is now set up (this will be important later).

You'll then be asked about the configuration parameters your piece of password composition policy enforement software takes. In this case, we specify that it takes a length (as a natural number), a number of digits (as a natural number) and a blacklist (as a list of strings).

Would you like to build your policy configuration parameters interactively now? [y/N] y
Please name your parameter: length
For parameter length please specify a type: nat
Add another parameter? [y/N] y
Please name your parameter: digits
For parameter digits please specify a type: nat
Add another parameter? [y/N] y
Please name your parameter: blacklist
For parameter blacklist please specify a type: list string
Add another parameter? [y/N] n

You've now made the script aware of the configuration parameters taken by the piece of software you're modelling, as well as their types. Next, we'll be able to pre-configure some policies. Let's informally specify what they do now:

basic8: Passwords must have minimum length 8, no other constraints.
basic16: Passwords must have minimum length 16, no other constraints.
digit8: Passwords must have minimum length 8 and at least 1 digit.
dict8: Passwords must have minimum length 8 and cannot be password or hunter2.

Now let's get to specifying these:

Would you like to preconfigure some policies interactively now? [y/N] y
Please name your policy: basic8
For parameter length please specify a value in type nat: 8
For parameter digits please specify a value in type nat: 0
For parameter blacklist please specify a value in type list string: []
Add another policy? [y/N] y
Please name your policy: basic16
For parameter length please specify a value in type nat: 16
For parameter digits please specify a value in type nat: 0
For parameter blacklist please specify a value in type list string: []
Add another policy? [y/N] y
Please name your policy: digit8
For parameter length please specify a value in type nat: 8
For parameter digits please specify a value in type nat: 1
For parameter blacklist please specify a value in type list string: []
Add another policy? [y/N] y
Please name your policy: dict8
For parameter length please specify a value in type nat: 8
For parameter digits please specify a value in type nat: 0
For parameter blacklist please specify a value in type list string: ["password"; "hunter2"]
Add another policy? [y/N] n

Now we're done, we can go ahead and delete the template files and init.py script, which are just used for code generation and can be removed.

All done, delete template files and this script now? [y/N] y

Now, take a look in /src/Authority.py. You'll notice that a type has been generated for us which captures our configuration parameters. Notice the two natural numbers in nat for length and digits and a list of strings in list string for the blacklist:

(** Definition of the data type for the password composition policy enforcement
    software configuration parameters.
  *)
Definition Configuration : Type :=
  (nat * nat * list string).

Also notice that a lookup has been generated for finding configuration parameters based on policy name:

(** Looks up a configuration parameters tuple by name.
    - [name] is the name of the tuple to look up
  *)
Definition lookup_config (name : string) : option Configuration :=
  match name with
  | "basic8" => Some (8, 0, [])
  | "basic16" => Some (16, 0, [])
  | "digit8" => Some (8, 1, [])
  | "dict8" => Some (8, 0, ["password"; "hunter2"])
  | _ => None
  end.

Note, however, that the all-important transform function which turns values in Configuration into lists of meta-rules in list MetaRule just returns an empty list, though the pattern matching on the tuple has been added in for you based on the names you specified earlier. It's now up to you to specify and verify the semantics for transformation of your Configuration type into a list of predicates.

(** Transforms a tuple containing software-specific configuration parameters
    to a list of meta-rules.
    - [config] is the tuple to transform
  *)
Definition transform (config : Configuration) : list MetaRule :=
  match config with
  | (len, digits, dict) => []
  end.

For now, let's just add in a predicate that checks string length as below. Adding in functionality such that digits and dict are no longer ignored is left out for the purposes of this demonstration, though dictionary checks can take advantage of the bundled Io.v library which uses our generic implementation of tries for efficient lookups.

(** Transforms a tuple containing software-specific configuration parameters
    to a list of meta-rules.
    - [config] is the tuple to transform
  *)
Definition transform (config : Configuration) : list MetaRule :=
  match config with
  | (len, digits, dict) => [(fun x => Nat.leb len (length x))]
  end.

Building

After completing setup above, it's now possible to build the authority application itself.

cd ./src
make authority

An application called authority.native is extracted and built from the Coq code. Running this like so, we'll be prompted for input:

./authority.native basic8 10

Try typing in a few passwords. Notice that the application accepts or rejects them based on the policy specified:

password
true
123456
false
foo
false
bar
false
longpass
true

A total of 10 passwords will be read before the application exits, like we specified when we invoked it.

Utility

Compiled Skeptic authorities can be used with Pyrrho to filter and renormalise password probability distributions computed from large datasets. For instructions on doing this, consult that repository.

Acknowledgements

The font used in the logo is Monofur by Tobias Benjamin Köhler.

References

Jeremiah Blocki, Saranga Komanduri, Ariel Procaccia, and Or Sheffet. 2013. Optimizing password composition policies. In Proceedings of the fourteenth ACM conference on Electronic commerce (EC '13). ACM, New York, NY, USA, 105-122. DOI: https://doi.org/10.1145/2492002.2482552 [PDF]

sr-lab / skeptic-authority-template