InsertIrreversibleToken()
InsertIrreversibleToken() encrypts an array of plaintext values, creates irreversible tokens, insert them into the token vault, and return the tokens. This API supports Unicode (multibyte format) tokens. Also, the tokens generated using InsertIrreversibleToken() method will not return the plaintext when passed in the get() method. The method will instead return the string value “Irreversible Token”.
Note
If the plaintext value (along with the custom data) passed in has already been tokenized using insert() method, this method simply returns the existing token. Such tokens are not irreversible tokens.
Syntax
public TmResult InsertIrreversibleToken (String naeUser, String naePassword, String dbUser, String dbPswd, String tableName, String[] values, String[] customData, Integer format, Boolean luhnCheck, Boolean saveExceptions, String[] tokenProperty, String[] customTokenProperty)
Request Parameters
| Parameters | Data Types | Descriptions |
|---|---|---|
| naeUser | string | A Key Manager user with access to the AES and HMAC keys. |
| naePassword | string | The Key Manager user’s password. |
| dbUser | string | A database user with access to the token table. |
| dbPswd | string | The database user’s password. |
| tableName | string | This is the Token Vault name and it must be in CAPITAL LETTERS. |
| values | string[] | Data to be tokenized. |
| customData | string | The customer-specific data associated with each plaintext value. |
| format | integer | One of the predefined token formats or a format created using CreateNewTokenFormat(). You can use the constant if your application imports com.safenet.token.TokenService. Otherwise, use the correct integer. For more information about the available formats, see [Using Token Formats]. |
| luhnCheck | boolean | boolean indicates if the value must pass a Luhn check (true) or if there is no requirement (false). Token formats created using the createNewFormat() method may have one of three luhnCheck rules. The rules are must fail test, no requirement, and must pass test. |
| saveExceptions | boolean | When set to true, the Smart Check functionality is turned on, and arrays containing tokenization data are returned. |
| tokenProperty | string[] | The tokenProperty[] associated with the tokens to be created. |
| customTokenProperty | string[] | The customTokenProperty[] associated with the tokens to be created. |
The priority of the luhnCheck boolean in insert() and the luhnCheck integer in createNewFormat() vary depending on their values, as shown in the following figure:
Returned Values
The output tokens, status and error details, if any.
