raiffeisen-elba

🏦 安全自动的网银数据管家

基于 Playwright 与 PushTAN 双因素认证,安全自动化获取 Raiffeisen 银行账户余额、持仓及交易明细,实现财务数据自动同步管理。

收藏
1.8k
安装
805
版本
v1.3.3
CLS 安全性认证2026-05-19
点击查看完整报告 >

使用说明

Raiffeisen ELBA Banking Automation 是一款专为奥地利 Raiffeisen 银行用户设计的网银自动化工具,通过 Playwright 浏览器自动化技术,实现账户余额、证券持仓及交易记录的程序化获取。

核心用法
该技能通过命令行接口提供完整的银行会话管理。用户首先通过环境变量或配置文件设置银行凭据(RAIFFEISEN_ELBA_ID 与 RAIFFEISEN_ELBA_PIN),随后执行 login 命令触发自动化流程。系统会启动浏览器实例访问 Raiffeisen 官方登录页面,在用户手机上触发 pushTAN 双因素认证,用户确认后即可建立安全会话。接着可通过 accounts 获取所有关联账户列表,transactions 配合 IBAN 与日期范围参数下载特定账户的交易明细,最后必须通过 logout 命令清理浏览器会话与本地存储的认证状态,确保无残留敏感数据。

显著优点
安全性设计突出:采用银行级 pushTAN 2FA 认证机制,每次登录需用户在移动设备上主动批准;凭据管理规范,支持环境变量注入且配置文件强制 600 权限;路径安全控制严格,所有文件操作限制在工作区与 /tmp 目录,防止路径遍历攻击;会话管理完善,明确的登出流程清除 Playwright 配置文件与本地存储;输出格式标准化,直接生成 JSON 格式数据便于后续财务分析或记账软件集成。

潜在缺点
来源可信度受限,托管于 GitHub 个人开发者账号(T3 级),缺乏组织背书;银行绑定单一,仅支持 Raiffeisen ELBA 系统,通用性有限;环境依赖较重,需安装 Playwright 浏览器驱动及 Python 运行时;移动设备依赖,必须使用 pushTAN 应用,无法纯自动化运行;潜在合规风险,自动化访问可能违反银行服务条款。

适合群体
主要面向熟悉命令行操作的技术型个人用户,特别是需要定期导出银行数据进行财务分析、自动记账或投资跟踪的 Raiffeisen 客户。适合具备基础 Python 环境配置能力,且能够评估第三方工具风险的用户。不适用于企业级财务集成或寻求官方 API 支持的场景。

使用风险
需警惕凭据泄露风险,尽管有权限控制,但银行登录信息存储于本地仍存在潜在暴露可能;银行服务条款风险,自动化登录可能被视为违规操作导致账户限制;依赖项安全风险,Playwright 与 requests 库需保持更新以防范供应链攻击;会话残留风险,若异常中断未执行 logout,可能导致认证状态短暂留存于磁盘。

安全解读

核心功能与用法

Raiffeisen ELBA Banking Automation 是一款专为奥地利 Raiffeisen 银行用户设计的自动化工具,通过 Playwright 浏览器自动化技术模拟人工操作,实现网银数据的程序化获取。

核心命令流程

login → accounts → transactions → portfolio → logout

支持的功能包括:

  • 登录/登出管理:建立和清理浏览器会话,强制登出可最小化持久化认证状态
  • 账户查询:获取所有关联账户的余额信息
  • 交易记录导出:按日期范围筛选特定 IBAN 的交易明细
  • 投资组合查询:获取证券 depot 持仓数据

所有数据以 JSON 格式输出,便于后续自动化处理。

显著优点

1. 官方 API 直连:所有网络请求仅针对 raiffeisen.at 官方域名,HTTPS/TLS 1.2+ 加密传输
2. 凭证管理规范:支持环境变量与配置文件双模式,配置目录权限 700、文件权限 600

3. 依赖安全可靠:核心依赖 requests 和 Playwright 均为知名开源库,无已知 CVE

4. 输出路径受限:文件写入严格限制在工作区或 /tmp 目录

5. 透明可审计:代码开源,功能与声明完全一致

潜在局限与风险

| 风险项 | 级别 | 说明 |
|--------|------|------|
| 遗留 .env 文件支持 | Low | 虽已标记 deprecated,但仍存在代码中,误提交可能泄露凭证 |
| 浏览器自动化依赖 | Low | 依赖 Playwright 和 Chromium,需关注上游安全更新 |
| Token 提取方式 | Info | 通过 JavaScript 注入从 localStorage 提取 Bearer Token,仅限官方域名 |
| 子进程调用 | Info | 自动安装浏览器时调用 subprocess,参数硬编码 |

适合人群

  • 奥地利 Raiffeisen 银行个人/企业用户
  • 需要自动化财务数据整合的开发者
  • 希望将银行数据导入自研记账系统的技术用户

使用建议

1. 优先使用环境变量 (RAIFFEISEN_ELBA_ID, RAIFFEISEN_ELBA_PIN) 而非配置文件
2. 确保 .env 文件(如使用)已加入 .gitignore

3. 始终执行完整流程,最后调用 logout 清理会话

4. 定期检查 Playwright 安全更新

5. 不建议在生产服务器直接运行,建议在隔离环境使用

raiffeisen-elba 内容

references文件夹
scripts文件夹
手动下载zip · 35.7 kB
accounts.schema.jsonapplication/json
请选择文件