Skip to content

Latest commit

 

History

History
49 lines (27 loc) · 3.57 KB

README.md

File metadata and controls

49 lines (27 loc) · 3.57 KB
Raw

Fastly WASM Botd integration

Sample integration

image You can try running sample Fastly Compute@Edge WASP integration at https://botd-fingerprintjs.edgecompute.app.

Login: human, Password: iamnotbot

Setting up the integration with the pre-built package

Prerequisites

  • Fastly account with the Fastly Compute@Edge feature flag enabled.

Setting up

  1. Log in to manage.fastly.com.

  2. Click Create service, choose WASM, optionally rename service.

  3. Go to the Service configuration, edit the Domains section and add a domain. For testing purposes, you can use {some-name}.edgecompute.app format. For more information, take a look at Fastly documentation.

  4. Go to Hosts in Origins section.

    4.1. Create a new host with the URL of the web application you want to protect, name it backend. For demo purposes, you can also use our sample app with botd-example-app.fpjs.sh URL. Click on a pen icon to modify the host, then, select correct TLS setting for your app (in most production cases preserve default Yes, enable TLS and connect securely using port 443, for our sample app switch to No, do not enable TLS. Instead connect using port 80). Update settings.

    4.2. Create a new host with the URL of the botd API - botd.fpapi.io. Click modify the host, fill Name field as botd, choose Yes, enable TLS and connect securely using port 443 setting, click Advanced options at the end of the page and fill Override host field as botd.fpapi.io.

    4.3. Create a new host with the URL of the CDN - openfpcdn.io. Click modify the host, fill Name field as cdn, choose Yes, enable TLS and connect securely using port 443 setting, click Advanced options at the end of the page and fill Override host field as openfpcdn.io.

    4.4. Create a new host with the URL of the Rollbar - api.rollbar.com. Click modify the host, fill Name field as rollbar, choose Yes, enable TLS and connect securely using port 443 setting, click Advanced options at the end of the page and fill Override host field as api.rollbar.com.

  5. Download the botd-compute-edge-<version>.tar.gz package from the releases and upload it to the Package section.

  6. Go to the Dictionaries section, create a new botd_config dictionary.

    6.1. Add item token with authorization token obtained from FingerprintJS.

    6.2. [OPTIONAL] Add item disable with value true or false. If the value is true, middleware will pass all requests as is without calling botd.

    6.3. [OPTIONAL] Add item log_endpoint with logging endpoint name from Logging section.

    6.4. [OPTIONAL] Add item debug with value true or false. If the value is true, additional information will be logged to your log_endpoint.

  7. Activate integration.

  8. Test your app on the provided Domain with the given sample credentials.

Setting up with the source code

If you want to build and release integration from source code, follow the wiki guidelines.