This document is written in English only
Configuration Application is a standalone application to provide GUI for configuration XML file. Configuration Application located in the same directory with installed LRA Client. Name of executable is ConfigurationApplication.exe.
Default setup folder has from v3.4 changed to Buypass Access Manager, so it has changed from:
Windows x32 – Program Files\Buypass\Lra Client
Windows x64 – Program Files (x86)\Buypass\Lra Client
To:
Windows x32 – Program Files\Buypass\Buypass Access Manager
Windows x64 – Program Files (x86)\Buypass\ Buypass Access Manager
Also link to ConfigurationApplication.exe is placed in Start menu (Windows 7).
TEST button in GUI of the LOCAL and MASTER configuration will test actual parameters. Remember to save if any of them are red before exit the application.
Configuration application logs will be stored in separate log file {ApplicationFolder}\Logs\configuration.trace.log
Navigation
You can use TAB key to navigate between tabs, fields and buttons. To get to the menu use ALT key. Use arrow keys to navigate between options in menus and tabs. Most of controls have tooltips with additional description. Move mouse pointer over the needed parameter.
Id | Description | Comments |
---|---|---|
#1 | Application menu | Available functions:
|
#2 | Configuration file tabs | Lists open configuration files |
#3 | Configuration file path | Absolute URI of configuration file |
#4 | Tab control | Tabs list of parameters subgroups |
#5 | List of paremeters | - |
#6 | Tool tip | Help tooltip with additional info about pointed parameter |
#7 | Revert button | Reverts all changes on all tabs with parameters of edited file |
#8 | Save button | Save all changes in file |
#9 | Save as button | Save file with last changes in another file |
Local Configuration
Local configuration file contains parameters that may be specific to each LRA client station. This file usually stored locally.
Local_Common
Id | Description | Comments |
---|---|---|
#1 | Master configuration | Path to master configuration file. Contains two functions:
|
#2 | Language | Language used in GUI for labels and guidelines.* |
#3 | Place | Place or address of organization will be written in all PDF documents generated. |
* For test purposes you can use special mode with key values on the place of all localized strings. To set this mode you need to open local configuration xml file and type “de-DE” in Culture field.
||
Smartcard
Id | Description | Comments |
---|---|---|
#1 | Refresh list of available readers | Gets list of readers connected to LRA station |
#2 | Combo box for assign readers | – |
#3 | Test selected readers button | Checks access to readers (and secure features if needed) |
Scanner
Id | Description | Comments |
---|---|---|
#1 | Scanner device ID | Gui format |
#2 | Choose scanner button* | Shows native dialog to select scanner from available from this machine |
#3 | Test scanner button | – |
* Windows Image Acquisition (WIA) service must be started on client PC.
Logs
Id | Description | Comments |
---|---|---|
#1 | Severity | Desired severity for default log (trace.log file in the app directory)
|
SignPad
Id | Description | Comments |
---|---|---|
#1 | Test SignPad button | Ensures SignPad is accessible. |
Test all tabs for local config
Id | Description | Comments |
---|---|---|
#1 | Test all button | Tests all devices with current settings and shows aggregated results. |
#2 | Test result area | - |
Master Configuration
Master configuration file contains parameters that are common to all LRA stations within one organization. This file usually stored in shared area.
Common
Id | Description | Comments |
---|---|---|
#1 | LRA mode | Different configurations of LRA-client; Local issues local certificates only, Buypass issues qualified certificates only and Mixed issues both local and qualified certificates. Mixed mode is default value. Unnecessary tabs will be disabled at left panel. |
#2 | Company name | Name of organization will be written in all PDF documents generated. If organization has more LRA-clients situated in different locations - name can show department. |
Smartcard
Id | Description | Comments |
---|---|---|
#1 | Local certificates key length | Defines the certificate size generated on the smartcard. Valid values:
Value chosen must be in compliance with key length in template. |
Active directory - common
Id | Description | Comments |
---|---|---|
#1 | Domain | Defines the name of the domain controller. Example: testdc:389 |
#2 | Search base | Defines the searchpath for searching for Users in AD. Different OU's (directories) in AD can be defined and included. * |
#3 | Use nested groups | If Users are connected to usergroups in AD, which in turn are linked to the certification groups rather than linking one and User to one or more certificategroups this checkbox must be ticked off. |
#4 | Test backend button | Ensures AD is accesible. |
*) Search Base
Active Directory allows administrators to create a hierarchy within a domain that meets the needs of their organization. The object class of choice for building these hierarchies is the class organizationalUnit, a general-purpose container that can be used to group most other object classes together for administrative purposes. An organizational unit in Active Directory is analogous to a directory in the file system; it is a container that can hold other objects.
To define path to SearchBase OU-s you need to construct the entire distinguished name by following references to the root. You can use (*) in case of recursive search needed. Several SearchBases supported separated by semicolon.
For example: we have this Active Directory structure:
- If you need to search only in testOU_1 and not include subunits: SearchBase: ou=testOU_1, ou=TestUsers, ou=Infopulse;
- If you need to search in TestUsers and all subunits, you need to use sign of recursive search – “(*)”. SearchBase: ou=TestUsers, ou=Infopulse(*);
- If you need to search in OU-s testOU_1_1 and all subunits, and also search in testOU_2 without subunits: SearchBase: ou=testOU_1_1, ou=testOU_1, ou=TestUsers, ou=Infopulse(*); ou=testOU_2, ou=TestUsers, ou=Infopulse;
Note: Order of organization units must be specified from bottom to top.
Active directory - employee mappings
Id | Description | Comments |
---|---|---|
#1 | Update button | Gets list of available mapping fields from AD |
#2 | First name | First name should consist of first and middel name. |
#3 | Last name | Last name should consist of last name only. |
#4 | Official email of User in the organization. | |
#5 | SSN in AD mapping** | 11 digits number which consists of date of birth (6 digits on format ddmmyy) and social security number (5 digits). Available forms:
Note: Date format is case sensitive. Additional information about date and time formats can be found here on Microsofts pages. |
#6 | Issuer Key mapping** | AD field to be used as IssuerKey. Should be unique per organization. UserName will be transferred to Buypass if MixedMode and used as lookup on search. Must not be changed without notifying Buypass. |
** For any AD mapping fields you can use any AD attribute listed in AD Attributes List. For selected AD attribute «LDAP-Display-Name» should be used.
Active directory - group mappings
Id | Description | Comments |
---|---|---|
#1 | Update button | Gets list of available groups from AD |
#2 | Local certificate group | Users belonging to Local certificate group will have local certificate issued (LC). |
#3 | Operator group | Users belonging to Operator group will have enrollment agent certificate issued (EA). |
#4 | Administrator group | Users belonging to Administrator group will have enrollment agent certificate issued (EA). |
#5 | Qualified certificate group | Users belonging to Qualified certificate group will have a par of qualified certificates issued (QC). |
Certificate Authority - CA
Id | Description | Comments |
---|---|---|
#1 | Configuration | Defines the common name of the CA configuration. Example: ca.testlab.local\Testlab CA |
#2 | Domain name | Defines the domain name. |
#3 | UpnPostfix | Defines the fqdn for the domain. Example: testlab.local |
#4 | Update button | Gets certificate templates |
#5 | Logon template | – |
#6 | Temporary template | – |
#7 | Enrollment agent template | – |
#8 | Test CA button | Ensures CA is accessible |
Reports
Id | Description | Comments |
---|---|---|
#1 | Path to reports output directory | Filearea for storage of reports. |
#2 | Test button | When pushing a TEST button we generate a file then store it and delete. |
Document Registry
Id | Description | Comments |
---|---|---|
#1 | Local document registry path | Filearea for storage of PDF documents generated when LRA functions are run. |
#2 | Test button | When pushing a TEST button we generate a file then store it and delete. |
Remote functions
Id | Description | Comments |
---|---|---|
#1 | Remote functions enabling checkbox | If organization is using remote functions having Users at remote locations this checkbox must be ticked off. Give access to Remote function menu. If checked remote functions menu appears in LRA |
#2 | Auto check request count | If number of remote certificate request should be counted and shown in Main menu this checkbox must be ticked off. |
#3 | Path to requests | Filearea for storage of remote certificate requests. |
#4 | Path to responses | Filearea for storage of certificates generated which act as responses of remote requests. |
#5 | Requests pooling interval | Defines the polling interval in milliseconds. Default value is 2000. |
#6 | Max number of attempts | Defines the maximum retry times the LRA client tries to acces the remote area. Default value is 30. |
#7 | Test button | When pushing a TEST button we generate a file then store it and delete. |
Buypass mapping
Id | Description | Comments |
#1 | Merchant ID | Merchant ID connected to organization. Will be provided by Buypass |
#2 | Timeout | Max time of waiting response from LTS |
#3 | Endpoint address | Address for PROD: https://www.buypass.no/weblts/p1 Address for TEST: https://www.test4.buypass.no/weblts/p1 |
#4 | Merchant certificate serial number | Serial number of merchant certificate installed in certstore. Certificate should be installed as described in LRA Client readme file |
#5 | Use SSN as IssuerKey | Possibility to register a UserName other than SSN in BUYPASS MODE:
|
#6 | Test LTS connection button | Signing a request and send it to LTS to get a response OK |
Issue process
Id | Description | Comments |
---|---|---|
#1 | Agreement sign required | If User should accept agreement on first time issuance of local certificates this ceckbox must be ticked off. |
#2 | User scan and document scan required | If User should sign and get his ID document scanned on first time issuance of local certificates this ceckbox must be ticked off. |
#3 | Document scan required on replace | If User should get his ID document scanned on issuance of replacement of both local and qualified certificates this ceckbox must be ticked off. |
#4 | Third party identification enabled | If organization allow 3.party identification in cases where User has forgotten his own ID document this checkbox must be ticked off. |
#5 | Timeout | Third party card waiting timeout |
Test all tabs for master config
Id | Description | Comments |
---|---|---|
#1 | Test all button | Tests all backends/devices with current settings and shows aggregated results. |
#2 | Test result area | - |
Buypass 2014 ©