Building Blocks

This document is part of the Building Blocks of Consento. Building blocks are encapsulated systems that we need for Consento but that can also function on their own and help the entire ecosystem.

Private Information Lookup and Filter

[State: in-planning]

TLDR; Consento is used to exchange data. When we exchange data we want to use the BIT standard to be able to declare the privacy information for each field that is submitted and also want to be able to prevent some partners to receive a particular kind of private information.


Consento allows to exchange data between individuals and/or companies. In this process there may be some data that is exchanged only after approval and other that is usually not exchanged.

Blinding Identity Taxonomy#

Instead of trying to come up with our own standard for fields, we have been looking into preexisting defintions and stumbled upon the "Blinding Identity Taxonomy", published by the Kantara Initiative.

It specifies 49 different categories of data that may be excluded from data transfer or not.

Functional goal#

The system should consist of a set of primitives and crypto tools that allow to specify, highlight, encrypt or remove private fields of a given data sets.

  1. "Schema definition" For a data structure, defined by the user or a developer, we need to be able to specify which fields should be considered blinding taxonomy and which should not.

    let { BitSchema, Type } = require('@consento/bit')
    let schema = new BitSchema({
    name: Type.NAME
    let dataSet = { name: 'henry', sessionTime: 12 }
    schema.matches(dataSet) // figure out if there are fields in this data that are sensitive.
  2. "Partial cryptography" A tool to encrypt and decrypt the fields of the schema definition with keys derived for each type. This allows to send data to other parties and only later giving permission to access particular fields.

    let { encrypt, decrypt } = require('@consento/bit')
    let { key, partiallyEncrypted } = encrypt(dataSet, schema)
    decrypt(partiallyEncrypted, key)
  3. "Contract definition" Since different users may want to share different properties with different other users we need a means to specify which fields are supposed to be readable by the receiving party and which fields should be hidden or removed.

    let { Contract } = require('@consento/bit')
    let contract = new Contract({
    [Type.Name]: Contract.PLAIN_TEXT,
    [Type.PhysicalAddress]: Contract.ENCRYPT
    encrypt(dataSet, schema, contract)
  4. "Schema derivation" When passing a given data set through he encryption process, it will transform some of the properties from "plaintext" to "possibly encrypted". It is stressful to update any given data structure definition to contain all those new variants. What we need is an automation tool that allows us to derive new data-schemas from existing data-schemas (preferably JSONSchema) combined with the bit-schema.

    let { JSONSchema } = require('@consento/bit')
    await JSONSchema.derive('https://schema.url', schema)
  5. "Common Schema Library" As many people may already want to use common data sets (such as google or facebook export data) we need a repository that already holds definitions for common data types.

    let knownSchemas = require('@consento/bit-schemas/google')

Possible Beneficiaries#

This system can both be used for communication and as a internal tool to enforce data-privacy guidelines. Examples could be Survey providers that want to drop private fields after the survey results are compiled.