Masked Secure Text Field for Jira enables to restrict its value from reading by unauthorized users. Additionally, it allows controlling data entry formats so that entered data is valid. For example, a text editor should only accept phone numbers or an email field might have a validation rule that disallows entering an email address that is incorrectly formatted.
noteWe use Java regular expressions to define a search pattern.
We use Java regular expressions to define a search pattern.
Standard Sample Masks
The following table describes the standard patterns available.
Pattern | Description/examples | Masked field view |
|---|---|---|
All characters | Allows any characters, including spaces. Mask everything except for the last 3 characters. Field value: y di6T#4 |  |
Phone number | Allows digits from 0 to 9 and specified symbols. Mask everything except for the last 3 digits. Field value: (541) 754-3010 |  |
Integer | Allows integer numbers. Field value: 4854679856 |  |
Decimal | Allows decimal numbers. Mask all characters except decimal point. Field value: 5464.804173 |  |
Allows entries in the email address format. Field value: test@gmail.com |  | |
IPv4 | Allows entries in IPv4 format. Field value: 69.89.31.226 |  |
IPv6 | Allows entries in IPv6 format. Field value: 2607:f0d0:1002:51::4 |  |
00-000 | Allow a respective number of digits. Field value: 75-667 Field value: 963-246-78-38 Field value: 2173-5778-9653-0638 |  |
000-000-00-00 |  | |
0000-0000-0000-0000 |  |
Permissions
Note that the new permission has been added. Make sure to grant the Read masked field permission to the respective user in order to enable the user to read or edit the masked field value.
Masked Field History
If Save field history option is enabled, Masked Field stores its history. So every time a user changes the value, the history section gets updated.
In a history record, a user can view the following information: who made a change, time when a change was made, new and old Masked field values.
Only users with respective permissions can view or delete the history of the Masked field.
Field configuration
Configure parameters for the Secure Masked Text
Mask regular expression - regular expression pattern that will be used to determine which characters should be masked.
Validation regular expression - checks whether the entered value matches the given format.
Validation error message - general error message if the validation checks fail. You can define your own custom message to display in case of errors.
As a Jira Administrator, you can change the standard configuration and set different limits or conditions on the data that can be entered in the field.
Mode: if Standard mode is being used (this is set by default), an error message is not thrown in case of invalid input and the entered value is accepted. However, all field characters will be masked.
Strong mode - in this case, the system won’t let the user enter an invalid format of data and will alert the user with the pre-defined error message.
Masked Field Search
Limited capability of searching over the masked fields.
Users are unable to search for the content of the masked field.
Only is Empty or is not Empty operators can be used for searching in either Performance or Strict mode.
Test your configuration
You can preview how the masked field would look in case of valid and invalid inputs. The input value is automatically validated to ensure that it’s a properly formatted e-mail address.
Notice that in case of invalid input all characters are masked (only applies to Standard mode).
