Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Commit 0804731

Browse files
stacyspivastacyspiva
committed
servicenow edits
1 parent 5fedbc5 commit 0804731

File tree

1 file changed

+52
-45
lines changed

1 file changed

+52
-45
lines changed

‎docs/programs/servicenow-integration.md

Lines changed: 52 additions & 45 deletions
Original file line numberDiff line numberDiff line change
@@ -11,9 +11,9 @@ HackerOne offers a bi-directional ServiceNow integration that enables you to syn
1111
### Set up
1212
To set up the bi-directional integration between HackerOne and your ServiceNow instance, you’ll need to follow these 4 steps:
1313
1. [Configure incoming requests in your ServiceNow instance](#configure-incoming-requests)
14+
2. [Configure the integration on HackerOne](#configure-on-hackerone)
1415
2. [Configure outgoing requests in your ServiceNow instance](#configure-outgoing-requests)
15-
3. [Configure a “close report” request from ServiceNow to HackerOne](#configure-close-report-event)
16-
4. [Configure the integration on HackerOne](#configure-on-hackerone)
16+
4. [Configure a “close report” request from ServiceNow to HackerOne](#configure-close-report-event)
1717

1818
### Configure Incoming Requests
1919
Configuring incoming requests requires you to post to a custom REST API endpoint in ServiceNow. This will enable you to add comments from HackerOne to your ServiceNow instance.
@@ -97,6 +97,49 @@ Make sure you enter the correct table name, as in this case, it's *incident*.
9797
![servicenow-6](./images/servicenow-6.png)
9898
![servicenow-7](./images/servicenow-7.png)
9999

100+
### Configure on HackerOne
101+
102+
To set up the integration on HackerOne:
103+
1. Navigate to **Program Settings > Program > Integrations**.
104+
2. Click **Connect with ServiceNow**.
105+
106+
![servicenow-16](./images/servicenow-16.png)
107+
108+
3. Click **Edit** to start the setup process.
109+
110+
![servicenow-17](./images/servicenow-17.png)
111+
112+
4. Authenticate your ServiceNow instance by entered information to these fields:
113+
114+
Field | Details
115+
----- | -------
116+
ServiceNow Instance URL | Enter the full URL to your ServiceNow instance, for example it could be: https://my-instance.service-now.com/
117+
Username & Password | Enter the credentials for a user that has access to the ServiceNow instance.
118+
119+
5. Configure data mapping from HackerOne reports to ServiceNow incidents. This uses the API of both systems to retrieve fields that are allowed to be used for these objects. For example, you could map the HackerOne report title to the ServiceNow incident short description.
120+
121+
![servicenow-18](./images/servicenow-18.png)
122+
123+
6. Click **Next**.
124+
125+
7. Enter your ServiceNow New Comment endpoint that was configured earlier in the **ServiceNow “Add Comment” endpoint** field. This should be a combination of the URL to your instance and the Resource Path found in the Scripted REST API object in ServiceNow.
126+
127+
![servicenow-19](./images/servicenow-19.png)
128+
129+
![servicenow-20](./images/servicenow-20.png)
130+
131+
8. Click **Next**.
132+
9. Copy the public listener URL in the configuration wizard.
133+
10. Go back to ServiceNow and open the Outbound REST Message,
134+
11. Paste the copied public listener URL in the **Endpoint** field.
135+
136+
![servicenow-21](./images/servicenow-21.png)
137+
138+
12. Click **Enable** to finish enable the integration.
139+
140+
![servicenow-22](./images/servicenow-22.png)
141+
142+
100143
### Configure Outgoing Requests
101144
After configuring incoming requests, you’ll need to configure outgoing requests in ServiceNow which will enable you to post comments from ServiceNow to HackerOne. You’ll need to use Outbound REST Messages and Business Rules in the configuration process.
102145

@@ -153,7 +196,7 @@ Content-Type | application/json
153196
Field | Value
154197
----- | ------
155198
Name | Add Comment
156-
Table | Journal Entry [sys_journal_field]
199+
Table | Journal Entry [sys\_journal\_field]
157200
Advanced | Make sure the box is checked
158201

159202
13. Enter these values for these fields on the **When to run** tab:
@@ -188,8 +231,12 @@ Make sure that the arguments for RESTMessageV2 matches the name you gave to the
188231
The close report event from ServiceNow to HackerOne is set up in a similar fashion to configuring the outgoing requests. You only need to change the content in the Outbound REST Message and the trigger action in the Business Rule.
189232

190233
To set up the close report event:
191-
1. Search for the HackerOne REST Message that was set up in the previous section.
192-
2. Click **New** to add a new message.
234+
1. 1. Navigate to: **System Web Services > Outbound > REST Message**.
235+
236+
![servicenow-8](./images/servicenow-8.png)
237+
238+
2. Search for the HackerOne REST Message that was set up in the previous section.
239+
3. Click **New** to add a new method.
193240

194241
![servicenow-13](./images/servicenow-10.png)
195242

@@ -237,43 +284,3 @@ Filter Conditions | State: changes to : Closed
237284
)(current, previous);
238285
```
239286
Make sure the arguments for RESTMessageV2 match the name you gave the Outbound REST Message and HTTP Method.
240-
241-
### Configure on HackerOne
242-
After configuring all of the steps above, you’re now ready to configure the integration on HackerOne.
243-
244-
To set up the integration on HackerOne:
245-
1. Navigate to **Program Settings > Program > Integrations**.
246-
2. Click **Connect with ServiceNow**.
247-
248-
![servicenow-16](./images/servicenow-16.png)
249-
250-
3. Click **Edit** to start the setup process.
251-
252-
![servicenow-17](./images/servicenow-17.png)
253-
254-
4. Authenticate your ServiceNow instance by entered information to these fields:
255-
256-
Field | Details
257-
----- | -------
258-
ServiceNow Instance URL | Enter the full URL to your ServiceNow instance, for example it could be: https://my-instance.service-now.com/
259-
Username & Password | Enter the credentials for a user that has access to the ServiceNow instance.
260-
261-
5. Configure data mapping from HackerOne reports to ServiceNow incidents. This uses the API of both systems to retrieve fields that are allowed to be used for these objects. For example, you could map the HackerOne report title to ServiceNow incident short description.
262-
263-
![servicenow-18](./images/servicenow-18.png)
264-
265-
6. Enter your ServiceNow New Comment endpoint that was configured earlier in the **ServiceNow “Add Comment” endpoint**. This should be a combination of the URL to your instance and the Resource Path found in the Scripted REST API object in ServiceNow.
266-
267-
![servicenow-19](./images/servicenow-19.png)
268-
269-
![servicenow-20](./images/servicenow-20.png)
270-
271-
7. Copy the public listener URL in the configuration wizard.
272-
8. Go back to ServiceNow and open the Outbound REST Message,
273-
9. Paste the copied public listener URL in the **Endpoint** field.
274-
275-
![servicenow-21](./images/servicenow-21.png)
276-
277-
10. Click **Enable** to finish enable the integration.
278-
279-
![servicenow-22](./images/servicenow-22.png)

0 commit comments

Comments
 (0)