Agent Interface¶
This package has no agent interface.
Mask Credit Card¶
This feature is a complete subsystem that allows the following:
- Automatically show a warning message next to a credit card number (not storable).
- Mask credit card numbers for new tickets and articles.
- Mask credit card numbers contained in articles already stored in the system.
The credit card detection mechanism requires credit card numbers of 13, 15 or 16 digits. These credit card numbers should be at least potentially valid numerically, which means they pass the Luhn algorithm test.
For the current version only a subgroup of all potentially valid credit card number are detected. This is the list of the credit cards numbers that are considered valid:
- Visa 16 digits starting with a 4.
- Visa 13 digits starting with a 4.
- MasterCard 16 digits starting with 51 to 55.
- Discover 16 digits starting with 6011, 6121-29 to 6229-25, 644 to 649 or 65.
- JCB 16 digits starting with 3088, 3096, 3112, 3158, 3337 or 3528 to 3589.
- JCB 15 digits starting with 1800, 2100 or 2131.
- American Express 15 digits starting with 34 or 37.
For successful detection, the digits of these credit card numbers are allowed without separation or with a single separator in groups of digits as 4-4-4-4, 4-4-4-3, 4-4-4-1 or 4-6-5 (the last combination for American Express only). Allowed separators are -
, +
, /
, .
or a combination thereof.
Valid credit card numbers that are a subset of a bigger number are not considerate as credit card numbers. This is to avoid false positives, e.g. a serial number that contains a (not intentionally) valid credit card number. Valid credit card numbers should be enclosed by at least one non-numeric character.
Active Credit Card Masking¶
When this feature is enabled, every article will be scanned for valid credit card numbers before it is saved on the database. In case of any findings in subject or body, all but the first six and the last four digits will be replaced by a configurable masking character.
See also
The behavior can be changed with the following settings in the system configuration:
OTRSCreditCardFilter::ActiveMaskEnabled
OTRSCreditCardFilter::MaskedCharacter
For example 1234-5678-9012-3456 becomes 1234-56xx-xxxx-3456.
Warning
This procedure is permanent and irreversible!
To use this feature:
Create a ticket with the following article body:
Issuing Network,Card Number JCB 15 digit,180061388939823 JCB 15 digit,180079668437698 JCB 15 digit,180001434886883 JCB 15 digit,180044208063503 JCB 15 digit,180010497338476 JCB 15 digit,210004248524033 JCB 15 digit,210012319871803 JCB 15 digit,180094846333594 JCB 15 digit,210084424984649 JCB 15 digit,210012951351973 JCB 15 digit,210008094074787 JCB 15 digit,210081171733450
Open the Ticket Zoom screen to see the created ticket. The body of the article will shown as:
Issuing Network,Card Number JCB 15 digit,180061xxxxx9823 JCB 15 digit,180079xxxxx7698 JCB 15 digit,180001xxxxx6883 JCB 15 digit,180044xxxxx3503 JCB 15 digit,180010xxxxx8476 JCB 15 digit,210004xxxxx4033 JCB 15 digit,210012xxxxx1803 JCB 15 digit,180094xxxxx3594 JCB 15 digit,210084xxxxx4649 JCB 15 digit,210012xxxxx1973 JCB 15 digit,210008xxxxx4787 JCB 15 digit,210081xxxxx3450
You can also try with valid credit card numbers in the subject or fetch a mail with valid credit card information using a postmaster account.
Credit Card Warning Message¶
It is possible to display a warning message next to the credit card number.
To use this feature:
Make sure that setting
OTRSCreditCardFilter::ActiveMaskEnabled
is not enabled.Make sure that setting
OTRSCreditCardFilter::WarningTextEnabled
is enabled.Define your custom message in setting
OTRSCreditCardFilter::WarningText
in the system configuration.Create a ticket with the following article body:
Issuing Network,Card Number JCB,3528988095245935 JCB,3112606824580636 JCB,3096030869937728 JCB,3112437499296450 JCB,3096010732100407 JCB,3528461498782367 JCB,3112892137191440 JCB,3088814635323630
Open the Ticket Zoom screen. The warning message should appear next to the credit card number.
Issuing Network,Card Number JCB,3528988095245935 Reminder: You should not store credit card numbers in this product! JCB,3112606824580636 Reminder: You should not store credit card numbers in this product! JCB,3096030869937728 Reminder: You should not store credit card numbers in this product! JCB,3112437499296450 Reminder: You should not store credit card numbers in this product! JCB,3096010732100407 Reminder: You should not store credit card numbers in this product! JCB,3528461498782367 Reminder: You should not store credit card numbers in this product! JCB,3112892137191440 Reminder: You should not store credit card numbers in this product! JCB,3088814635323630 Reminder: You should not store credit card numbers in this product!
You can also try with valid credit card numbers in the subject or fetch a mail with valid credit card information using a postmaster account.