Skip to content
This repository was archived by the owner on Apr 23, 2025. It is now read-only.

Commit d06fa69

Browse files
committed
chore: add notices about WAFs and CAPTCHA
1 parent 3358637 commit d06fa69

File tree

3 files changed

+22
-10
lines changed

3 files changed

+22
-10
lines changed

docs/guides/web_scraping/content.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,10 @@ sidebar_label: Content Trackers
77

88
The web page content tracker is a utility that empowers developers to detect and monitor the content of any web page. Alongside [web page resources trackers](./resources.md), it falls under the category of [synthetic monitoring](https://en.wikipedia.org/wiki/Synthetic_monitoring) tools. However, it extends its capabilities to cover a broader set of use cases. These range from ensuring that the deployed application loads only the intended content throughout its lifecycle to tracking changes in arbitrary web content when the application lacks native tracking capabilities. In the event of a change, whether it's caused by a broken deployment or a legitimate content modification, the tracker promptly notifies the user.
99

10+
:::caution NOTE
11+
Currently, Secutils.dev doesn't support tracking content for web pages protected by application firewalls (WAF) or any form of CAPTCHA. If you require tracking content for such pages, please comment on [#secutils/34](https://github.com/secutils-dev/secutils/issues/34) to discuss your use case.
12+
:::
13+
1014
On this page, you can find guides on creating and using web page content trackers.
1115

1216
:::note
@@ -213,6 +217,10 @@ console.log(foo(5));
213217
### Track API response
214218
You can use content tracker to track API responses as well (until dedicated [`API tracker` utility](https://github.com/secutils-dev/secutils/issues/32) is released). For instance, you can track the response of the [JSONPlaceholder](https://jsonplaceholder.typicode.com/) API:
215219
220+
:::caution NOTE
221+
Ensure that the web page from which you're making a fetch request allows cross-origin requests. Otherwise, you'll get an error.
222+
:::
223+
216224
```javascript
217225
const { url, method, headers, body } = {
218226
url: 'https://jsonplaceholder.typicode.com/posts',

docs/guides/web_scraping/resources.md

Lines changed: 12 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,10 @@ The web page resources tracker is a utility that gives developers the ability to
99

1010
Additionally, security researchers focused on discovering potential security vulnerabilities in third-party web applications can use web page resources trackers. By being notified when the application's resources change, researchers can identify if the application has been upgraded, providing an opportunity to re-examine the application and potentially discover new vulnerabilities.
1111

12+
:::caution NOTE
13+
Currently, Secutils.dev doesn't support tracking resources for web pages protected by application firewalls (WAF) or any form of CAPTCHA. If you require tracking resources for such pages, please comment on [#secutils/34](https://github.com/secutils-dev/secutils/issues/34) to discuss your use case.
14+
:::
15+
1216
On this page, you can find guides on creating and using web page resources trackers.
1317

1418
## Create a web page resources tracker
@@ -307,7 +311,7 @@ Demo
307311
<td><b>URL</b></td>
308312
<td>
309313
```
310-
https://[YOUR UNIQUE ID].webhooks.dev.secutils.dev/track-me.html
314+
https://[YOUR UNIQUE ID].webhooks.secutils.dev/track-me.html
311315
```
312316
</td>
313317
</tr>
@@ -342,9 +346,9 @@ Configured tracker will fetch the resources of the `track-me.html` responder onc
342346
<table class="su-table">
343347
<tbody>
344348
<tr><th>Source</th><th>Diff</th><th>Type</th><th>Size</th></tr>
345-
<tr><td>`https://[YOUR UNIQUE ID].webhooks.dev.secutils.dev/no-change.js`</td><td>-</td><td>Script</td><td>81</td></tr>
346-
<tr><td>`https://[YOUR UNIQUE ID].webhooks.dev.secutils.dev/changed.js`</td><td>-</td><td>Script</td><td>91</td></tr>
347-
<tr><td>`https://[YOUR UNIQUE ID].webhooks.dev.secutils.dev/removed.js`</td><td>-</td><td>Script</td><td>78</td></tr>
349+
<tr><td>`https://[YOUR UNIQUE ID].webhooks.secutils.dev/no-change.js`</td><td>-</td><td>Script</td><td>81</td></tr>
350+
<tr><td>`https://[YOUR UNIQUE ID].webhooks.secutils.dev/changed.js`</td><td>-</td><td>Script</td><td>91</td></tr>
351+
<tr><td>`https://[YOUR UNIQUE ID].webhooks.secutils.dev/removed.js`</td><td>-</td><td>Script</td><td>78</td></tr>
348352
</tbody>
349353
</table>
350354

@@ -389,10 +393,10 @@ Normally, Secutils.dev caches web page resources for **10 minutes**. This means
389393
<table class="su-table">
390394
<tbody>
391395
<tr><th>Source</th><th>Diff</th><th>Type</th><th>Size</th></tr>
392-
<tr><td>`https://[YOUR UNIQUE ID].webhooks.dev.secutils.dev/no-change.js`</td><td><b>-</b></td><td>Script</td><td>81</td></tr>
393-
<tr><td>`https://[YOUR UNIQUE ID].webhooks.dev.secutils.dev/changed.js`</td><td><b>Changed</b></td><td>Script</td><td>91</td></tr>
394-
<tr><td>`https://[YOUR UNIQUE ID].webhooks.dev.secutils.dev/added.js`</td><td><b>Added</b></td><td>Script</td><td>76</td></tr>
395-
<tr><td>`https://[YOUR UNIQUE ID].webhooks.dev.secutils.dev/removed.js`</td><td><b>Removed</b></td><td>Script</td><td>78</td></tr>
396+
<tr><td>`https://[YOUR UNIQUE ID].webhooks.secutils.dev/no-change.js`</td><td><b>-</b></td><td>Script</td><td>81</td></tr>
397+
<tr><td>`https://[YOUR UNIQUE ID].webhooks.secutils.dev/changed.js`</td><td><b>Changed</b></td><td>Script</td><td>91</td></tr>
398+
<tr><td>`https://[YOUR UNIQUE ID].webhooks.secutils.dev/added.js`</td><td><b>Added</b></td><td>Script</td><td>76</td></tr>
399+
<tr><td>`https://[YOUR UNIQUE ID].webhooks.secutils.dev/removed.js`</td><td><b>Removed</b></td><td>Script</td><td>78</td></tr>
396400
</tbody>
397401
</table>
398402

docs/guides/web_security/csp.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
sidebar_position: 1
3-
sidebar_label: Content Security Policy
3+
sidebar_label: Content Security Policies
44
---
55

66
# What is a Content Security Policy?
@@ -260,7 +260,7 @@ CSP Test
260260
9. Once the policy is set up, it will appear in the policies grid
261261
10. Click the policy's **Copy policy** button and use **Policy source** dropdown to switch to **HTML meta tag** policy representation
262262
11. Copy `<meta>` HTML tag with the policy and navigate to [Webhooks → Responders](https://secutils.dev/ws/webhooks__responders) again
263-
12. Edit **Body** property of the previously created **csp-test** responder to include `<meta>` HTML tag with the policy inside `<head>` HTML tag
263+
12. Edit **Body** property of the previously created **CSP Test** responder to include `<meta>` HTML tag with the policy inside `<head>` HTML tag
264264
13. Click the **Save** button and navigate to the responder's URL again
265265
14. This time, when you click the **Eval** button, nothing happens and an error message is logged in the browser console meaning that you have successfully forbidden **eval()** with the Content Security Policy
266266

0 commit comments

Comments
 (0)