[{"_1":2,"_219":-5,"_220":-5},"loaderData",{"_3":4,"_13":14,"_20":21,"_189":190},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","routes/_layout",{"_15":-5,"_16":11,"_17":11,"_18":19},"username","isBillingDecouplingSeatCount","isSearchBoxExperimentEnabled","isAskGordonEnabled",true,"routes/_layout.r.$namespace.$reponame",{"_22":23,"_24":-5,"_25":11,"_26":11,"_27":28,"_29":30,"_31":-5,"_32":11,"_33":34,"_94":95,"_120":121,"_182":-5,"_183":11,"_184":11,"_185":11,"_186":-5,"_187":188},"canonicalUrl","https://hub.docker.com/r/acuvity/risk-auditor/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","acuvity","reponame","risk-auditor","cloudBuildSource","isAutobuildsAvailable","repo",{"_35":36,"_48":49,"_51":52,"_53":54,"_55":11,"_56":57,"_58":59,"_60":61,"_38":30,"_27":28,"_63":64,"_65":50,"_66":67,"_68":69,"_70":71,"_72":-5,"_73":67,"_74":75,"_76":11,"_77":78,"_79":80,"_85":11,"_86":87,"_91":28,"_92":93},"categories",[37,42,45],{"_38":39,"_40":41},"name","Networking","slug","networking",{"_38":43,"_40":44},"Security","security",{"_38":46,"_40":47},"Machine learning & AI","machine-learning-and-ai","content_types",[50],"image","date_registered","2025-08-13T16:52:46.532307Z","description","Acuvity Risk Assessment Tool","is_private","last_updated","2026-01-22T17:51:03.333285Z","last_modified","2025-10-28T18:37:04.495059Z","media_types",[62],"application/vnd.oci.image.index.v1+json","pull_count",1951,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","

\n \n \n $\"Acuvity$ \n \n \n

\n \n $\"Join$ \n \n\n $\"Follow$ \n \n\n $\"Follow$ \n \n

\n\n# 🔍 What is Acuvity Risk Auditor?\n\n**Description:** Comprehensive risk assessment tool for AI services with advanced reachability checks and security log processing\n\nPackaged by Acuvity for risk auditing in customer environments. Features automated browser testing, TLS certificate analysis, and security log processing capabilities.\n\n# 💡 Why We Built This\n\nAt [Acuvity](https://acuvity.ai), understanding AI service accessibility and security posture is critical for our mission. The Acuvity Risk Auditor addresses this need by providing comprehensive risk auditing with optional security log correlation for AI services across customer networks.\n\n# 📚 Quick reference\n\n**Maintained by**:\n - [the Acuvity team](mailto:support@acuvity.ai) for packaging and security\n\n**Where to get help**:\n - [Acuvity Support](mailto:support@acuvity.ai)\n\n**Supported host architectures**:\n - `amd64` - natively\n - `arm64` - via emulation with `--platform linux/amd64`, chrome browser which is required for advanced tests doesn't have build for arm64 linux\n\n**Current supported version:**\n - container: `latest`\n\n---\n\n# Table of Contents\n- [🚀 Quickstart](#-quickstart)\n- [🎯 Usage Modes](#-usage-modes)\n- [🐳 Run it with Docker](#-run-it-with-docker)\n - [Mount Structure](#mount-structure)\n - [⚙️ Command Line Options](#️-command-line-options)\n - [📋 Examples](#-examples)\n - [Acuvity Knowledge Base Scanning](#acuvity-knowledge-base-scanning)\n - [Direct Domain Scanning](#direct-domain-scanning)\n - [Security Log Processing](#security-log-processing)\n - [Custom CA Certificates](#custom-ca-certificates)\n - [🔧 Advanced Configuration](#-advanced-configuration)\n - [📁 Output Files](#-output-files)\n- [📝 Security Log Processing](#-security-log-processing)\n- [🔑 Environment Variables](#-environment-variables)\n\n---\n\n# 🚀 Quickstart\n\n> [!NOTE] \n> You can get your token on Acuvity console in Administration/Access/User Tokens.\n\n```bash\n# Set your Acuvity API token as environment variable first\nexport ACUVITY_TOKEN=\"your-token-here\"\n\n# Create directory structure\nmkdir -p ./data/{input,output,logs}\n\n# Optionally copy your security logs to input directory\ncp your_security_logs.csv ./data/input/\n\n# Run complete scan with security log processing and file output, leave out --security-log option if no logs are available\ndocker run --platform linux/amd64 --rm \\\n -v \"$(pwd)/data:/app/data\" \\\n -e ACUVITY_TOKEN \\\n acuvity/risk-auditor:latest \\\n --security-log /app/data/input/your_security_logs.csv \\\n --output-dir /app/data/output \\\n --log-file /app/data/logs/auditor.log\n```\n\nThis example will:\n- Scan domains from Acuvity's knowledge base + specified custom domains\n- Process your security logs for correlation\n- Save detailed results to `./data/output/`\n- Generate debug logs in `./data/logs/`\n\n# 🎯 Usage Modes\n\nThe auditor supports three main operational modes which can be combined together. Results are automatically uploaded to Acuvity platform.\n\n\n### Acuvity Knowledge Base Scanning\n\nScan domains from Acuvity's AI domains database.\n\n### Direct Domain Scanning\n\nScan specific domains on top of domains from Acuvity's database. Use `--domains` to specify which domains to test.\n> [!NOTE] \n> If the domain is not in Acuvity Knowledge Base, it will still be part of the audit report, but the security risk assessment will not be available.\n\n### Security Log Processing\n\nProcess security logs to correlate with AI domain usage. Supports CSV format with automatic URL extraction. Have to be combined with either direct domains or Acuvity Knowledge Base domains.\n\n\n# 🐳 Run it with Docker\n\n## Mount Structure\n\nThe container uses `/app/data` as the main data directory. Create the following local directory structure based on the features you want to use.\n\n```bash\nmkdir -p ./data/{input,output,logs,certs}\n```\n\n- `./data/input/` - Security log file\n- `./data/output/` - Scan results\n- `./data/logs/` - Application log files for debugging\n- `./data/certs/` - Custom CA certificates (PEM format) to install in container if needed\n\n\n## ⚙️ Command Line Options\n\nThe auditor supports the following key options:\n\n**Custom Domain Sources:**\n- `--domains domain1.com domain2.com` - Scan specific domains directly\n\n**Input/Output:**\n- `--output-dir /path/to/output` - Save results to directory (enables file persistence)\n- `--security-log /path/to/security.csv` - Process security log file for correlation\n\n\n**Testing Control:**\n- `--timeout 15` - Network timeout in seconds (default: 10)\n- `--skip-advanced-tests` - Disable browser-based testing\n\n**Logging:**\n- `--log-level DEBUG` - Set logging level (DEBUG, INFO, WARNING, ERROR)\n- `--log-file /path/to/auditor.log` - Save logs to file\n\n**Metadata:**\\\nIn metadata you can specify any number of key=value pairs:\n- `--metadata location=US team=QA`\n\n\n## 📋 Examples\n\n\n\n### Acuvity Knowledge Base Scanning\n\n```bash\n# Set your Acuvity API token as environment variable first\nexport ACUVITY_TOKEN=\"your-token-here\"\n\n# Acuvity Knowledge Base scan with console output (no mounts needed)\ndocker run --platform linux/amd64 --rm \\\n -e ACUVITY_TOKEN \\\n acuvity/risk-auditor:latest\n\n# Acuvity Knowledge Base scan with file output\nmkdir -p ./data/output\ndocker run --platform linux/amd64 --rm \\\n -v \"$(pwd)/data:/app/data\" \\\n -e ACUVITY_TOKEN \\\n acuvity/risk-auditor:latest \\\n --output-dir /app/data/output\n```\n\n### Direct Domain Scanning\n\n```bash\n# Set your Acuvity API token as environment variable first\nexport ACUVITY_TOKEN=\"your-token-here\"\ndocker run --platform linux/amd64 --rm \\\n -e ACUVITY_TOKEN \\\n acuvity/risk-auditor:latest \\\n --domains chatgpt.com openai.com anthropic.com\n\n\n# Scan with file output and logging\nexport ACUVITY_TOKEN=\"your-token-here\"\nmkdir -p ./data/{output,logs}\ndocker run --platform linux/amd64 --rm \\\n -v \"$(pwd)/data:/app/data\" \\\n -e ACUVITY_TOKEN \\\n acuvity/risk-auditor:latest \\\n --domains chatgpt.com openai.com anthropic.com \\\n --output-dir /app/data/output \\\n --log-file /app/data/logs/auditor.log\n\n```\n\n### Security Log Processing\n\n```bash\n# Prepare security log file\nmkdir -p ./data/input\ncp your_security_logs.csv ./data/input/\n\n# Process security logs with Acuvity Knowledge Base domains (set token first)\nexport ACUVITY_TOKEN=\"your-token-here\"\nmkdir -p ./data/{input,output}\ndocker run --platform linux/amd64 --rm \\\n -v \"$(pwd)/data:/app/data\" \\\n -e ACUVITY_TOKEN \\\n acuvity/risk-auditor:latest \\\n --security-log /app/data/input/your_security_logs.csv \\\n --output-dir /app/data/output\n\n# Process security logs with specific domains\nexport ACUVITY_TOKEN=\"your-token-here\"\ndocker run --platform linux/amd64 --rm \\\n -v \"$(pwd)/data:/app/data\" \\\n -e ACUVITY_TOKEN \\\n acuvity/risk-auditor:latest \\\n --security-log /app/data/input/your_security_logs.csv \\\n --domains chatgpt.com openai.com anthropic.com \\\n --output-dir /app/data/output \\\n\n```\n\n### Custom CA Certificates\n\n```bash\n# Copy CA certificates to local certs directory\ncp /path/to/your/ca-certificates/*.pem ./data/certs/\n\n# Run with custom CA certificates\nexport ACUVITY_TOKEN=\"your-token-here\"\ndocker run --platform linux/amd64 --rm \\\n -v \"$(pwd)/data:/app/data\" \\\n -e ACUVITY_TOKEN \\\n acuvity/risk-auditor:latest \\\n --domains internal-domain.com \\\n --output-dir /app/data/output\n\n```\n\n## 🔧 Advanced Configuration\n\n### Custom CA Certificate Support\n\nFor environments with custom certificate authorities, place PEM files in `./data/certs/` and the auditor will automatically install them in the container.\n\n## 📁 Output Files\n\nThe auditor generates the following output files in the specified output directory:\n\n- `results_.json`: Main scan results in JSON format\n- `payload_.json`: API payload format results\n\n# 📝 Security Log Processing\n\n## Supported Log Formats\n\nThe auditor can process security logs in various CSV formats:\n\n- **Flexible Column Detection**: Automatically tries to detect timestamp, URL, and user columns \n- **Best-effort URL Extraction**: Uses regex patterns to find URLs in any text content\n- **Subdomain Matching**: Automatically matches subdomains to parent domains\n\nWhile some common header names can be automatically detected, for best results the log header names should be set to `timestamp`, `username` and `destination_url` for the URL the user was trying to reach. The log can contain any additional columns which will be ignored.\n\n## URL Matching Logic\n\nExamples of subdomain matching:\n- `https://files01.api.chatgpt.com/uploads` matches domain: `chatgpt.com`\n- `https://api.openai.com/v1/chat` matches domain: `openai.com`\n- `https://claude.ai/chat` matches domain: `claude.ai`\n\n## Sample Security Log Format\n\n```csv\ntimestamp,source_ip,destination_url,username,action\n2024-01-15T10:30:00Z,192.168.1.100,https://chatgpt.com/chat,john.doe,ALLOW\n2024-01-15T10:31:00Z,192.168.1.101,https://api.openai.com/v1/completions,jane.smith,ALLOW\n```\n\n# 🔑 Environment Variables\n\n**Required for Acuvity Knowledge Base scanning and uploads**:\n- `ACUVITY_TOKEN`: Bearer authentication token (required)\n- `ACUVITY_BASE_URL`: API base URL - override option, by default it is extracted from token\n- `ACUVITY_NAMESPACE`: Namespace header value - override option, by default it is extracted from token","has_starred","hub_user","chrisacuvity","immutable_tags_settings",{"_81":11,"_82":83},"enabled","rules",[84],".*","is_automated","permissions",{"_88":19,"_89":11,"_90":11},"read","write","admin","user","storage_size",5975416359,"orgData",{"_96":97,"_98":99,"_100":101,"_102":28,"_103":104,"_105":106,"_107":108,"_109":110,"_111":112,"_113":114,"_115":116,"_117":118,"_119":19},"id","136563be7dbc49ddbe7cce2b16d857a2","uuid","136563be-7dbc-49dd-be7c-ce2b16d857a2","type","organization","orgname","full_name","Acuvity","location","Sunnyvale ","company","Acuvity Inc.","profile_url","https://www.acuvity.ai","date_joined","2023-09-07T21:24:49.932756Z","gravatar_url","https://www.gravatar.com/avatar/a8486cbfb368141655f23b5009df016f?s=80&r=g&d=mm","gravatar_email","","badge","verified_publisher","is_active","recentTags",[122,166],{"_123":50,"_124":125,"_126":127,"_128":129,"_96":130,"_131":132,"_56":154,"_155":125,"_156":28,"_157":62,"_38":158,"_159":160,"_161":162,"_163":154,"_164":71,"_165":19},"content_type","creator",23105788,"digest","sha256:6c9de0517896e60480e47ff439903650dec78df5a6517b9fa8e817e842364467","full_size",569611479,953636661,"images",[133,148],{"_134":135,"_126":136,"_137":116,"_138":139,"_140":141,"_142":143,"_144":116,"_145":-5,"_146":129,"_68":71,"_147":-5},"architecture","amd64","sha256:97189cd6e9bdb2014d0b214966ae5096d7f33b6dc62268e6bf7b2a2447d1c185","features","last_pulled","2026-07-14T20:18:00.48635517Z","last_pushed","2026-01-22T17:51:00.403613315Z","os","linux","os_features","os_version","size","variant",{"_134":149,"_126":150,"_137":116,"_138":151,"_140":152,"_142":149,"_144":116,"_145":-5,"_146":153,"_68":71,"_147":-5},"unknown","sha256:c8a0a2f141c107c7432252e2d1709f761650294fee4da2bbec7c9460275ae827","2026-07-14T16:40:53.277742594Z","2026-01-22T17:51:00.399082714Z",1190,"2026-01-22T17:51:02.134858Z","last_updater","last_updater_username","media_type","latest","repository",28288754,"tag_last_pulled","2026-07-15T00:36:21.121574493Z","tag_last_pushed","tag_status","v2",{"_123":50,"_124":125,"_126":167,"_128":168,"_96":169,"_131":170,"_56":180,"_155":125,"_156":28,"_157":62,"_38":181,"_159":160,"_161":173,"_163":180,"_164":71,"_165":19},"sha256:bb0e5c40a858d405a97a68d7b5f6a9225ee10afc737a61c5f456722f0e2455f4",569137379,975122209,[171,175],{"_134":135,"_126":172,"_137":116,"_138":173,"_140":174,"_142":143,"_144":116,"_145":-5,"_146":168,"_68":71,"_147":-5},"sha256:d8033ebd4f8ce9b0a630bd553d11151ad5488ecd625515c8dce76e805d4c743e","2026-07-14T14:11:17.707888663Z","2025-09-18T17:48:17.755398596Z",{"_134":149,"_126":176,"_137":116,"_138":177,"_140":178,"_142":149,"_144":116,"_145":-5,"_146":179,"_68":71,"_147":-5},"sha256:36ad51f009c2d81992ab836083a16e977f7f4edbc799e5e9f4ac653c325a87f6","2026-07-14T14:11:17.707750078Z","2025-09-18T17:48:17.731547458Z",1189,"2025-09-18T17:48:18.992323Z","test","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"routes/_layout.r.$namespace.$reponame.tags",{"_33":191,"_201":202,"_187":217,"_218":11},{"_35":192,"_48":196,"_51":52,"_53":54,"_55":11,"_56":57,"_58":59,"_60":197,"_38":30,"_27":28,"_63":64,"_65":50,"_66":67,"_68":69,"_70":71,"_72":-5,"_73":67,"_74":75,"_76":11,"_77":78,"_79":198,"_85":11,"_86":200,"_91":28,"_92":93},[193,194,195],{"_38":39,"_40":41},{"_38":43,"_40":44},{"_38":46,"_40":47},[50],[62],{"_81":11,"_82":199},[84],{"_88":19,"_89":11,"_90":11},"tags",{"_203":204,"_205":-5,"_206":-5,"_207":208},"count",2,"next","previous","results",[209,213],{"_123":50,"_124":125,"_126":127,"_128":129,"_96":130,"_131":210,"_56":154,"_155":125,"_156":28,"_157":62,"_38":158,"_159":160,"_161":162,"_163":154,"_164":71,"_165":19},[211,212],{"_134":135,"_126":136,"_137":116,"_138":139,"_140":141,"_142":143,"_144":116,"_145":-5,"_146":129,"_68":71,"_147":-5},{"_134":149,"_126":150,"_137":116,"_138":151,"_140":152,"_142":149,"_144":116,"_145":-5,"_146":153,"_68":71,"_147":-5},{"_123":50,"_124":125,"_126":167,"_128":168,"_96":169,"_131":214,"_56":180,"_155":125,"_156":28,"_157":62,"_38":181,"_159":160,"_161":173,"_163":180,"_164":71,"_165":19},[215,216],{"_134":135,"_126":172,"_137":116,"_138":173,"_140":174,"_142":143,"_144":116,"_145":-5,"_146":168,"_68":71,"_147":-5},{"_134":149,"_126":176,"_137":116,"_138":177,"_140":178,"_142":149,"_144":116,"_145":-5,"_146":179,"_68":71,"_147":-5},[],"canDeleteTags","actionData","errors"]

acuvity/risk-auditor

Tags for acuvity/risk-auditor