Struct GenericOAuth2Provider 

pub struct GenericOAuth2Provider { /* private fields */ }

通用 OAuth2 提供商 — 对齐 Laravel Socialite GenericProvider

接收 OAuth2Config 和 OAuth2HttpTransport，支持任意标准 OAuth2 提供商。

工作流程

1. GenericOAuth2Provider::redirect_url：构造授权 URL，引导用户跳转到授权服务器
2. 授权服务器回调，携带 code 和 state
3. GenericOAuth2Provider::user_from_token：
   • POST token_url 换取 access_token（grant_type=authorization_code）
   • 如果配置了 user_url，POST 用户信息端点获取用户资料
   • 返回 SocialiteUser

用法

use std::sync::Arc;
use sz_rust_auth_facade::oauth::{
    GenericOAuth2Provider, MemoryOAuth2HttpTransport, OAuth2Config, OAuth2Provider,
};

let config = OAuth2Config::new(
    "client_id",
    "client_secret",
    "https://example.com/callback",
    "https://provider.com/oauth2.0/authorize",
    "https://provider.com/oauth2.0/token",
)
.with_user_url("https://provider.com/user/info");

let transport = Arc::new(MemoryOAuth2HttpTransport::new());
let provider = GenericOAuth2Provider::new(config, transport);

let url = provider.redirect_url("random_state");
let user = provider.user_from_token("auth_code").unwrap();

Implementations

impl GenericOAuth2Provider

pub fn new( config: OAuth2Config, transport: Arc<dyn OAuth2HttpTransport>, ) -> GenericOAuth2Provider

创建通用 OAuth2 提供商

参数

• config: OAuth2 配置
• transport: HTTP 传输实现（业务方注入 reqwest / hyper / etc.）

pub fn with_audit_logger( self, logger: Arc<dyn OAuth2AuditLogger>, ) -> GenericOAuth2Provider

注入审计日志

pub fn refresh_token( &self, refresh_token: &str, ) -> Result<TokenResponse, OAuth2Error>

用 refresh_token 换取新的 access_token

POST token_url，body 为 JSON：

{
  "grant_type": "refresh_token",
  "refresh_token": "<refresh_token>",
  "client_id": "<client_id>",
  "client_secret": "<client_secret>"
}

impl GenericOAuth2Provider

pub fn redirect_url_with_pkce(&self, state: &str, pkce: &PkceParams) -> String

构造授权 URL（带 PKCE 参数）

当配置了 PKCE 参数时，授权 URL 追加 code_challenge 和 code_challenge_method=S256。

pub fn user_from_token_with_pkce( &self, code: &str, code_verifier: Option<&str>, ) -> Result<SocialiteUser, OAuth2Error>

用授权码换取用户信息（可选 PKCE code_verifier）

当 code_verifier 为 Some 时，token 交换 POST body 追加 code_verifier 字段。

Trait Implementations

impl OAuth2Provider for GenericOAuth2Provider

fn redirect_url(&self, state: &str) -> String

生成授权 URL（对齐 Socialite::driver('qq')->redirect()）

fn user_from_token(&self, code: &str) -> Result<SocialiteUser, OAuth2Error>

用授权码换取访问令牌并获取用户信息（对齐 Socialite::driver('qq')->user()）