# Alphanumeric String Key

Generates unique alphanumeric strings of the same length as the input.

For example, for the origin value `ABC123`, the output value is a six-character alphanumeric string such as `D24N05`.

You can configure the generator to:

* Preserve a value prefix. For example, if the origin value always starts with `acct_`, you might want to preserve that in the output value, and only mask the unique part of the identifier.
* Only replace numerical characters, and keep other types of characters as is.

## Characteristics <a href="#alphanumeric-string-key-characteristics" id="alphanumeric-string-key-characteristics"></a>

<table data-header-hidden><thead><tr><th valign="top"></th><th valign="top"></th></tr></thead><tbody><tr><td valign="top"><strong>Consistency</strong></td><td valign="top">Yes, can be made self-consistent.</td></tr><tr><td valign="top"><strong>Linking</strong></td><td valign="top">No, cannot be linked.</td></tr><tr><td valign="top"><strong>Differential privacy</strong></td><td valign="top">No</td></tr><tr><td valign="top"><strong>Data-free</strong></td><td valign="top">No</td></tr><tr><td valign="top"><strong>Allowed for primary keys</strong></td><td valign="top">Yes</td></tr><tr><td valign="top"><strong>Allowed for unique columns</strong></td><td valign="top">Yes</td></tr><tr><td valign="top"><strong>Uses format-preserving encryption (FPE)</strong></td><td valign="top">Yes</td></tr><tr><td valign="top"><strong>Privacy ranking</strong></td><td valign="top"><ul><li>3 if not consistent</li><li>4 if consistent</li></ul></td></tr><tr><td valign="top"><strong>Generator ID (for the API)</strong></td><td valign="top"><a href="../../../api/quick-start-guide/tonic-api-generator-assignment/generator-api-reference/generator-api-ref-alphanumeric-string-key"><code>AlphaNumericPkGenerator</code></a></td></tr></tbody></table>

## How to configure <a href="#alphanumeric-string-key-configure" id="alphanumeric-string-key-configure"></a>

To configure the generator:

1. To preserve a prefix value, in the **Preserve prefix** field, type the prefix string to preserve in the output values.\
   \
   For example, if you set **Preserve prefix** to `acct_`, then any source values that start with `acct_` will also start with `acct_` in the destination data.
2. To only replace the numerical characters, toggle **Mask digits only** to the on position.
3. Toggle the **Consistency** setting to indicate whether to make the generator self-consistent.\
   \
   By default, the generator is not consistent.
4. If [Structural data encryption](https://docs.tonic.ai/app/generation/generators-assign-config/generators-data-encryption-config) is enabled, then to use it for this column, in the advanced options section, toggle **Use data encryption process** to the on position.
