astrbot_plugin_imagestudio/core/media_proxy.py

102 行
3.4 KiB
Python

"""Signed media URL helpers."""
from __future__ import annotations
import base64
import hashlib
import hmac
import json
import mimetypes
import os
import time
from pathlib import Path
from typing import Any
from backend.dto.common import ApiError, ErrorCode
from core.storage import VfsStorage
DEFAULT_MEDIA_TTL_SECONDS = 300
MEDIA_FETCH_PATH = "/api/v1/plugins/extensions/astrbot_plugin_imagestudio/media/fetch"
class MediaProxy:
def __init__(
self,
storage: VfsStorage | None = None,
*,
signing_secret: str | None = None,
ttl_seconds: int = DEFAULT_MEDIA_TTL_SECONDS,
):
self.storage = storage or VfsStorage()
self.signing_secret = signing_secret or os.environ.get(
"IMAGESTUDIO_MEDIA_SIGNING_SECRET",
"imagestudio-dev-media-signing-secret",
)
self.ttl_seconds = ttl_seconds
def sign(self, uri: str) -> dict[str, Any]:
path = self.storage.ensure_file(uri)
expires_at = int(time.time()) + self.ttl_seconds
payload = {"uri": uri, "expires_at": expires_at}
token = self._encode(payload)
return {
"uri": uri,
"token": token,
"expires_at": expires_at,
"url": f"{MEDIA_FETCH_PATH}?token={token}",
"content_type": _guess_content_type(path),
"size_bytes": path.stat().st_size,
}
def fetch_metadata(self, token: str) -> dict[str, Any]:
payload = self._decode(token)
uri = str(payload.get("uri") or "")
expires_at = int(payload.get("expires_at") or 0)
if int(time.time()) > expires_at:
raise ApiError(ErrorCode.FORBIDDEN, "media token expired", {"expires_at": expires_at})
path = self.storage.ensure_file(uri)
return {
"uri": uri,
"expires_at": expires_at,
"content_type": _guess_content_type(path),
"size_bytes": path.stat().st_size,
}
def _encode(self, payload: dict[str, Any]) -> str:
payload_bytes = json.dumps(payload, separators=(",", ":"), sort_keys=True).encode("utf-8")
payload_part = _b64encode(payload_bytes)
signature = hmac.new(
self.signing_secret.encode("utf-8"),
payload_part.encode("ascii"),
hashlib.sha256,
).digest()
return f"{payload_part}.{_b64encode(signature)}"
def _decode(self, token: str) -> dict[str, Any]:
try:
payload_part, signature_part = token.split(".", 1)
except ValueError as exc:
raise ApiError(ErrorCode.FORBIDDEN, "invalid media token") from exc
expected = hmac.new(
self.signing_secret.encode("utf-8"),
payload_part.encode("ascii"),
hashlib.sha256,
).digest()
actual = _b64decode(signature_part)
if not hmac.compare_digest(expected, actual):
raise ApiError(ErrorCode.FORBIDDEN, "invalid media token signature")
return json.loads(_b64decode(payload_part).decode("utf-8"))
def _guess_content_type(path: Path) -> str:
return mimetypes.guess_type(path.name)[0] or "application/octet-stream"
def _b64encode(value: bytes) -> str:
return base64.urlsafe_b64encode(value).decode("ascii").rstrip("=")
def _b64decode(value: str) -> bytes:
padding = "=" * (-len(value) % 4)
return base64.urlsafe_b64decode(value + padding)