tokenize()
Generates tokens or return existing tokens.
This function should handle sequential and non-sequential tokens. It should detect collisions on token values and return null in the output token field if a collision is detected.
This function should also detect a collision on hash value, and set the output token value to that found in the database for the hash value, which will ensure that the same input value (via hash) maps to the same token.
Syntax
public void tokenize (Connection conn, String tableName, Integer tokenType, String [] metaData, byte [][] cipherText, byte [][] mac, String [] tokens)
Request Parameters
| Parameter | Type | Description |
|---|---|---|
| conn | String | The database connection. |
| tableName | String | Name of the token vault table. |
| tokenType | int | Type of token (sequential or other). This value is set to 2 for sequential tokens. Any other value indicates non-sequential value. No special determination must be made depending on the value of this parameter, if it is set to any value other than 2. |
| metaData | String array | Custom data associated with tokens. |
| cipherText | Array | Encrypted clear text values associated with tokens. |
| mac | Array | Hash values associated with tokens. |
| tokens | String | • On input: candidate tokens. • On output, as follows: • Tokens from the token vaults, if the values with the same hash are found. • Input candidate tokens, if the new tokens have been created. • Null values, if a collision of token values has been detected. |
