README

用于在 Laravel 中实现类似 Slack 风格的“神奇认证”链接的包

设置

通过 composer 安装此包

$ composer require montopolis/laravel-magic-auth

添加服务提供者

在 config/app.php 中的 providers 数组...

    /*
     * Application Service Providers...
     */
    App\Providers\AppServiceProvider::class,
    App\Providers\AuthServiceProvider::class,
    App\Providers\EventServiceProvider::class,
    App\Providers\RouteServiceProvider::class,

    /*
     * Third-party Service Providers...
     */
    Montopolis\MagicAuth\Providers\ServiceProvider::class,

发布（并更新）配置

$ php artisan vendor:publish
$ vi config/montopolis_magic_auth.php

API

创建令牌

使用此端点触发为用户创建一个 OTP。用户将通过预选的通道（参见 montopolis_magic_auth.php）收到密码、神奇认证链接或两者（也请参阅配置）的通知。

POST magic-auth/create
{
    "email": "johnny@depp.com",
    "_token": "ABCDEFghijklmnOPQRStuvwxyz1234567890"
}

200 OK
{
    "message": {
        "email": "johnny@depp.com"
    }
}

验证令牌

用户收到并转发 OTP 后，您可以使用此端点尝试进行身份验证

POST magic-auth/verify
{
    "email": "johnny@depp.com",
    "_token": "ABCDEFghijklmnOPQRStuvwxyz1234567890",
    "key": "12345"
}

301 Redirect

注意：在此端点发布后，Laravel 会话将被认证（如果成功）。

神奇链接

用户还可以这样重定向，以自动登录

GET magic-auth/login?email=johnny@depp.com&_token=ABCDEFghijklmnOPQRStuvwxyz1234567890&key=12345

301 Redirect

许可证

Laravel Magic Auth 是开源软件，许可协议为 MIT 许可证。

montopolis / laravel-magic-auth

维护者

详细信息