Skip to content

Commit

Permalink
[EDU-5837] refactor: update Fingerprint integration guide (#1397)
Browse files Browse the repository at this point in the history
* chore: disabled npm run tsc

* refactor: remove unnecessary old steps

* refactor: adjusting introduction and description

* Update fingerprint.mdx

* refactor: align with review and redirect

* refactor: aligning file name

* refactor: align with the review

---------

Co-authored-by: robsongajunior <[email protected]>
  • Loading branch information
MarianaAguilera and robsongajunior authored Dec 12, 2024
1 parent 7ab78c7 commit 77c6d9d
Show file tree
Hide file tree
Showing 10 changed files with 108 additions and 476 deletions.
4 changes: 4 additions & 0 deletions cicd/azion-massive-redirect-en.json
Original file line number Diff line number Diff line change
@@ -1,4 +1,8 @@
[
{
"from": "https://www.azion.com/en/documentation/products/guides/fingerprint/",
"moved": "https://www.azion.com/en/documentation/products/guides/javascript-tag-js-tag/"
},
{
"from": "https://www.azion.com/en/documentation/products/marketplace/bot-manager/",
"moved": "https://www.azion.com/en/documentation/products/secure/edge-firewall/bot-manager/"
Expand Down
4 changes: 4 additions & 0 deletions cicd/azion-massive-redirect-ptbr.json
Original file line number Diff line number Diff line change
@@ -1,4 +1,8 @@
[
{
"from": "https://www.azion.com/pt-br/documentacao/produtos/guias/fingerprint/",
"moved": "https://www.azion.com/pt-br/documentacao/produtos/guias/javascript-tag-js-tag/"
},
{
"from": "https://www.azion.com/pt-br/documentacao/produtos/marketplace/bot-manager/",
"moved": "https://www.azion.com/pt-br/documentacao/produtos/secure/edge-firewall/bot-manager/"
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -71,7 +71,7 @@ This use case is ideal for organizations looking to build a strong online presen
- Enable the Web Application Firewall, Network Layer Protection, and Edge Functions modules.
3. [Create a WAF rule set](/en/documentation/products/guides/secure/create-waf-rule-set/), configuring Threat Type and Sensitivity levels.
4. [Create a network list](/en/documentation/products/guides/blocklists-ip-addresses-edge/) in Network Layer Protection.
5. [Create your security edge functions](/en/documentation/products/guides/edge-functions/firewall/) or explore marketplace security integrations like [Fingerprint](/en/documentation/products/guides/fingerprint/), [reCaptcha](/en/documentation/products/guides/recaptcha/), [hCaptcha](/en/documentation/products/guides/hcaptcha/), [Secure Token](/en/documentation/products/guides/secure-token/), [JWT](/en/documentation/products/guides/jwt/), and [much more](/en/documentation/products/guides/#marketplace).
5. [Create your security edge functions](/en/documentation/products/guides/edge-functions/firewall/) or explore marketplace security integrations like [reCaptcha](/en/documentation/products/guides/recaptcha/), [hCaptcha](/en/documentation/products/guides/hcaptcha/), [Secure Token](/en/documentation/products/guides/secure-token/), [JWT](/en/documentation/products/guides/jwt/), and [much more](/en/documentation/products/guides/#marketplace).
6. [Create rules in Rules Engine](/en/documentation/products/guides/secure/work-with-rules-engine/) for Edge Firewall to define the behavior to be executed when the Edge Firewall detects a request matching the criteria defined by the rule sets, network lists, and edge functions.
7. Use [Observe products](/en/documentation/products/observe/overview/) to monitor your requests and traffic.

Expand Down
2 changes: 1 addition & 1 deletion src/content/docs/en/pages/guides/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -33,6 +33,7 @@ permalink: /documentation/products/guides/
- [How to enforce HLS cache for live streaming delivery](/en/documentation/products/guides/enforce-hls-cache/)
- [How to configure a WAF Custom Allowed Rule](/en/documentation/products/guides/secure/configure-waf-allowed-rules/)
- [How to configure WAF rules to allow requests with a specific cookie](/en/documentation/products/guides/secure/waf-rules-for-specific-cookie/)
- [How to install the Javascript Tag (JS TAG) through Azion](/en/documentation/products/guides/javascript-tag-js-tag/)

---

Expand Down Expand Up @@ -199,7 +200,6 @@ permalink: /documentation/products/guides/
- [How to install the Azion Bot Manager Lite integration from Azion Marketplace](/en/documentation/products/guides/bot-manager-lite/)
- [How to install the Content Targeting integration through Azion Marketplace](/en/documentation/products/guides/content-targeting-integration/)
- [How to install the Fauna integration through Azion Marketplace](/en/documentation/products/guides/fauna/)
- [How to install the Fingerprint integration through Azion Marketplace](/en/documentation/products/guides/fingerprint/)
- [How to install the hCaptcha integration through Azion Marketplace](/en/documentation/products/guides/hcaptcha/)
- [How to install the Hello World integration through Azion Marketplace](/en/documentation/products/guides/hello-world/)
- [How to install the IP Address Reputation integration through Azion Marketplace](/en/documentation/products/guides/ip-address-reputation/)
Expand Down

This file was deleted.

Original file line number Diff line number Diff line change
@@ -0,0 +1,48 @@
---
title: How to install the Javascript Tag (JS TAG) through Azion
description: Capture devices and network data to better identify devices accessing your applications, embedding a browser-level script.
meta_tags: protection, cybersecurity, edge computing
namespace: docs_use_case_fingerprint
permalink: /documentation/products/guides/javascript-tag-js-tag/
---

The **Javascript Tag (JS TAG)** is composed of a **browser-level script**, a [JavaScript code](#embedding-the-script) that must be added to the web page. It captures data about the browser and sets it as a session cookie named `_azfp_sc`, so this data is always sent by the browser.

---

## Embedding the script

The browser script is a JavaScript code that runs on the web page you want to fingerprint, a process also known as JavaScript injection. It captures multiple data from the web browser:

- Audio and video support
- Canvas rendering
- If the browser has access to device-level API, such as accelerometer and gyroscope
- Manufacturer's data
- Timezone
- WebGL rendering

Then, it creates a unique identifier containing all this information and sets it as a session cookie named `_azfp_sc`, as cookies are always sent in the requests made by the browser. The script checks if the session cookie already exists. If so, it won't create a new one.

Azion provides a code sample for this JavaScript injection that you can include in your project. To do so:

1. Add [this file](https://mal2u8n8zk.map.azionedge.net/274addd29ac1edb2b200a297b98581cd88465e2ee36f18cfdbdc063402063fe5.js) to your HTML source, following this example:

```bash
<script src="https://mal2u8n8zk.map.azionedge.net/274addd29ac1edb2b200a297b98581cd88465e2ee36f18cfdbdc063402063fe5.js"></script>
```

Alternatively, you can also:

1. Copy the code in [this file](https://mal2u8n8zk.map.azionedge.net/274addd29ac1edb2b200a297b98581cd88465e2ee36f18cfdbdc063402063fe5.js).
2. Create a new JavaScript file with the code.
3. Include the JavaScript file in your project folder.
1. In this example, the file name is `fingerprint-script.js`
4. Then, add it to your HTML source, following this example:

```bash
<script src="https://example.com/fingerprint-script.js"></script>
```

Where:
- `https://example.com/` is your domain.
- `fingerprint-script.js` is your JavaScript file name.
Original file line number Diff line number Diff line change
Expand Up @@ -72,7 +72,7 @@ Este caso de uso é ideal para organizações que buscam construir uma forte pre
- Habilite os módulos Web Application Firewall, Network Layer Protection e Edge Functions.
3. [Crie um rule set do WAF](/pt-br/documentacao/produtos/guias/secure/criar-waf-rule-set/), configurando o de tipo de ameaça e os níveis de sensibilidade.
4. [Crie uma network list](/pt-br/documentacao/produtos/guias/blocklists-enderecos-ip-edge/) no Network Layer Protection.
5. [Crie suas edge functions de segurança](/pt-br/documentacao/produtos/guias/edge-functions/firewall/) ou explore integrações de segurança do Marketplace da Azion, como [Fingerprint](/pt-br/documentacao/produtos/guias/fingerprint/), [reCaptcha](/pt-br/documentacao/produtos/guias/recaptcha/), [hCaptcha](/pt-br/documentacao/produtos/guias/hcaptcha/), [Secure Token](/pt-br/documentacao/produtos/guias/secure-token/), [JWT](/pt-br/documentacao/produtos/guias/jwt/) e [muito mais](/pt-br/documentacao/produtos/guias/#marketplace).
5. [Crie suas edge functions de segurança](/pt-br/documentacao/produtos/guias/edge-functions/firewall/) ou explore integrações de segurança do Marketplace da Azion, como [reCaptcha](/pt-br/documentacao/produtos/guias/recaptcha/), [hCaptcha](/pt-br/documentacao/produtos/guias/hcaptcha/), [Secure Token](/pt-br/documentacao/produtos/guias/secure-token/), [JWT](/pt-br/documentacao/produtos/guias/jwt/) e [muito mais](/pt-br/documentacao/produtos/guias/#marketplace).
6. [Crie regras no Rules Engine](/pt-br/documentacao/produtos/guias/secure/trabalhar-com-rules-engine/) do Edge Firewall para definir o comportamento a ser executado quando o Edge Firewall detectar uma requisição que corresponda aos critérios definidos pelos rule sets, network lists e edge functions.
7. Use os [produtos Observe](/pt-br/documentacao/produtos/observe/visao-geral/) para monitorar suas requisições e tráfego.

Expand Down
2 changes: 1 addition & 1 deletion src/content/docs/pt-br/pages/guias/guides.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -32,6 +32,7 @@ permalink: /documentacao/produtos/guias/
- [Como implementar cache HLS para entrega de streaming ao vivo](/pt-br/documentacao/produtos/guias/implementar-cache-hls/)
- [Como configurar uma WAF Custom Allowed Rule](/pt-br/documentacao/produtos/guias/secure/configurar-waf-allowed-rules/)
- [Como configurar regras de WAF para permitir requisições com um cookie específico](/pt-br/documentation/products/guides/secure/waf-rules-para-cookie-especifico/)
- [Como instalar o Javascript Tag (JS TAG) na Azion](/pt-br/documentacao/produtos/guias/javascript-tag-js-tag/)

---

Expand Down Expand Up @@ -199,7 +200,6 @@ permalink: /documentacao/produtos/guias/
- [Como utilizar a integração Azion Bot Manager Lite através do Marketplace da Azion](/pt-br/documentacao/produtos/guias/bot-manager-lite/)
- [Como utilizar a integração Content Targeting através do Marketplace da Azion](/pt-br/documentacao/produtos/guias/content-targeting-integration/)
- [Como utilizar a integração Fauna através do Marketplace da Azion](/pt-br/documentacao/produtos/guias/fauna/)
- [Como utilizar a integração Fingerprint através do Marketplace da Azion](/pt-br/documentacao/produtos/guias/fingerprint/)
- [Como utilizar a integração hCaptcha através do Marketplace da Azion](/pt-br/documentacao/produtos/guias/hcaptcha/)
- [Como utilizar a integração Hello World através do Marketplace da Azion](/pt-br/documentacao/produtos/guias/hello-world/)
- [Como utilizar a integração IP Address Reputation através do Marketplace da Azion](/pt-br/documentacao/produtos/guias/ip-address-reputation/)
Expand Down
Loading

0 comments on commit 77c6d9d

Please sign in to comment.