Skip to main content

passport-gooyoit (Python)

接入 Passport Gooyoit SSO 的 Python 客户端 SDK,封装 OAuth 2.0 授权码流程与 RBAC 权限校验。

安装

uv add passport-gooyoit            # 纯客户端
uv add "passport-gooyoit[fastapi]" # 带 FastAPI 集成

快速开始(纯客户端)

from passport_gooyoit import PassportClient

passport = PassportClient(
    api_base_url="https://api.gooyoit.com:8443",  # Passport API
    login_url="https://passport.gooyoit.com",     # 登录页
    client_id="YOUR_CLIENT_ID",
    client_secret="YOUR_CLIENT_SECRET",           # 仅限服务端使用,勿放前端
)

# 1. 生成跳转 URL(state 自动生成,请存入 session 以便回调时校验)
url, state = passport.authorization_url(
    redirect_uri="https://app.example.com/auth/callback",
    application_name="My App",
)

# 2. 回调处理:校验 state,用 code 换 token(一次拿到 user + roles + permissions)
token = passport.exchange_code(code, redirect_uri="https://app.example.com/auth/callback")

# 3. 任意时刻实时查询用户身份与权限
info = passport.get_userinfo(token.access_token)

# 4. 刷新 / 登出
token = passport.refresh(token.refresh_token)
passport.logout(token.refresh_token)

FastAPI 集成

from fastapi import Depends, FastAPI
from passport_gooyoit import PassportClient
from passport_gooyoit.fastapi import PassportAuth
from passport_gooyoit.types import UserInfoResponse

passport = PassportClient(api_base_url=..., login_url=..., client_id=..., client_secret=...)
auth = PassportAuth(passport, cache_ttl=60)  # token→userinfo 缓存 60s

app = FastAPI()

@app.get("/me")
def me(user: UserInfoResponse = Depends(auth.current_user)):
    return user

@app.get("/articles")
def list_articles(user=Depends(auth.require_permission("user.read"))):
    return [...]  # 无权限自动 403

@app.get("/admin")
def admin(user=Depends(auth.require_role("admin"))):
    return {...}

require_permission / require_role 可传多个 code(AND 语义,须全部满足);依赖解析链路为 Bearer token → /oauth/userinfo(带 TTL 缓存)→ 401/403。

API 概览

方法 说明
authorization_url(redirect_uri, state=None, application_name=None) (url, state), automatically generates a cryptographically secure state if not provided
verify_state(expected, received) Constant-time state validation (CSRF protection)
exchange_code(code, redirect_uri) TokenResponse (includes user/roles/permissions)
refresh(refresh_token) TokenResponse
get_userinfo(access_token) UserInfoResponse, permissions calculated in real time
logout(refresh_token=None) Revoke refresh_token. Note: Revoking the Passport SSO session ("global logout") requires the browser-side SSO cookie; direct the user's browser to the Passport logout page to implement it

错误处理

from passport_gooyoit import PassportAuthError, PassportUnavailableError

try:
    token = passport.exchange_code(code, redirect_uri)
except PassportAuthError as exc:             # 400/401/403(业务性拒绝)
    logger.warning("passport rejected: %s (%s)", exc.detail, exc.status_code)
except PassportUnavailableError as exc:      # 网络故障 / 超时,Passport 不可达
    logger.error("passport unreachable: %s", exc)

开发

cd sdks/python
uv sync --extra dev
uv run pytest

Tests are entirely based on respx mocks and do not depend on a real Passport service.

Metadata

Release files for passport-gooyoit 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for passport-gooyoit 0.1.0
File Size Uploaded Provenance Actions
passport_gooyoit-0.1.0.tar.gz 35.1 kB Without provenance Details for passport_gooyoit-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for passport-gooyoit 0.1.0
File Interpreter ABI Platform Actions
passport_gooyoit-0.1.0-py3-none-any.whl Python 3 none any Details for passport_gooyoit-0.1.0-py3-none-any.whl

Total release size: 42.8 kB

Release files / passport_gooyoit-0.1.0.tar.gz

Download URL passport_gooyoit-0.1.0.tar.gz
Size 35.1 kB
Tags Source
SHA-256 checksum
How to use checksums
cd4138554583d3d31a84f3b8170565e685b3d4a16197ef103b29f25f999bfedf
BLAKE2b-256 checksum
How to use checksums
47f545985734c85d37b5fba824fccb6f1e5195f4680173323a2c1c9a0c1bfc34
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.11 {"installer":{"name":"uv","version":"0.9.11"},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / passport_gooyoit-0.1.0-py3-none-any.whl

Download URL passport_gooyoit-0.1.0-py3-none-any.whl
Size 7.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
952ff6c69cc93b9756af508f00c3eff1bb98c63cd474f93cb3a6175aecd3b881
BLAKE2b-256 checksum
How to use checksums
47408e7038383bad246405c30cf3d24e405459d773ac3cf8f36dce175f8ef498
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.11 {"installer":{"name":"uv","version":"0.9.11"},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Security for passport-gooyoit 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page