8000 custom fields program updates · Somnn/docs.hackerone.com@cc993b9 · GitHub
[go: up one dir, main page]
Skip to content

Commit cc993b9

Browse files
stacyspivastacyspiva
committed
custom fields program updates
1 parent 8ac7839 commit cc993b9

File tree

5 files changed

+48
-26
lines changed

5 files changed

+48
-26
lines changed

‎docs/programs/custom-fields.md

Lines changed: 48 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -6,52 +6,60 @@ id: "programs/custom-fields"
66

77
Program administrators can configure custom fields to add data to their reports. This enables your program members to add additional information to your reports to help you better manage and analyze your internal data by the categories that you define to be important, such as by business unit or by root cause analysis.
88

9-
> This feature is only available to Enterprise programs.
9+
Administrators can also create hacker facing custom fields to require specific information from hackers regarding the vulnerability and how they found it. This can help speed up the remediation process as it’ll minimize the back-and-forth between the hacker and the program in getting necessary information.
1010

11-
### Create a Custom Field
11+
> This feature is only available to Enterprise programs. Hacker facing custom fields are currently in beta.
12+
13+
### Create a custom field
1214

1315
> **Note:** You must be an administrator of the program in order to add a custom field.
1416
1517
To create a custom field:
1618
1. Go to **Program > Customization > Custom Fields**.
17-
2. Click **New Custom Field**.
19+
2. Click **Add Custom Field**.
1820
3. Enter the **Field Title** on the **Create Custom Field** page.
19-
4. Select the **Field Type**. You can choose from:
21+
4. Choose the type of field you’d like for the Select type. You can choose from:
2022

2123
Option | Details
2224
------ | --------
23-
Text | This option enables you to create an editable text field.<br><br>![creating a text type custom field](./images/custom-fields-2.png)
25+
Text | This option enables you to create an editable text field.
2426
List | This option enables you to create a drop-down list that you can select from when editing your custom field.<br><br>Enter your option items in the **Configuration List** field separated by a comma.<br><br>![creating a list type custom field](./images/custom-fields-3.png)
27+
Checkbox | This option enables you to create a clickable checkbox option so that hackers or program members can select if the vulnerability meets the criteria the field is labeled with.<br><br>![custom fields checkbox type](./images/custom-fields-checkbox.png)
28+
Date/Time | This option enables you to create a clickable calendar and time field so that hackers or program members can input the correct date and time of their findings. <br><br>![custom fields date/time](./images/custom-fields-date-time.png)
2529

26-
5. Click **Save**.
30+
5. Select the **Visibility** type you’d like for the custom field. You can choose from:
2731

28-
All of your reports will now have a Custom Fields section. You can edit the section to add the Custom Field label you created.
32+
Option | Details
33+
------ | --------
34+
Internal | Only the internal members of your program will be able to see the custom field.
35+
Hacker facing | The field will appear on the report for the hacker to complete.
2936

