Overview

The PIN Box Widget is a Mendix custom widget that allows users to input a PIN  using a specified number of input boxes. This widget is designed for applications that require secure PIN entry, such as authentication and verification processes.

Documentation

Overview

The PIN Box Widget is a custom Mendix widget designed to allow secure PIN code input using a configurable number of input boxes. It is ideal for applications requiring authentication or verification processes, ensuring a user-friendly and secure PIN entry interface.

Typical Usage Scenario

Use Cases

• Authentication: Enhance the security of your login process by requiring users to enter a PIN.
• Verification: Use the PIN Box Widget for two-factor authentication or to verify transactions.
• Secure Access: Implement PIN-based access control for sensitive areas of your application.

Problem Solved

The PIN Box Widget addresses the need for a secure and customizable PIN entry solution in Mendix applications. It ensures that PIN input is easy to manage and integrates seamlessly with your application's security workflows.

Applicability

This widget is useful for any Mendix application that requires secure PIN entry, such as banking apps, secure access systems, and verification processes.

Features and Limitations

Features

• Configurable Number of Input Boxes: Set the number of input boxes to match the required PIN length.
• Input PIN Storage: Stores the entered PIN in a specified attribute for further processing.
• On Change Action: Triggers a nanoflow when the input PIN matches the number of boxes.

Installation

1. Download the Widget: Obtain the PIN Box Widget from the Mendix Marketplace.
2. Add to Project: Import the widget into your Mendix project.
3. Place on Page: Drag and drop the PIN Box Widget onto your desired page in the Mendix modeler.
4. Configure Properties: Set the number of input boxes, input PIN attribute, and the nanoflow to be triggered.

Configuration

1. Number of Input Boxes:

   • Navigate to the widget properties.
   • Set the Number of Input Boxes to the desired value.

2. Input PIN Attribute:

   • Select the Input PIN attribute where the entered PIN will be stored.

3. On Change Action:

   • Choose the Nanoflow to be called when the PIN input is complete.
   • Ensure the nanoflow is designed to handle the PIN verification or other required actions.

4. Nanoflow Arguments:

   • Configure the Nanoflow Arguments to pass the entered PIN as needed.

Known Bugs

• None: There are currently no known bugs with this widget.

Frequently Asked Questions

1. Can I change the number of input boxes dynamically?

No, the number of input boxes is set during configuration and cannot be changed dynamically at runtime.

2. How do I handle the entered PIN securely?

Ensure that the PIN is stored in a secure attribute and processed through a secure nanoflow to maintain data integrity and security.

3. What happens if the user does not enter the correct number of digits?

The widget triggers the nanoflow only when the entered PIN matches the specified number of input boxes.

4. Can I style the input boxes?

Yes, you can customize the appearance of the input boxes through the Appearance tab in the widget properties.