{"id":15711005,"url":"https://github.com/cardi/auntietuna","last_synced_at":"2025-10-04T17:56:28.156Z","repository":{"id":110993129,"uuid":"56713664","full_name":"cardi/auntietuna","owner":"cardi","description":"AuntieTuna: Personalized Content-based Phishing Detection","archived":false,"fork":false,"pushed_at":"2020-03-10T04:55:17.000Z","size":738,"stargazers_count":4,"open_issues_count":1,"forks_count":2,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-08-23T17:43:22.561Z","etag":null,"topics":["antifraud","antiphish","antispam","brave-extension","google-chrome-extension","mozilla-firefox-addon","phishing"],"latest_commit_sha":null,"homepage":"https://auntietuna.ant.isi.edu","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cardi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-04-20T19:02:43.000Z","updated_at":"2024-12-24T10:02:04.000Z","dependencies_parsed_at":"2023-04-04T18:01:34.757Z","dependency_job_id":null,"html_url":"https://github.com/cardi/auntietuna","commit_stats":null,"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/cardi/auntietuna","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cardi%2Fauntietuna","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cardi%2Fauntietuna/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cardi%2Fauntietuna/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cardi%2Fauntietuna/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cardi","download_url":"https://codeload.github.com/cardi/auntietuna/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cardi%2Fauntietuna/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278350987,"owners_count":25972676,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-04T02:00:05.491Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["antifraud","antiphish","antispam","brave-extension","google-chrome-extension","mozilla-firefox-addon","phishing"],"created_at":"2024-10-03T21:11:08.659Z","updated_at":"2025-10-04T17:56:28.127Z","avatar_url":"https://github.com/cardi.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1\u003e\n\u003csub\u003e\n\u003cimg src=\"https://raw.githubusercontent.com/cardi/auntietuna/master/src/img/auntietuna-48.png\" width=\"38\" height=\"38\"\u003e\n\u003c/sub\u003e\nAuntieTuna\n\u003c/h1\u003e\n\n**AuntieTuna** is a browser extension that checks if each visited page\nis a potential phishing website based on snapshots of known good\nwebsites that a user adds.\n\nFor example, a user adds a snapshot of Bank of FooBar. The extension\nthen checks every other page the user visits to see if it looks like\nBank of FooBar–if it does, it's likely phish and blocked.\n\nA peer-reviewed, research paper describing the details and usability of\nAuntieTuna can be found online:\n\u003e Calvin Ardi and John Heidemann. **AuntieTuna: Personalized\n\u003e Content-Based Phishing Detection**. *Proceedings of the NDSS Workshop\n\u003e on Usable Security* (San Diego, California, USA, Feb. 2016).\n\u003e DOI: `10.14722/usec.2016.23012`.\n\u003e ([BibTeX](https://ant.isi.edu/bib/Ardi16a.html),\n\u003e [DOI](https://doi.org/10.14722/usec.2016.23012),\n\u003e [PDF](https://www.isi.edu/%7ejohnh/PAPERS/Ardi16a.pdf))\n\nAdditional information and a copy of this software and its source code\ncan also be found at \u003chttps://auntietuna.ant.isi.edu\u003e or\n\u003chttps://github.com/cardi/auntietuna\u003e.\n\n## quick start\n\nGet up and running with the\n[quick start guide](https://auntietuna.ant.isi.edu/documentation/quick-start).\n\n## installation\n\nYou can install the AuntieTuna browser extension for Mozilla Firefox\nand Chromium-based browsers (Chromium, Google Chrome, Brave).\n\nFind the instructions for your browser below.\n\n[Information about the requested permissions](https://auntietuna.ant.isi.edu/documentation/faq).\n\n### chromium / chromium-based browsers (chrome, brave)\n\n**General Installation**:\nInstall from the\n[Chrome Web Store](https://chrome.google.com/webstore/detail/auntietuna/alichgeikcnmpjhknildaacknjcoecfb).\n\n**Sideloading Instructions**:\n1. Clone the git repository or download and extract a release tarball\n2. Go to Extensions (Window -\u003e Extensions) or \"chrome://extensions\"\n3. Toggle \"Developer mode\" in the top right to \"On\"\n4. Click on \"Load unpacked\"\n5. Select the directory containing AuntieTuna and click \"Open\"\n\nAuntieTuna is now installed.\n\nNote that you need to update manually when new versions are released by\nrepeating the steps above.\n\n### firefox\n\n**General Installation**:\nGo to the [Latest Release](https://github.com/cardi/auntietuna/releases/latest)\npage and install the signed add-on (`auntietuna-0.0.x.x-fx.xpi`).\nIf you saved the `.xpi` file to your computer, you can\n[install the add-on from the file](https://extensionworkshop.com/documentation/publish/distribute-sideloading/#install-addon-from-file).\n\n**Temporary Installation**:\nTo install the latest development snapshot (temporarily) from git or a\n[release](https://github.com/cardi/auntietuna/releases/latest) (`.zip`\nor `.tar.gz`):\n1. Clone the git repository or download a release tarball\n2. In Firefox, go to `about:debugging#/runtime/this-firefox`\n3. Click on \"Load Temporary Add-on...\"\n4. Browse to and open `auntietuna/src/manifest.json`\n5. AuntieTuna is now temporarily installed until you exit the browser\n\nYou need to repeat these installation steps after you restart the\nbrowser. Known-good data is deleted on exit.\n\n### development (firefox)\n\nRunning the development version of AuntieTuna using\n[`run-firefox.sh`](./run-firefox.sh) (a wrapper around `web-ext`) will\nlaunch Firefox with a clean, temporary profile with AuntieTuna\npre-installed that is independent of existing profiles you may have.\n\nData is ***not saved*** after you close Firefox! (You can uncomment the\nline in [`run-firefox.sh`](./run-firefox.sh) containing\n`--keep-profile-changes` if you want a persistent profile.)\n\n1. Install Mozilla Firefox\n2. Install `web-ext`\n3. Clone this repository: `git clone https://github.com/cardi/auntietuna.git`\n4. (optional) In `run-firefox.sh`, modify the paths to `FIREFOX_BIN` and `FIREFOX_DIST`\n5. Execute `run-firefox.sh`\n\nYou can also build an unsigned `.xpi` by running `make` at the root of\nthe repository. The unsigned extension can be installed on Firefox\n[Nightly](https://www.mozilla.org/en-US/firefox/nightly/all/) or\n[Developer](https://www.mozilla.org/en-US/firefox/developer/).\n\n#### firefox nightly / developer edition\n\nIf you're running Firefox Nightly or Developer edition, you can install\nan unsigned extension by [disabling signature\nenforcement](https://wiki.mozilla.org/Add-ons/Extension_Signing#FAQ):\n\n1. type `about:config` into the URL bar in Firefox\n2. in the Search box type `xpinstall.signatures.required`\n3. double-click the preference, or right-click and selected \"Toggle\", to\n   set it to `false`.\n\nYou can now load an unsigned addon from a file.\n\n### development (chromium)\n\nRunning the development version of AuntieTuna using\n[`run-chrome.sh`](./run-chrome.sh) (a wrapper around `web-ext`) will\nlaunch Chromium with a clean, temporary profile with AuntieTuna\npre-installed that is independent of existing profiles you may have.\n\nData is ***not saved*** after you close Chromium!\n\n1. Install Chromium\n2. Install `web-ext`\n3. Clone this repository: `git clone https://github.com/cardi/auntietuna.git`\n4. (optional) In `run-chrome.sh`, modify the paths to `CHROMIUM_BIN`\n5. Execute `run-chrome.sh`\n\nThe latest git commit of AuntieTuna can also be installed manually by\nfollowing the \"[Sideloading Instructions](#chromium--chromium-based-browsers-chrome-brave)\".\n\n## usage\n\nOn a website you normally log in to, click on the AuntieTuna icon and\n\"Add to Good List\".\n\nThe extension now checks, behind the scenes, if every webpage you visit is\nsuspected to be phish. If it is, you'll receive an obvious alert.\n\n**NOTE**: Software is in ALPHA stage! There *might* be false positives\nand/or broken websites. Please send feedback to \u003ccalvin@isi.edu\u003e.\n\n## contributing\n\nContributions are welcome!\n\nWe generally need help with the following:\n* general usage of the addon on multiple browsers\n* finding/reporting false positives\n* [and more...](https://auntietuna.ant.isi.edu/documentation/developing/)\n\nFeel free to open a [pull request](https://github.com/cardi/auntietuna/pulls)\nor an [issue](https://github.com/cardi/auntietuna/issues), or send email\nto \u003ccalvin@isi.edu\u003e with questions, bugs, feature requests, patches, and\nany notes on your usage.\n\n## libraries used\n\n| name                                | link                                             | license        |\n| ---                                 | ---                                              | ---            |\n| CryptoJS                            | https://code.google.com/p/crypto-js              | `BSD-3-Clause` |\n| Dexie.js                            | https://github.com/dfahlander/Dexie.js/          | `Apache-2.0`   |\n| FileSaver                           | https://github.com/eligrey/FileSaver.js          | `MIT`          |\n| FontAwesome                         | https://github.com/FortAwesome/Font-Awesome      | `CC-BY-4.0`    |\n| WebExtension `browser` API Polyfill | https://github.com/mozilla/webextension-polyfill | `MPL-2.0`      |\n\n## copyright\n\nCopyright (C) 2016-2020  University of Southern California\n\nThis program is free software: you can redistribute it and/or modify\nit under the terms of the GNU General Public License as published by\nthe Free Software Foundation, either version 3 of the License, or\n(at your option) any later version.\n\nThis program is distributed in the hope that it will be useful,\nbut WITHOUT ANY WARRANTY; without even the implied warranty of\nMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\nGNU General Public License for more details.\n\nYou should have received a copy of the GNU General Public License\nalong with this program.  If not, see \u003chttps://www.gnu.org/licenses/\u003e.\n\n## license\n\n[`GPL-3.0-or-later`](./LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcardi%2Fauntietuna","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcardi%2Fauntietuna","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcardi%2Fauntietuna/lists"}