{"id":19167231,"url":"https://github.com/fingerprintjs/fingerprint-pro-akamai-proxy-integration","last_synced_at":"2026-04-02T14:03:04.922Z","repository":{"id":206988235,"uuid":"706090796","full_name":"fingerprintjs/fingerprint-pro-akamai-proxy-integration","owner":"fingerprintjs","description":"Fingerprint Pro Akamai Integration is responsible for proxying identification and JavaScript agent download requests that are performed on your Akamai infrastructure.","archived":false,"fork":false,"pushed_at":"2026-03-26T10:48:37.000Z","size":405,"stargazers_count":15,"open_issues_count":0,"forks_count":1,"subscribers_count":9,"default_branch":"main","last_synced_at":"2026-03-28T15:58:04.686Z","etag":null,"topics":["akamai","akamai-property","bot","bot-detection","botd","browser","browser-fingerprinting","detection","fingerprint","fingerprintjs","fingerprintjs-pro","terraform","visitor-identifier"],"latest_commit_sha":null,"homepage":"https://dev.fingerprint.com/docs/akamai-proxy-integration","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fingerprintjs.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-10-17T09:34:44.000Z","updated_at":"2026-03-26T10:48:39.000Z","dependencies_parsed_at":"2024-04-05T10:30:39.479Z","dependency_job_id":"d828409b-b791-43dd-adb7-ed6ea30323af","html_url":"https://github.com/fingerprintjs/fingerprint-pro-akamai-proxy-integration","commit_stats":null,"previous_names":["fingerprintjs/fingerprint-pro-akamai-proxy-integration"],"tags_count":15,"template":false,"template_full_name":null,"purl":"pkg:github/fingerprintjs/fingerprint-pro-akamai-proxy-integration","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fingerprintjs%2Ffingerprint-pro-akamai-proxy-integration","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fingerprintjs%2Ffingerprint-pro-akamai-proxy-integration/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fingerprintjs%2Ffingerprint-pro-akamai-proxy-integration/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fingerprintjs%2Ffingerprint-pro-akamai-proxy-integration/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fingerprintjs","download_url":"https://codeload.github.com/fingerprintjs/fingerprint-pro-akamai-proxy-integration/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fingerprintjs%2Ffingerprint-pro-akamai-proxy-integration/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31307465,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-02T12:59:32.332Z","status":"ssl_error","status_checked_at":"2026-04-02T12:54:48.875Z","response_time":89,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["akamai","akamai-property","bot","bot-detection","botd","browser","browser-fingerprinting","detection","fingerprint","fingerprintjs","fingerprintjs-pro","terraform","visitor-identifier"],"created_at":"2024-11-09T09:36:25.891Z","updated_at":"2026-04-02T14:03:04.914Z","avatar_url":"https://github.com/fingerprintjs.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://fingerprint.com\"\u003e\n    \u003cpicture\u003e\n        \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://fingerprintjs.github.io/home/resources/logo_light.svg\" /\u003e\n        \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"https://fingerprintjs.github.io/home/resources/logo_dark.svg\" /\u003e\n        \u003cimg src=\"https://fingerprintjs.github.io/home/resources/logo_dark.svg\" alt=\"Fingerprint logo\" width=\"312px\" /\u003e\n   \u003c/picture\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n\u003ca href=\"https://github.com/fingerprintjs/fingerprint-pro-akamai-proxy-integration\"\u003e\u003cimg src=\"https://img.shields.io/github/v/release/fingerprintjs/fingerprint-pro-akamai-proxy-integration\" alt=\"Current version\"\u003e\u003c/a\u003e\n\u003ca href=\"https://opensource.org/licenses/MIT\"\u003e\u003cimg src=\"https://img.shields.io/:license-mit-blue.svg\" alt=\"MIT license\"\u003e\u003c/a\u003e\n\u003ca href=\"https://discord.gg/39EpE2neBg\"\u003e\u003cimg src=\"https://img.shields.io/discord/852099967190433792?style=logo\u0026label=Discord\u0026logo=Discord\u0026logoColor=white\" alt=\"Discord server\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n# Fingerprint Pro Akamai Proxy Integration\n\n[Fingerprint](https://fingerprint.com) is a device intelligence platform offering industry-leading accuracy.\n\nFingerprint Akamai Proxy Integration is responsible for proxying identification and agent-download requests between your website and Fingerprint through your Akamai infrastructure. The integration consists of a set of property rules you need to add to your Akamai property configuration. The property rules template is available in this repository.\n\n## 🚧 Requirements and expectations\n\n* **Limited to Enterprise plan**:   The Akamai Proxy Integration is accessible and exclusively supported for customers on the **Enterprise** Plan. Other customers are encouraged to use [Custom subdomain setup](https://dev.fingerprint.com/docs/custom-subdomain-setup) or [Cloudflare Proxy Integration](https://dev.fingerprint.com/docs/cloudflare-integration).\n\n* **Manual updates occasionally required**: The underlying data contract in the identification logic can change to keep up with browser updates. Using the Akamai Proxy Integration might require occasional manual updates on your side. Ignoring these updates will lead to lower accuracy or service disruption.\n\n## How to install with Terraform\n\n\u003e [!NOTE]\n\u003e This section assumes you use Terraform to manage your site infrastructure on Akamai and that your site uses the `latest` Akamai rule format.\n\u003e * If you do not use Terraform, see  [How to install without Terraform](#how-to-install-using-akamai-property-manager-api-without-terraform).\n\u003e * If your Akamai property uses a different rule format, please contact our [support team](https://fingerprint.com/support/).\n\n\nThis is a quick overview of the installation setup. For detailed step-by-step instructions, see the [Akamai proxy integration guide in our documentation](https://dev.fingerprint.com/docs/akamai-proxy-integration).\n\n1. Go to Fingerprint **Dashboard** \u003e [**API Keys**](https://dashboard.fingerprint.com/api-keys) and click **Create Proxy Key** to create a proxy secret. You will use it later to authenticate your requests to Fingerprint APIs. \n2. Add the following variable blocks to the Akamai property [Rules template](https://techdocs.akamai.com/terraform/docs/pm-ds-rules-template) in your Terraform configuration file. If you are using a plain JSON file instead of a rules template, reach out to our [support team](https://fingerprint.com/support/).\n\n    ```tf\n    # main.tf\n    data \"akamai_property_rules_template\" \"rules\" {\n          # Assuming this is property's rules file\n          template_file = \"/rules/main.json\" \n          variables {\n            name  = \"fpjs_integration_path\"\n            value = \"YOUR_INTEGRATION_PATH_HERE\" # any random string that's a valid URL\n            type = \"string\"\n          }\n          variables {\n            name  = \"fpjs_agent_path\"\n            value = \"YOUR_AGENT_PATH_HERE\" # any random string that's a valid URL\n            type = \"string\"\n          }\n          variables {\n            name  = \"fpjs_result_path\"\n            value = \"YOUR_RESULT_PATH_HERE\" # any random string that's a valid URL\n            type = \"string\"\n          }\n          variables {\n            name  = \"fpjs_proxy_secret\"\n            value = \"YOUR_PROXY_SECRET_HERE\" # Use the proxy secret from the previous step\n            type = \"string\"\n          }\n    }\n    ```\n\n3. Go to this repository [latest releases](https://github.com/fingerprintjs/fingerprint-pro-akamai-integration-property-rules/releases/latest) and download these two JSON files:\n   * `terraform/fingerprint-property-rules.json`\n   * `terraform/fingerprint-property-variables.json`\n4. Add the files to the `rules` directory of your Terraform project.\n5. Reference the files inside your `rules/main.json` file:\n\n    ```json5\n    // rules/main.json\n    {\n      \"rules\": {\n        \"name\": \"default\",\n        \"behaviors\": [\n          // ...\n        ],\n        \"children\": [\n          //...\n          // Add the downloaded rules file as a child\n          \"#include:fingerprint-property-rules.json\" \n        ],\n        // Add the downloaded variables file (or merge it with existing variables file)\n        \"variables\": \"#include:fingerprint-property-variables.json\"\n        // ...\n      }\n    }\n    ```\n\n6. Run `terraform plan` to review your changes and `terraform apply` to deploy them.\n7. Configure the Fingerprint [JS Agent](https://dev.fingerprint.com/docs/js-agent) on your website using the paths defined in Step 2.\n\n    ```javascript\n    import * as FingerprintJS from '@fingerprintjs/fingerprintjs-pro'\n    \n    const fpPromise = FingerprintJS.load({\n      apiKey: 'PUBLIC_API_KEY',\n      scriptUrlPattern: [\n        'https://yourwebsite.com/YOUR_INTEGRATION_PATH_HERE/YOUR_AGENT_PATH_HERE?apiKey=\u003capiKey\u003e\u0026version=\u003cversion\u003e\u0026loaderVersion=\u003cloaderVersion\u003e',\n        FingerprintJS.defaultScriptUrlPattern, // Fallback to default CDN in case of error\n      ],\n      endpoint: \n        'https://yourwebsite.com/YOUR_INTEGRATION_PATH_HERE/YOUR_RESULT_PATH_HERE?region=us',\n        FingerprintJS.defaultEndpoint // Fallback to default endpoint in case of error\n      ],\n    });\n    ```\n\nSee the [Akamai proxy integration guide](https://dev.fingerprint.com/docs/deploy-akamai-proxy-integration-via-terraform#step-3-add-variable-blocks-to-your-rules-template) in our documentation for more details. \n\n### Building property rules for Terraform locally\n\nIf you prefer, you can clone this repository and build the property rules and variables locally.\n\n1. Run `pnpm install`.\n2. Run `pnpm build --type terraform`. It will generate the following files you can use in your Terraform configuration as described above.\n\n  - `dist/terraform/json/fingerprint.json`\n  - `dist/terraform/json/variables.json`\n  - `dist/terraform/example.tf`\n\nThe JSON files are equivalent to the JSON files available in the [latest releases](https://github.com/fingerprintjs/fingerprint-pro-akamai-integration-property-rules/releases/latest).\n\n## How to install using Akamai Property Manager API (without Terraform)\n\nYou can clone this repository and build the property rules locally into a single `body.json` file. You can then apply them as a patch update to your property configuration using Akamai [Property Manager API](https://techdocs.akamai.com/property-mgr/reference/api). This allows you to install the integration in an automated way even if you do not use Terraform.\n\n\n1. Run `pnpm install`.\n2. Run `pnpm build --type patchBody --integration-path YOUR_INTEGRATION_PATH_HERE --agent-path YOUR_AGENT_PATH_HERE --result-path YOUR_RESULT_PATH_HERE --proxy-secret YOUR_PROXY_SECRET_HERE`.\n   * Use the same values you would use in [Step 2](#how-to-install-with-terraform) if you were installing with Terraform.\n   * The command generates a `dist/patch-body/body.json` file. This file includes all rules and property variables necessary for the integration.\n3. Use the [Patch a property's rule tree](https://techdocs.akamai.com/property-mgr/reference/patch-property-version-rules) endpoint of the Akamai Property Manager API to apply the generated JSON to your Akamai property.\n\nFor detailed instructions please see the [Deploy Akamai Integration using Property Manager API](https://dev.fingerprint.com/docs/deploy-akamai-proxy-integration-via-papi) documentation.\n  \nIf you have any questions, reach out to our [support team](https://fingerprint.com/support). \n\n## License\n\nThis project is licensed under the MIT license. See the [LICENSE](https://github.com/fingerprintjs/fingerprint-pro-akamai-integration-property-rules/blob/main/LICENSE) file for more info.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffingerprintjs%2Ffingerprint-pro-akamai-proxy-integration","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffingerprintjs%2Ffingerprint-pro-akamai-proxy-integration","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffingerprintjs%2Ffingerprint-pro-akamai-proxy-integration/lists"}