README

这是一个 Laravel 5 包，让您轻松与 Google 安全浏览 API 进行接口交互。（其他 RBL 服务即将到来。）

目前它只使用Google 安全浏览查找 API（v4），但我将更新它以包括更新 API。此脚本的旧版安全浏览 v3（非包）版本也包含 Phishtank 和几个 RBL，但我认为 RBL 已经改变了它们的工作方式，因此旧代码不再工作。

此包要求您拥有有效的 Google 安全浏览 API 密钥。没有密钥它绝对无法工作。 创建 API 密钥是免费的（尽管这个过程与您从 Google 预期的同样复杂和曲折）。

请注意，Google 会限制 API 使用，所以如果您有一个流量高的网站，您可能需要构建一个缓存层或类似的东西，这样您就不会很快耗尽您的请求。您可以通过Google API 控制台来监控您的使用情况。

此包边缘非常粗糙，可能还不能用于生产。

安装

通过 Composer

$ composer require snipe/safebrowsing

更新您的配置

对于使用 Laravel < 5.4 的应用程序

打开 config/app.php 并将以下内容添加到您的 providers 数组中：

Snipe\Safebrowsing\SafebrowsingServiceProvider::class,

to your providers array in config/app.php，以及

'Safebrowsing' => Snipe\Safebrowsing\Facade\Safebrowsing::class,

to your aliases array in config/app.php。

发布配置

php artisan vendor:publish

设置您的 Google 安全浏览 API 密钥

在您的 .env 文件中添加以下内容：

GOOGLE_API_KEY=YOUR-ACTUAL-API-KEY

配置文件中有一些附加选项，与您想检查的具体威胁类型以及您想检查的平台相关，但除非您想检查更少的事情，否则您不必担心，因为它已经非常全面了。

用法

使用 Blade 语法

{{ Safebrowsing::checkSafeBrowsing($urls) }}

或

@if (Safebrowsing::isFlagged('http://twitter.com/'))
    // do something if the url is flagged as suspicious
@else
    // hooray - it's not flagged!
@endif

其中 $url 是您希望与 Google 安全浏览 API 进行检查的 URL 数组。

使用门面

Safebrowsing::addCheckUrls(['http://ianfette.org']);
Safebrowsing::addCheckUrls(['http://malware.testing.google.test/testing/malware/']);
Safebrowsing::execute();
print('Status of the third URL is: '.Safebrowsing::isFlagged('http://twitter.com/'));

测试 URL

以下是一些您在实验系统时可以使用的实用测试 URL。

• http://www.yahoo.com/（正常）
• http://www.google.com/（正常）
• http://malware.testing.google.test/testing/malware/（恶意软件）
• http://twitter.com/（正常）
• http://ianfette.org（恶意软件）
• https://github.com/（正常）

变更日志

请参阅CHANGELOG了解最近更改的详细信息。

测试

从包中测试

`../../../vendor/bin/phpunit`

贡献

请参阅CONTRIBUTING和CONDUCT了解详细信息。

安全

如果您发现任何安全问题，请通过电子邮件snipe@snipe.net而不是使用问题跟踪器。

鸣谢

• A. Gianotto
• 所有贡献者

许可

GNU通用公共许可证。请参阅许可文件以获取更多信息。