30-
![Custom Fields section on the report](./images/custom-fields-4.png)
37+
6. *(Optional. Only displays for hacker facing custom fields.)* Select the checkbox to indicate that you’d like to mark the field as required on the report.
38+
7. *(Optional. Only displays for hacker facing custom fields.)* Enter the helper text you’d like to use to help guide hackers in filling out the custom field.
39+
8. *(Optional)* Enter a regular expression in the Validation via regular expression field. This is make sure that all inputs for the field are valid. [Learn more about using regular expressions to validate the input](https://www.regular-expressions.info/).
40+
9. *(Optional)* Enter the error message that you would like to display when the validation fails.
41+
10. Click **Save**.
3142

32-
The custom field will also be added into your inbox filter so that you can filter your reports by the custom field you created. The image below shows the filter 2 custom fields that were created: Squad and Root Cause Analysis. To filter on **Text** types for reports that don't have the custom field set, click in the custom field input box and press the **Return** key without entering a value. For **List** types, click on the custom field and select the Empty option.
43+
All of your reports will now have a Custom Fields section on the right-hand side that will show both your created internal and hacker facing custom fields. Hackers can add the details corresponding to each hacker facing custom field, and your internal program members can add information for the internal custom fields.
3344

34-
![Custom fields inbox filter](./images/custom-fields-5.png)
45+
![custom fields sidebar](./images/custom-fields-sidebar.png)
3546

36-
### Fill in a Value for a Custom Field
47+
### Fill in a value for a custom field
3748
To fill in a value for a Custom Field to your report:
38-
1. Go the report you want to add a custom field to.
39-
2. Click **Edit** in the Custom Fields section.
40-
41-
![edit button in the custom fields section](./images/custom-fields-4.png)
49+
1. Go the report you want to add custom field details to.
50+
2. Click the pencil icon to edit the custom fields section.
51+
3. Enter the information you want to add for each custom field.
52+
4. Click **Save**.
4253

43-
3. Enter the information you want to add to the field for each field label.
44-
4. Click **Save and add fields**.
54+
The information you input will now be tied to your field labels.
4555

46-
The information you input will now be tied to your field labels. To edit the information, click **Edit**.
56+
When you export your reports as a CSV file, the custom field and the information associated with it will also be included in the export. Each custom field will be exported with an associated key. The key for each field is comprised of: `<team_id>_<custom_field_attribute_label>`.
4757

48-
![what custom fields looks like in the report](./images/custom-fields-6.png)
49-
50-
When you export your reports as a CSV file, the custom field and the information associated with it will also be included in the export. Each custom fields will be exported with an associated key. The key for each field is comprised of: `<team_id>_<custom_field_attribute_label>`.
58+
The image below shows an example of an exported report with the custom field labels of `squad`, `source`, and `rca` in the header of each column.
5159

5260
![custom fields in the exported report](./images/custom-fields-export.png)
5361

54-
### Edit a Custom Field
62+
### Edit a custom field
5563
You can edit your custom fields to change the name of the field label.
5664

5765
![custom fields list](./images/custom-fields-list.png)
@@ -65,15 +73,29 @@ To edit the title of a custom field:
6573

6674
When you edit a custom field, the key associated with the field will also change.
6775

68-
### Archive Custom Fields
69-
You can archive custom fields that you no longer want to use. We don’t enable you to permanently delete custom fields to prevent data loss.
76+
### Archive custom fields
77+
You can archive custom fields that you no longer want to use. We don’t enable you to permanently delete custom fields as a precaution to prevent data loss.
7078

7179
![unarchive custom fields](./images/custom-fields-unarchive.png)
7280

7381
To archive a custom field:
7482
1. Go to **Program > Customization > Custom Fields**.
75-
2. Click **Archive**.
83+
2. Click **Archive** next to the custom field you want to archive.
7684

7785
The archived field can no longer be added to new reports. Current and past reports with the archived field will remain on the report and won’t disappear. You can, however, edit the field within the report.
7886

79-
You can unarchive an archived custom field by clicking **Unarchive**.
87+
You can unarchive an archived custom field by clicking **Unarchive** next to the archived custom field.
88+
89+
### Filter reports by custom field
90+
You can filter your inbox reports by the custom fields you created as each custom field you create will be added into your inbox filter.
91+
92+
To filter your inbox by custom fields:
93+
1. Go to your inbox.
94+
2. Click **Show filters**.
95+
3. Scroll down to the **Custom fields** filters.
96+
4. Select the custom fields you want to filter by.
97+
98+
To filter by **Text types** for reports that don't have the custom field set, click in the custom field input box and press the **Return** key on your keyboard without entering a value.
99+
100+
To filter by **List types** for reports that don't have the custom field set, click on the custom field and select the *Empty* option.
101+
![custom field list type filter](./images/custom-field-list-type-filter.png)

‎docs/programs/images/custom-field-list-type-filter.png

25.4 KB
Loading

‎docs/programs/images/custom-fields-checkbox.png

8.83 KB
Loading

‎docs/programs/images/custom-fields-date-time.png

54 KB
Loading

‎docs/programs/images/custom-fields-sidebar.png

64.3 KB
Loading

0 commit comments

Comments
 (0)
0