You can create user PIN codes to use for authentication in addition to passwords. The IDOL Community component can lock users out if they fail to authenticate using the PIN code.
To configure the IDOL Community component to use PIN codes
Open the IDOL Community component configuration file in a text editor.
Find the [User]
section, or create one if it does not exist.
Set the PincodeLength
parameter to the length of PIN code that you want to use. Created PIN codes must have the specified length, and must consist of alphanumeric characters. For example:
[User] PincodeLength=8
Save and close the configuration file.
When you enable PIN codes in the configuration file, you can assign them to users by sending a UserPin
action.
To add or change a PIN code
Send the following action to the IDOL Community component:
http://CommunityHost:CommunityPort/action=UserPin&UserName=Username&Pincode=PinValue
where:
CommunityHost
|
is the name or IP address of the host on which the IDOL Community component runs. |
CommunityPort
|
is the IDOL Community component ACI port. |
Username
|
is the name of the user for which you want to add a PIN code. |
PinValue
|
is the value of the new pin. |
You authenticate users with PIN codes by using the UserPin
action. This action can check certain characters in the PIN code, rather than the whole PIN code.
To authenticate a PIN code
Send the following action to the IDOL Community component:
http://CommunityHost:CommunityPort/action=UserPin&UserName=Username&Positions=Positions&Values=Values
where:
CommunityHost
|
is the name or IP address of the host on which the IDOL Community component runs. |
CommunityPort
|
is the IDOL Community component ACI port. |
Username
|
is the user name of the user whose account you want to authenticate. |
Positions
|
is a comma-separated list of the positions in the PIN code that you want to check. |
Values
|
is a comma-separated list of the values that Community must check against the specified positions. |
For example, to authenticate by using the third, fifth, and sixth characters from a PIN code, you must set Positions
to 3,5,6
. The Values
parameter then contains the values that the user provides, for example y,9,a
. Community checks that the specified values occur at the specified positions in the PIN code.
|