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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.