jadb/honeypot

Project Honey Pot(非官方)PHP SDK

dev-master / 1.0.x-dev 2016-01-23 01:05 UTC

This package is auto-updated.

Last update: 2024-08-28 01:23:04 UTC


README

The Project Honey Pot's un-official PHP SDK.

使用这个库,您可以开始自动检测恶意访客(HttpBL)以及/或帮助阻止新的恶意访客(Quicklink)。

安装

composer require jadb/honeypot:1.0.x-dev

使用方法

HttpBL

要使用Http::BL API,您首先需要一个API密钥。如果您还没有,请前往注册(这是一个推荐链接)

一旦您有了它,您就可以这样做

<?php

if (!(new \Honeypot\HttpBL('your-api-key'))->isSafe('127.0.0.1') {
    exit('Unsafe visitor');
}

如果您想对规则有更多控制

<?php
/**
 * By default, strict mode is used. When not in strict mode, any pass is a pass. This ruleset
 * translates to: 5 days or older, or threat score lower than 2, or visitor type lower than 4.
 */
$strict = false; 
$age = 5; 
$score = 2;
$type = 4;
if (!(new \Honeypot\HttpBL('your-api-key'))->isSafe('127.0.0.1', $age, $score, $type) {
    exit('Unsafe visitor');
}

对于更多,您可以直接获取Address对象并创建自己的验证

<?php
$address = (new \Honeypot\HttpBL('your-api-key'))->address('127.0.0.1');

注意:出于测试目的,提供了虚拟数据

Quicklink

要使用quicklinks并帮助阻止新的恶意IP,您需要获取蜜罐的URL或托管自己的蜜罐

一旦完成,您可以通过以下方式创建多达8个不同的链接

<?php
// this will create 5 links
echo (new \Honeypot\Quicklink('http://link.to.honeypot.org/'))->render(5);

补丁和功能

  • 分支
  • 修改、修复
  • 测试 - 这很重要,所以它不会无意中损坏
  • 提交 - 不要修改许可证、todo、版本等。(如果您确实更改了任何内容,请将它们放入我可以在拉取时忽略的自己的提交中)
  • 拉取请求 - 主题分支的额外加分

为确保您的PR被考虑为上游,您必须遵循PSR2编码标准。

错误和反馈

http://github.com/jadb/honeypot/issues

许可证

版权(c)2015,Jad Bitar,并许可在MIT许可证下。