README

这是一个用于添加双因素认证的Composer模块。

内容

• 快速入门
• 安装
  • 手动注册
• 配置
  • 环境变量
  • 配置文件
• 定制
• 开发

快速入门

1. composer require stickee/laravel-2fa
2. php artisan migrate

双因素认证现在已启用，但未强制。要为所有用户强制启用，请将以下设置在您的 .env 文件中： LARAVEL_2FA_REQUIRED=true

用户登录时将被提示注册双因素认证。

安装

composer require stickee/laravel-2fa

此模块包含一个Laravel服务提供器，它将自动注册到Laravel 5.5及以上版本中。

手动注册

可以通过在config/app.php中的providers数组中添加以下内容来手动注册该模块：

Stickee\Laravel2fa\ServiceProvider::class,

配置

环境变量

配置文件

使用以下命令将配置文件发布到您的项目中

php artisan vendor:publish --provider=Stickee\\Laravel2fa\\ServiceProvider --tag=config

定制

该软件包高度可定制 - 如果需要，大多数部分都可以替换为您自己的实现。

我该如何...？

• 更改模板
  • 使用php artisan vendor:publish --provider=Stickee\\Laravel2fa\\ServiceProvider --tag=laravel-views将视图发布到您的项目中，并在那里进行编辑。
• 定制文本/添加翻译
  • 使用php artisan vendor:publish --provider=Stickee\\Laravel2fa\\ServiceProvider --tag=translations将翻译发布到您的项目中，并在那里进行编辑。
• 更改二维码生成器
  • 要更改为内置的BaconQrCode后端之一，请更改配置变量qr_code_generator。编写本文时，支持的后端包括：\BaconQrCode\Renderer\Image\ImagickImageBackEnd::class \BaconQrCode\Renderer\Image\SvgImageBackEnd::class \BaconQrCode\Renderer\Image\EpsImageBackEnd::class
  • 要使用完全不同的东西，创建一个实现\Stickee\Laravel2fa\Contracts\QrCodeGenerator的类，并在您的服务提供器中将它绑定到该接口
• 创建自定义驱动程序/提供者
  • 实现\Stickee\Laravel2fa\Contracts\Driver并在您的laravel-2fa.drivers配置中注册它。为了简化，您可能需要扩展\Stickee\Laravel2fa\Drivers\AbstractDriver。

开发

更改的最简单方法是，将导入模块的项目设置为从文件系统而不是从Composer仓库加载模块，如下所示

1. composer remove stickee/laravel-2fa
2. 编辑composer.json并添加

   "repositories": [
           {
               "type": "path",
               "url": "../laravel-2fa"
           }
       ]
   

   其中../laravel-2fa是您已签出此项目的路径
3. composer require stickee/laravel-2fa

注意：不要以这种方式将composer.json提交到版本控制中！