# Nomenclature¶

We have some terminology that may be entirely intuitive and some specific to the product. We have some common terms defined below.

## Structure¶

### Organization¶

Shared accounts where users can collaborate across many vaults at once.

### Vault¶

A partition for storing data within a VGS organization. An organization can have many vaults.
Every vault has unique vault id - it’s a string value beginning with the prefix tnt, for example tntgwauwbm1.

### User¶

An individual account that can be added to an organization, to work on a certain vault, and forthcoming, have different defined roles.

## Product Terms¶

### Client¶

An entity that makes a request through the VGS platform.

### Credentials¶

Outbound routes and all sftp proxies are authenticated. Credentials are required to access these zones.

### Route¶

An endpoint exposed to a customer that allows sending data from one point to another. A Route has a source and a destination that determines the flow of traffic through the vault. Filters are then attached to the Route to determine what data is transformed and segmented as it passes through the Route.

• Inbound route - sits in front of an upstream host and redacts, reveals, and enriches data as it passes through.
• Outbound route - sits in the stream of traffic from a host or network and redacts, reveals, and enriches data as it passes through.

### Filter¶

A set of conditions that define when data should be operated on as it passes through a Route. When the conditions are evaluated to true, then a set of operations (pipeline) are executed according to the phase.

### Record¶

An entry in the vault. A record has raw value, fingerprint and identifier. Identifiers present on redacted data and used to find the raw value on data revealing. Identifier can have multiple formats, currently supported record identifier formats are UUID, PDF, and FP (format preserving).

Records currently come in two varieties:

1. Aliases - text based records
2. Documents - binary based records, for example PDFs

### Redact¶

To remove sensitive information from the payload and replace them with a different value.

### Reveal¶

To restore sensitive data pieces on previously redacted payload.

### Operation¶

A transformation or action on information. When a filter is matched it will apply a series of operations on the matched data.

* OPERATIONs before the REDACT or REVEAL of the data
* OPERATIONs after the REDACT or REVEAL of the data


### Storage¶

The storage value controls how aliases are stored. A persistent mode allows storing data on a permanent basis. Volatile storage has an expiration of 1 hr.

### Pipeline¶

A set of operations. The output of each operation in the pipeline is the input for the subsequent operation.

### Phase¶

Each message passed through a route has a phase.

1. Request
2. Response

### Upstream Host¶

The host that sits of the remote side of the route from the client who is initiating the request.

### Upstream URI¶

Upstream host + path.

### Target¶

The part of the payload passing through the proxy that will be operated on when a policy is matched (can be HEADER or BODY).

### Alias Formats¶

Formats comes in several varieties to choose from based on your use case.

1. Generic - VGS Alias: Can be used for any piece of data, alphanumeric data is fine. Format returns a surrogate value like tok_sandbox_xxxxxxxxxxxxxxxxxxxxxxxxx where the x’s are alphanumeric characters.
2. Generic - Numeric Length Preserving: Can be used for any number that needs to have it’s length maintained for form validation or other reasons where the length returned matters. This does not support numbers less than 3. If the number is less than 3, then a generic VGS alias will be generated.
3. Payment Card - Format Preserving, Luhn Valid (6T4): To be used for Payment cards when you need them to still go through a validation check and capture the BIN (Bank Identification Number) and the last four digits. Example 4111111111111111 becomes something like 4111119381251111. If the payment card is an invalid Luhn or incomplete length, then a generic VGS alias will be generated.
4. Payment Card - Format Preserving, Luhn Valid (T4): To be used for Payment cards where you do not need a BIN but it is still Luhn Valid to pass validation checks on your system. 5555555555554444 would become something like 9399630812244444. If the payment card is an invalid Luhn or incomplete length, then a generic VGS alias will be generated.
5. Payment Card - Prefixed, Luhn Valid, 19 Digits Fixed Length: This format makes it easy to distinguish between real sensitive data and the surrogate values. For example 4012888888881881 turns into 9914040119524511881 The prefix here is 99 with 1 reserved for versioning of this format. The 4th and 5th digits represent the first two digits of the original PAN and the last four digits represent the last four from the original PAN. If the payment card is an invalid Luhn or incomplete length, then a generic VGS alias will be generated.
6. SSN - Format Preserving (A4): Can be used for social security number (SSN). Possible to use ssn with dashes or without. For example 567-34-5672 would have alias like 123-945-5672, last four digits are the same.
7. Account Number - Numeric Length Preserving (A4): Could be used for numeric account number. The length of the value could be in range from 7 to 17. It keep last four digits untouched.
8. Account Number - Alphanumeric Length Preserving (A4): Could be used for alphanumeric account number. The length of the value could be in range from 7 to 17. It keep last four characters untouched.
9. Generic - VGS Alias Last Four (T4): Can be used for any type of data. This will generate an alias with the last four characters of the original value after the alias - tok_sandbox_xxxxxxxxxxxxxxxxxxxxxxxxx_<last_four>, where the x’s are alphanumeric characters. The length of the value could be greater or equal to 7, otherwise it will fallback to Generic - VGS Alias i.e. if you use it with Account numbers - 34124545 would become tok_sandbox_2fVQ84qP1y7GqjKb9GMwed_4545. Any other value - some_arbitrary_value would become tok_sandbox_2fVQ84qP1y7GqjKb9GMwed_alue.