Card Number Conversion Tool
About
| Through this tool you can find conversion method and setup YSoft SafeQ to convert card numbers read by terminals to match value stored in database. | At Glance
|
General overview
Card Conversion tool can be found on web interface: Users -> Users list -> Actions -> Card conversion settings
Another option is locate property conversion in System Settings and pres ... button.
Card conversion tool is divided to few parts described below:
For proper functionality of Card number conversion tool is required to enter at least three card number pairs to get as accurate result as possible.
Attribute | Description |
Card reader output | Card number how it is read by used card reader. |
Card number in database | Card number how it is stored in user database (LDAP, AD, SafeQ, etc.). Card manager is used to convert reader output to this desire format. |
Card readed type | Used card reader type. Each line can use different card reader type because you could need to find card manager that works for all used card readers. If you don't know the reader type select Arbitrary
|
| Add a new pair (new card numbers) that should be evaluated |
| Remove an existing row from evaluation |
Find matching card manager | According to the entered rows, the database will be searched for known card managers. Results of this search will be displayed in Exact result panel. |
Enter expression manually | This options can be used by experts. Enter requested expression manually. You can find syntax description in YSoft SafeQ documentation (use dialog's help). |
Exact results | Search results are displayed here. In the case when more than one card manager had been found during the search there will be displayed more than one result. Add additional card number pairs to make result more exact or choose one of them. |
Partial results | Results that are matching only part of entered card number pairs. These card manager can not be used. You can use link next to them to find out which pairs are matching to them and which are not. |
| Evaluate entered card manager pairs against the database for known card managers. |
| Selected card manager will be chosen and saved in SafeQ system. System restart can be mandatory for settings to be applied in same cases. |
Enter at least three card number pairs to get as accurate result as possible
Enter expression manually (Expert mode)
You can create an custom expression for card matching through Enter expression manually option.
For more information about these mechanism see Use Card Number Conversion.
Disabling logging of card numbers
If it is necessary (e.g. for security reason) hide card numbers from log, add following snipped to log4j.xml.
<category name="com.ysoft.safeq.terminal.protocol.SecureEncoding" additivity="false">
<level value="warn" />
<appender-ref ref="log_app"/>
</category>
Limitations:
Card numbers received from SafeQ Client to authenticate user are not converted in any way before SafeQ searches them in its database/cache.