InsertToken()
InsertToken() encrypts a plaintext value, create a token, insert it into the token vault, and return the token. if the plaintext value passed in has already been tokenized, this method simply returns the token value.
Syntax
public String InsertToken (String naeUser, String naePassword, String dbUser, String dbPswd, String tableName, String value, Integer format, Boolean luhnCheck)
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. |
value | string | Data to be tokenized. |
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. |
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
A string of the token.