Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/repoog/PassPwned

API for querying big data of broken personal data
https://github.com/repoog/PassPwned

Last synced: 22 days ago
JSON representation

API for querying big data of broken personal data

Host: GitHub
URL: https://github.com/repoog/PassPwned
Owner: repoog
Created: 2016-07-19T04:12:09.000Z (over 8 years ago)
Default Branch: master
Last Pushed: 2019-05-27T11:23:25.000Z (over 5 years ago)
Last Synced: 2024-08-05T17:43:29.708Z (4 months ago)
Language: PHP
Homepage:
Size: 33.2 KB
Stars: 8
Watchers: 2
Forks: 1
Open Issues: 0
Metadata Files:
- Readme: README.md

Awesome Lists containing this project

awesome-hacking-lists - repoog/PassPwned - API for querying big data of broken personal data (PHP)

README

## 功能描述
PassPwned 是一个用于查询社工库的API接口，该接口基于MySQL数据库并使用PHP开发，接口包括：
* 查询社工库站点/数据量/接口调用统计；
* 查询基于关键词的站点信息；
* 查询基于关键词的数据详细信息；
接口根据参数自动识别参数类型进行查询，返回采用Json格式，用于同域站点下的接口调用和访问。

## 接口使用
/initialize.php
创建基础表结构。
/api/datainfo
获取表数量、总数据量及调用次数。
/api/leakaccount/?account=
根据account查询所有表命中情况，但不显示详细记录。
/api/socialdata/?account=
根据account查询所有表命中情况，并显示详细记录。

## 接口设计
PassPwned 基于MySQL数据库设计，采用统一的表前缀，表类型分为站点数据表和基础表。
其中site_index、site_item、api_call为默认基础表，表说明如下：
* site_index：站点信息及表信息索引表；
* site_item：站点数据表字段记录表；
* api_call：接口调用统计表；
接口实现依赖于基础表的构建，否则会造成接口查询错误。

## 接口配置
config.php 为接口配置文件，其中可配置的内容包括：
* 数据库连接信息
* 表前缀信息（默认为sod_）
* 基础表表名信息

## 设计思路
PassPwned 基于统一字段（即所有分表同类型字段字段名统一）和分表设计，并使用基础表作为索引查询依据，即查询时基于参数类型从基础表site_item中确认数据来源以及数据表名，继而查询同类型下所有数据表信息。

若有新数据源添加，仅需在导入数据后自定义分表表名，添加site_index记录并增加site_item记录说明字段是否存在即可（新的字段亦需增加表字段）。

## 基础表结构
在接口配置文件config.php配置之后，可使用`php -f initialize.php`创建以下基础表。

### sod_site_index


CREATE TABLE `sod_site_index` (

  s_id int(10) NOT NULL AUTO_INCREMENT PRIMARY KEY COMMENT '站点ID',

  table_name varchar(50) NOT NULL COMMENT '站点表名',

  site_name varchar(20) NOT NULL COMMENT '站点名称',

  site_url varchar(30) DEFAULT NULL COMMENT '站点链接',

  site_info varchar(100) DEFAULT NULL COMMENT '站点信息',

  data_amount bigint(15) NOT NULL DEFAULT '0' COMMENT '数据量'

)

### sod_site_item


CREATE TABLE `sod_site_item` (

  s_id int(10) NOT NULL COMMENT '站点ID',

  username_item tinyint(1) NOT NULL DEFAULT '0' COMMENT '用户名字段',

  password_item tinyint(1) NOT NULL DEFAULT '0' COMMENT '密文密码字段',

  email_item tinyint(1) NOT NULL DEFAULT '0' COMMENT '邮箱字段',

  salt_item tinyint(1) NOT NULL DEFAULT '0' COMMENT '盐值字段',

  ip_item tinyint(1) NOT NULL DEFAULT '0' COMMENT 'IP字段',

  question_item tinyint(1) NOT NULL DEFAULT '0' COMMENT '问题字段',

  answer_item tinyint(1) NOT NULL DEFAULT '0' COMMENT '回答字段',

  plainpass_item tinyint(1) NOT NULL DEFAULT '0' COMMENT '明文密码字段',

  mobile_item tinyint(1) NOT NULL DEFAULT '0' COMMENT '手机字段',

  realname_item tinyint(1) NOT NULL DEFAULT '0' COMMENT '真实姓名字段',

  sex_item tinyint(1) NOT NULL DEFAULT '0' COMMENT '性别字段',

  qq_item tinyint(1) NOT NULL DEFAULT '0' COMMENT 'QQ字段',

  birthday_item tinyint(1) NOT NULL DEFAULT '0' COMMENT '生日字段',

  idcard_item tinyint(1) NOT NULL DEFAULT '0' COMMENT '身份证字段',

  address_item tinyint(1) NOT NULL DEFAULT '0' COMMENT '住址字段',

  university_item tinyint(1) NOT NULL DEFAULT '0' COMMENT '大学字段',

  education_item tinyint(1) NOT NULL DEFAULT '0' COMMENT '学历字段',

  company_item tinyint(1) NOT NULL DEFAULT '0' COMMENT '公司字段',

  post_item tinyint(1) NOT NULL DEFAULT '0' COMMENT '职位字段',

  phone_item tinyint(1) NOT NULL DEFAULT '0' COMMENT '座机字段',

  account_item tinyint(1) NOT NULL DEFAULT '0' COMMENT '账户字段',

  nickname_item tinyint(1) NOT NULL DEFAULT '0' COMMENT '昵称字段'

)

### sod_api_call


CREATE TABLE `sod_api_call` (

  id int(10) unsigned NOT NULL AUTO_INCREMENT PRIMARY KEY,

  count bigint(10) NOT NULL

)