uspdev/senhaunica-socialite

Laravel Socialite 的 Senhaunica OAuth1 提供程序

4.3.12 2024-06-06 20:31 UTC

README

这是一个库,允许您将 Laravel 应用程序与 USP 的集中式身份验证(使用单个密码)集成。

除了与身份验证服务器通信外,它还提供以下附加功能:

  • 执行应用程序登录和注销所需的路由和控制器;
  • 为应用程序提供五级授权(权限)系统;
  • 一个 /loginas 路由,允许您假定其他人的身份;
  • 应用程序用户管理界面,允许您添加、删除和分配权限;

注意:如果不想使用这些附加功能,可以将其禁用。

关于使用此库的视频

PHP 依赖项,除了 Laravel 默认依赖项之外

php-curl

历史记录

3/2023: 版本 4.4

  • 在 guard web 中管理应用程序权限(默认)
  • 将默认的 debug 设置为 true
  • senhaunica 命名空间中创建用户的权限链接
  • (https://youtu.be/1NMLnMuJP1c)
  • 如果发布,需要更新 .env/.env.example 并调整 config

安装

composer require uspdev/senhaunica-socialite

基本配置 - 新安装

发布并运行迁移

迁移会修改 users 表并创建授权表。

php artisan vendor:publish --provider="Uspdev\SenhaunicaSocialite\SenhaunicaServiceProvider" --tag="migrations"
php artisan vendor:publish --provider="Spatie\Permission\PermissionServiceProvider"
php artisan migrate

声明 User 模型的 trait

App/Models/User.php 中,在 User 类内包含以下行

class User extends Authenticatable
{
use \Spatie\Permission\Traits\HasRoles;
use \Uspdev\SenhaunicaSocialite\Traits\HasSenhaunica;
...

注册 callback_id

URL 是在 APP_URL 中注册的,加上 /callback,例如:https://:8000/callback

在应用程序的 .env.env.example 中设置变量

# SENHAUNICA-SOCIALITE ######################################
# https://github.com/uspdev/senhaunica-socialite

# Credenciais/informações do oauth
SENHAUNICA_KEY=fflch_sti
SENHAUNICA_SECRET=sua_super_chave_segura
SENHAUNICA_CALLBACK_ID=85

# URL do servidor oauth no ambiente de dev (default=no)
#SENHAUNICA_DEV="https://dev.uspdigital.usp.br/wsusuario/oauth"

# URL do servidor oauth para uso com senhaunica-faker
#SENHAUNICA_DEV="http://127.0.0.1:3141/wsusuario/oauth"

# Desabilite para não salvar o retorno do oauth em storage/app/debug/oauth/ (default=true)
#SENHAUNICA_DEBUG=

# AS CONFIGURAÇÕES A SEGUIR são relevantes se permission=true

# Esses usuários terão privilégios especiais
#SENHAUNICA_ADMINS=11111,22222,33333
#SENHAUNICA_GERENTES=4444,5555,6666

# Se os logins forem limitados a usuários cadastrados (onlyLocalUsers=true),
# pode ser útil cadastrá-los aqui.
#SENHAUNICA_USERS=777,888

# Se true, os privilégios especiais serão revogados ao remover da lista (default=false)
#SENHAUNICA_DROP_PERMISSIONS=

# Código da unidade para identificar os logins próprios ou de outras unidades
SENHAUNICA_CODIGO_UNIDADE=

应用程序的权限和功能

从版本 2 更新

配置文件

开发者信息