"""One-use grants create lease-scoped preview access, never a workbench login.""" import asyncio import hashlib import hmac import json import re import secrets import threading import time from http.cookies import SimpleCookie from pathlib import Path from urllib.parse import parse_qs from starlette.responses import JSONResponse,Response from src.modules.skill.domain.models import SkillError ASSETS=Path(__file__).parent SITE=ASSETS.parents[1]/'src/apps/workbench/preview_site' NONCE=re.compile(r'[a-f0-9]{64}') LEASE=re.compile(r'/preview-site/([a-f0-9]{32})(/api(?:/.*)?)') class PreviewBridge: def __init__(self,engine,*,clock=time.monotonic,capacity=128): self.engine,self.clock,self.capacity=engine,clock,capacity self.lock=threading.Lock();self.tickets={};self.used={};self.access={} @staticmethod def cookie(scope,name): cookies=SimpleCookie();cookies.load(dict(scope['headers']).get(b'cookie',b'').decode()) value=cookies.get(name) return value.value if value else '' def session(self,scope): token=self.cookie(scope,'zk_session') actor,csrf,_=self.engine.identity.session(token) return actor,csrf,token @staticmethod def patch_runtime(data): text=data.decode('utf-8');old="const previewWindow=window.open(url,'_blank');";stage="let state=await api('/api/preview',{kind,reference});" if text.count(old)!=1 or text.count(stage)!=1:raise RuntimeError('SPACE_PREVIEW_ADAPTER_MISMATCH') text="import {openPreview} from '/space/preview-parent.js';\n"+text.replace(old,'const bridge=openPreview(url,{kind,reference});let previewWindow=bridge.window;') return text.replace(stage,'await bridge.ready;previewWindow=bridge.window;'+stage).encode() def prune(self): now=self.clock() self.tickets={k:v for k,v in self.tickets.items() if v['expires']>now} self.used={k:v for k,v in self.used.items() if v['expires']>now} self.access={k:v for k,v in self.access.items() if v['expires']>now} def source(self,actor,kind,reference): return self.engine.evidence(actor,kind,reference)[2]['manifest']['source']['source_digest'] def checked_nonce(self,data): nonce=data.get('nonce') if not isinstance(nonce,str) or not NONCE.fullmatch(nonce):raise SkillError('INVALID_INPUT','打开请求不完整。',422) return hashlib.sha256(nonce.encode()).hexdigest() def authorize(self,scope,data): actor,csrf,token=self.session(scope) if not hmac.compare_digest(dict(scope['headers']).get(b'x-csrf-token',b'').decode(),csrf):raise SkillError('CSRF_DENIED','请刷新工作台后重试。',403) key=self.checked_nonce(data);proof=data.get('proof') if proof is not None and (not isinstance(proof,str) or not NONCE.fullmatch(proof)):raise SkillError('INVALID_INPUT','打开请求不完整。',422) if data.get('lease'): state=self.engine.preview_state(actor,data['lease']);kind,reference=state['kind'],state['reference'] else:kind,reference=data.get('kind'),data.get('reference') if kind not in {'run','example','skill'} or not isinstance(reference,str) or not re.fullmatch(r'[A-Za-z0-9_-]{1,128}',reference):raise SkillError('INVALID_INPUT','打开请求不完整。',422) source=self.source(actor,kind,reference) with self.lock: self.prune() if key in self.used:raise SkillError('PREVIEW_HANDOFF_USED','打开请求已使用。',409) proof_hash=hashlib.sha256(proof.encode()).hexdigest() if proof else None old=self.tickets.get(key) if old and (old['token'],old['kind'],old['reference'],old['proof_hash'])!=(token,kind,reference,proof_hash):raise SkillError('PREVIEW_HANDOFF_CONFLICT','打开请求不符。',409) if not old: if len(self.tickets)+len(self.used)+len(self.access)>=self.capacity:raise SkillError('PREVIEW_HANDOFF_CAPACITY','打开请求较多,请稍后重试。',429) self.tickets[key]={'token':token,'owner':actor.user_id,'kind':kind,'reference':reference,'source':source,'proof_hash':proof_hash,'expires':self.clock()+60} return JSONResponse({'authorized':True,'scope':'single-preview-only'}) def status(self,scope,data): actor,csrf,_=self.session(scope) if not hmac.compare_digest(dict(scope['headers']).get(b'x-csrf-token',b'').decode(),csrf):raise SkillError('CSRF_DENIED','请刷新工作台。',403) key=self.checked_nonce(data) with self.lock: self.prune();item=self.used.get(key) or self.tickets.get(key) if not item or item['owner']!=actor.user_id:raise SkillError('PREVIEW_NOT_FOUND','打开请求不可访问。',404) return JSONResponse({'consumed':key in self.used}) def consume(self,data): key=self.checked_nonce(data);proof=data.get('proof') if not isinstance(proof,str) or not NONCE.fullmatch(proof):raise SkillError('INVALID_INPUT','打开请求不完整。',422) with self.lock: self.prune() if key in self.used:raise SkillError('PREVIEW_HANDOFF_USED','打开请求已使用。',409) item=self.tickets.get(key) if not item:return JSONResponse({'pending':True},status_code=202) if item['proof_hash'] and not hmac.compare_digest(item['proof_hash'],hashlib.sha256(proof.encode()).hexdigest()):raise SkillError('PREVIEW_HANDOFF_PROOF','请从原窗口打开。',403) actor,_,_=self.engine.identity.session(item['token']) if self.source(actor,item['kind'],item['reference'])!=item['source']:raise SkillError('SOURCE_DIGEST_MISMATCH','制品版本已变化。',409) state=self.engine.start_preview(actor,item['kind'],item['reference']) self.tickets.pop(key);self.used[key]={'owner':item['owner'],'expires':self.clock()+60} access=secrets.token_urlsafe(32);self.access[hashlib.sha256(access.encode()).hexdigest()]={**item,'lease':state['id'],'csrf':secrets.token_urlsafe(32),'expires':self.clock()+900} response=JSONResponse({'authenticated':True,'lease':state['id'],'scope':'single-preview-only'}) response.set_cookie('zk_preview',access,max_age=900,path='/preview-site/'+state['id']+'/',httponly=True,secure=True,samesite='none') response.headers['set-cookie']+='; Partitioned' return response async def read_json(self,receive,limit=2048): raw=bytearray() while True: message=await receive() if message['type']!='http.request':raise SkillError('INVALID_INPUT','请求中断。',400) raw.extend(message.get('body',b'')) if len(raw)>limit:raise SkillError('PAYLOAD_TOO_LARGE','请求过大。',413) if not message.get('more_body'):break data=json.loads(raw) if not isinstance(data,dict):raise ValueError() return data async def scoped(self,scope,receive,send,match): lease,path=match.groups();method=scope['method'] with self.lock: self.prune();item=self.access.get(hashlib.sha256(self.cookie(scope,'zk_preview').encode()).hexdigest()) if not item or item['lease']!=lease:raise SkillError('PREVIEW_NOT_FOUND','请从对应工程打开应用。',401) actor,master_csrf,_=self.engine.identity.session(item['token']) if self.source(actor,item['kind'],item['reference'])!=item['source']:raise SkillError('SOURCE_DIGEST_MISMATCH','制品版本已变化。',409) if method not in {'GET','HEAD'} and not hmac.compare_digest(dict(scope['headers']).get(b'x-csrf-token',b'').decode(),item['csrf']):raise SkillError('CSRF_DENIED','应用请求来源不符。',403) if path=='/api/session' and method=='GET': await JSONResponse({'authenticated':True,'csrf':item['csrf'],'actor':{'user_id':actor.user_id},'scope':'single-preview-only'},headers={'Cache-Control':'no-store','Referrer-Policy':'no-referrer','X-Content-Type-Options':'nosniff'})(scope,receive,send);return allowed={('GET','/api/preview'),('GET','/api/preview/pdf-sample'),('POST','/api/preview/request'),('POST','/api/preview/client'),('DELETE','/api/preview')} if (method,path) not in allowed:raise SkillError('PREVIEW_ROUTE_DENIED','此凭证只允许当前应用预览。',403) query=parse_qs(scope['query_string'].decode(),keep_blank_values=True) if set(query)-{'preview_id'} or query.get('preview_id',[lease])!=[lease]:raise SkillError('PREVIEW_NOT_FOUND','预览不符。',404) data=await self.read_json(receive,190000) if method=='POST' else None if data is not None and data.get('preview_id',lease)!=lease:raise SkillError('PREVIEW_NOT_FOUND','预览不符。',404) if data is not None:data['preview_id']=lease headers=[(k,v) for k,v in scope['headers'] if k not in {b'host',b'origin',b'cookie',b'x-csrf-token',b'content-length'}] headers.extend([(b'host',self.internal_host.encode()),(b'origin',self.internal.encode()),(b'cookie',('zk_session='+item['token']).encode()),(b'x-csrf-token',master_csrf.encode())]) body=json.dumps(data).encode() if data is not None else b'';headers.append((b'content-length',str(len(body)).encode()));sent=False async def replay(): nonlocal sent if not sent:sent=True;return {'type':'http.request','body':body,'more_body':False} return await receive() inner={**scope,'path':path,'raw_path':path.encode(),'query_string':('preview_id='+lease).encode(),'headers':headers,'scheme':'http','server':('127.0.0.1',self.internal_port)} await self.app(inner,replay,send) async def handle(self,scope,receive,send): path,method=scope['path'],scope['method'];response=None try: match=LEASE.fullmatch(path) if match: await self.scoped(scope,receive,send,match);return True if method=='GET' and path in {'/space/preview-parent.js','/space/preview-bridge.js'}: response=Response((ASSETS/path.rsplit('/',1)[1]).read_bytes(),media_type='text/javascript') elif method=='GET' and path in {'/preview-launch/','/preview-site/'}: query=parse_qs(scope['query_string'].decode(),keep_blank_values=True) name='index.html' if path=='/preview-site/' and set(query)=={'lease'} else None response=Response((SITE/'index.html').read_bytes() if name else (ASSETS/'preview-bridge.html').read_bytes(),media_type='text/html') elif method=='GET' and path in {'/preview-site/site.js','/preview-site/site.css','/preview-site/lifecycle.js'}: content=(SITE/path.rsplit('/',1)[1]).read_bytes() if path.endswith('/site.js'): text=content.decode().replace("'/api/session'","SCOPED_API+'session'").replace("'/api/preview","SCOPED_API+'preview") content=("const SCOPED_API='/preview-site/'+new URLSearchParams(location.search).get('lease')+'/api/';\n"+text).encode() response=Response(content,media_type='text/javascript' if path.endswith('.js') else 'text/css') elif method=='POST' and path in {'/space/preview-authorize','/space/preview-login','/space/preview-status'}: data=await self.read_json(receive) if path.endswith('authorize'):response=await asyncio.to_thread(self.authorize,scope,data) elif path.endswith('status'):response=self.status(scope,data) else:response=await asyncio.to_thread(self.consume,data) except (ValueError,UnicodeError):response=JSONResponse({'code':'INVALID_INPUT'},status_code=422) except SkillError as error:response=JSONResponse({'code':error.code,'message':error.message},status_code=error.status) if response is None:return False response.headers.update({'Cache-Control':'no-store','Referrer-Policy':'no-referrer','X-Content-Type-Options':'nosniff','Content-Security-Policy':"default-src 'self'; script-src 'self'; style-src 'self'; connect-src 'self'; frame-ancestors 'self' https://huggingface.co; base-uri 'none'; form-action 'self'"}) await response(scope,receive,send);return True