{"id":31698820,"url":"https://github.com/paulobiao/securebank","last_synced_at":"2026-04-20T19:03:05.198Z","repository":{"id":318227081,"uuid":"1070262649","full_name":"paulobiao/SecureBank","owner":"paulobiao","description":"Open-source financial threat detection (FastAPI, Python).","archived":false,"fork":false,"pushed_at":"2025-10-05T23:10:17.000Z","size":7,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-05T23:40:22.563Z","etag":null,"topics":["ban","cybersecurity","docker","eb2niw","fastapi","fintech","fraud-detection","open-source","python"],"latest_commit_sha":null,"homepage":"","language":"Python","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/paulobiao.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":"docs/roadmap.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-10-05T15:40:15.000Z","updated_at":"2025-10-05T23:10:20.000Z","dependencies_parsed_at":"2025-10-05T23:40:32.247Z","dependency_job_id":"fc88511c-cb1c-42ef-ae55-3d674dd73ce1","html_url":"https://github.com/paulobiao/SecureBank","commit_stats":null,"previous_names":["paulobiao/securebank"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/paulobiao/SecureBank","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paulobiao%2FSecureBank","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paulobiao%2FSecureBank/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paulobiao%2FSecureBank/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paulobiao%2FSecureBank/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/paulobiao","download_url":"https://codeload.github.com/paulobiao/SecureBank/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paulobiao%2FSecureBank/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279000701,"owners_count":26082805,"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-08T02:00:06.501Z","response_time":56,"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":["ban","cybersecurity","docker","eb2niw","fastapi","fintech","fraud-detection","open-source","python"],"created_at":"2025-10-08T19:11:01.625Z","updated_at":"2026-04-20T19:03:05.190Z","avatar_url":"https://github.com/paulobiao.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# SecureBank – Financially-Aware Zero-Trust Threat Detection Framework\n\n![License](https://img.shields.io/badge/License-MIT-green.svg)\n![Python](https://img.shields.io/badge/Python-3.10%2B-blue.svg)\n![FastAPI](https://img.shields.io/badge/FastAPI-ready-success.svg)\n![Docker](https://img.shields.io/badge/Docker-supported-2496ED.svg)\n![Open Source](https://img.shields.io/badge/Open--Source-Yes-brightgreen.svg)\n\nSecureBank is an open-source cybersecurity research and engineering framework demonstrating a financially-aware zero-trust architecture for banking systems.\n\nThis repository serves as **public research evidence**, **open-source contribution**, and a **simulation platform** for academic and industry use.\n\n---\n## 🚀 Gemini 3 Hackathon – SecureBank Copilot\n\nThis repository powers **SecureBank Copilot**, an AI-driven decision-support system created for the **Gemini 3 Hackathon**.\n\nThe project demonstrates how generative AI can translate cyber incidents into **quantified financial loss, regulatory exposure, and executive decision paths** — before real damage occurs.\n\n### 🎥 Live Demo\nhttps://youtu.be/lFNKE2sfnkI\n\n### 🌐 Live Project\nhttps://www.biaotech.dev/securebank-copilot\n\n## \u001f 📄 Academic Publication (Preprint)\n\n**SecureBank**: A Financially-Aware Zero-Trust Architecture for High-Assurance Banking Systems\n\n- **DOI:** [https://doi.org/10.5281/zenodo.18071268](https://doi.org/10.5281/zenodo.18071268)\n- **Version:** v1.0\n- **Author:** Paulo Fernandes Biao\n- **Indexed in:** OpenAIRE (Zenodo)\n\nThis repository contains the **companion implementation and simulation artifacts** supporting the publication.\n\n---\n\n## \u001f 🎯 Objective\n\nDetect suspicious financial activity and identity abuse in **simulated banking and fintech environments**:\n\n- Real-time risk evaluation via secure APIs\n- Explainable scoring with explicit reason codes\n- Quantitative validation through Monte Carlo simulation\n- Architecture suitable for academic review and expert evaluation\n\n---\n\n## \u001f ✨ Key Features\n\n- FastAPI-based secu re transaction scoring API\n- Rule-based threat detection:\n  - Velocity anomalies\n  - Geo-IP changes\n  - Device mismatches\n  - High-risk transaction patterns\n  - Threat intelligence blocklists\n- Explainable output (score + reasons + flags)\n- Batch CSV evaluation for offline analysis\n- Reproducible Monte Carlo simulation module\n- Dockerized execution environment\n- MIT open-source license\n\n---\n## 🧪 Scientific Validation\n\nThe SecureBank™ framework is supported by a full Monte Carlo–based\nstatistical validation module, including hypothesis testing,\neffect size analysis, and publication-ready visualizations.\n\nSee: `sim/securebank-sim/README.md`\n\n---\n\n## \u001f 🏗️ System Architecture\n\n```mermaid\nflowchart LR\n    A[\"Client / Ingest\"] --\u003e|/api/v1/score| B[\"FastAPI Application\"]\n    B --\u003e C[\"Rule Engine (rules.py)\"]\n    B --\u003e D[\"Threat Intelligence (Blocklists)\"]\n    B --\u003e E[\"Data Storage (CSV / SQLite)\"]\n    B --\u003e F[\"Monitoring (Prometheus / Grafana - optional)\"]\n```\n\n---\n\n## \u001f 🚀 Quick Start\n\n### Using Docker (recommended)\n\n```bash\ndocker compose up --build\n```\n\nAPI available at: [http://localhost:8000/docs](http://localhost:8000/docs)\n\n---\n\n### Local Execution (Python 3.10+)\n\n```bash\npython -m venv .venv\nsource .venv/bin/activate\npip install -r requirements.txt\nuvicorn securebank.main:app --reload --port 8000\n```\n\n---\n\n##   📡 API Example\n\n```bash\ncurl -X POST http://localhost:8000/api/v1/score -H \"Content-Type: application/json\" -d '{\n  \"user_id\": \"dev001\",\n  \"amount\": 999.99,\n  \"merchant\": \"ELC\",\n  \"ip\": \"198.51.100.20\",\n  \"device_id\": \"dev001\"\n}'\n```\n---\n\n##   Response:\n\n```json\n{\n  \"score\": 80,\n  \"reasons\": [\"High amount\", \"Suspicious IP range\"],\n  \"flags\": { \"high_risk\": true }\n}\n```\n\n---\n\n## \u001f 🧪 Tests\n\nRun tests with:\n\n```bash\npytest -q\n```\n\n---\n\n## \u001f 📁 Project Structure\n\n```\nsrc/\n  securebank/\n    main.py\n    rules.py\n    models.py\n    utils.py\ntests/\n  test_rules.py\ndata/\n  sample_transactions.csv\n  threat_intel_blocklist.txt\nsim/\n  securebank-sim/\ndocs/\n  roadmap.md\n.github/workflows/\nDockerfile\ndocker-compose.yml\nrequirements.txt\nLICENSE\nREADME.md\n```\n\n---\n\n## \u001f 🔬 Simulation Module (Research Validation)\n\n```bash\ncd sim/securebank-sim\npython runner.py\n```\n\n---\n\n## \u001f 🧩 EB2-NIW / EB1 Relevance\n\nThis project demonstrates:\n\n- **National Importance:** financial system resilience and fraud detection\n- **Well Positioned:** secure APIs, detection logic, CI, documentation\n- **On Balance:** open-source contribution enabling adoption and reuse\n\n---\n\n##  📜 License\n\nMIT License\n\n---\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpaulobiao%2Fsecurebank","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpaulobiao%2Fsecurebank","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpaulobiao%2Fsecurebank/lists"}