Web Service for .NET Developers
This section describes how to deploy CT-V using .Net Web Services.
Note
The user may use the obfuscated password or credential. See Creating Obfuscated Data Using Obfuscation Utility for more information.
The web service enables you to:
(CreateNewRegExTokenFormat, CreateNewTokenFormat and CreateNewTokenFormatWithTokenLength) - create new token formats. The latest addition, CreateNewRegExTokenFormat, uses Java regular expressions to simplify the process.
CreateMaskingFormat - create new masking format.
(InsertBatch, InsertBatchWithCustomData, InsertBatchWithCustomDataTokenPropertyBatch, InsertBatchWithMultipleVaultWithTokenProperty, InsertBatchWithMultipleVaultWithCustomTokenProperty, InsertBatchWithMultipleVaultWithTokenPropertyAndCustomTokenProperty, InsertBatchWithMultipleVaultWithoutTokenPropertyAndCustomTokenProperty, InsertToken, InsertIrreversibleToken, InsertTokenWithCustomData (InsertBatchWithCustomDataTokenProperty, InsertBatchWithCustomDataTokenPropertySmartCheck, InsertBatchWithCustomDataTokenPropertyBatchSmartCheck, InsertBatchWithTokenProperty, InsertBatchWithTokenPropertyBatch, InsertTokenWithCustomDataTokenProperty and InsertTokenWithTokenProperty) - create tokens.
GetBatch, GetBatchWithCustomData, GetTokenBatchWithCustomData, GetTokensByDateWithCustomData, GetTokensByRangeDateWithCustomData, GetTokenWithCustomData, GetValue, and GetValueWithCustomData) - get plaintext values.
Note
The plaintext for token generated using InsertIrreversibleToken() method will not be returned, instead it will return the string value Irreversible Token.
GetByTokenProperty - get the tokens for the corresponding tokenProperty.
GetCustomTokenProperty - get the customTokenProperty(s) for the corresponding tokens.
GetCustomTokenPropertyByValue - get the customTokenProperty(s) for the corresponding plaintext value(s) and the custom data.
GetDisabledTokens - get an array of disabled tokens.
(DeleteToken, DeleteTokenBatch, DeleteValue, DeleteValueWithCustomData, DeleteValueBatch, DeleteValueBatchWithCustomData and DeleteTokenByTokenProperty) - delete the tokens.
DisableTokenBatch - disable tokens from the vault.
(UpdateTokenProperty and UpdateTokenPropertyBatch) - update tokenProperty of the tokens.
Mask - create tokens without storing them in the token vault.
create "token service" users where the Key Manager and database credentials are encrypted and remain completely unknown to consumers of the WebService. The consumer receives, instead, a token service username and password to use for authentication with the CT-V WebService. Key Manager and database credentials do not need to be exposed.
continue a bulk tokenization or detokenization process even when row level errors (null values, invalid values) appear in the input. Your application can enable this “Smart Check” option by using new (overloaded) versions of the insert() or get() calls with a boolean value is set to true.
When running batch jobs in Oracle, it is recommended to execute the analyze table command after running the first batch job on a token vault. For example:
analyze table <your token vault table> compute statistics;
Note
If this command is not used, performance will degrade after running batches between 5000 and 10000 rows. This performance degradation will cause a Read Timeout Exception.
