pal-sgx-sign 30 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916
  1. #!/usr/bin/env python3
  2. import argparse
  3. import datetime
  4. import hashlib
  5. import os
  6. import shutil
  7. import struct
  8. import subprocess
  9. import sys
  10. sys.path.insert(0, os.path.dirname(os.path.dirname(__file__)))
  11. from generated_offsets import *
  12. # Default / Architectural Options
  13. ARCHITECTURE = "amd64"
  14. SSAFRAMESIZE = PAGESIZE
  15. DEFAULT_ENCLAVE_SIZE = '256M'
  16. DEFAULT_THREAD_NUM = 4
  17. enclave_heap_min = DEFAULT_HEAP_MIN
  18. # Utilities
  19. ZERO_PAGE = bytes(PAGESIZE)
  20. def roundup(addr):
  21. remaining = addr % PAGESIZE
  22. if remaining:
  23. return addr + (PAGESIZE - remaining)
  24. return addr
  25. def rounddown(addr):
  26. return addr - addr % PAGESIZE
  27. def parse_size(s):
  28. scale = 1
  29. if s.endswith("K"):
  30. scale = 1024
  31. if s.endswith("M"):
  32. scale = 1024 * 1024
  33. if s.endswith("G"):
  34. scale = 1024 * 1024 * 1024
  35. if scale != 1:
  36. s = s[:-1]
  37. return int(s, 0) * scale
  38. # Reading / Writing Manifests
  39. def read_manifest(filename):
  40. manifest = dict()
  41. manifest_layout = []
  42. with open(filename, "r") as f:
  43. for line in f.readlines():
  44. if line == "":
  45. manifest_layout.append((None, None))
  46. break
  47. pound = line.find("#")
  48. if pound != -1:
  49. comment = line[pound:].strip()
  50. line = line[:pound]
  51. else:
  52. comment = None
  53. line = line.strip()
  54. equal = line.find("=")
  55. if equal != -1:
  56. key = line[:equal].strip()
  57. manifest[key] = line[equal + 1:].strip()
  58. else:
  59. key = None
  60. manifest_layout.append((key, comment))
  61. return (manifest, manifest_layout)
  62. def exec_sig_manifest(args, manifest):
  63. if 'exec' not in args or args.get('depend'):
  64. if 'loader.exec' in manifest:
  65. exec_url = manifest['loader.exec']
  66. if not exec_url.startswith('file:'):
  67. print("executable must be a local file", file=sys.stderr)
  68. return 1
  69. exec_path = exec_url[5:] # strip preceding 'file:'
  70. if os.path.isabs(exec_path):
  71. args['exec'] = exec_path
  72. else:
  73. args['exec'] = os.path.join(
  74. os.path.dirname(args['manifest']), exec_path)
  75. if 'sgx.sigfile' in manifest:
  76. args['sigfile'] = resolve_uri(manifest['sgx.sigfile'],
  77. check_exist=False)
  78. else:
  79. sigfile = args['output']
  80. for ext in ['.manifest.sgx.d', '.manifest.sgx', '.manifest']:
  81. if sigfile.endswith(ext):
  82. sigfile = sigfile[:-len(ext)]
  83. break
  84. args['sigfile'] = sigfile + '.sig'
  85. manifest['sgx.sigfile'] = 'file:' + os.path.basename(args['sigfile'])
  86. return 0
  87. def output_manifest(filename, manifest, manifest_layout):
  88. with open(filename, 'w') as f:
  89. written = []
  90. for (key, comment) in manifest_layout:
  91. line = ''
  92. if key is not None:
  93. line += key + ' = ' + manifest[key]
  94. written.append(key)
  95. if comment is not None:
  96. if line != '':
  97. line += ' '
  98. line += comment
  99. f.write(line)
  100. f.write('\n')
  101. f.write('\n')
  102. f.write("# Generated by Graphene\n")
  103. f.write('\n')
  104. for key in sorted(manifest):
  105. if key not in written:
  106. f.write("%s = %s\n" % (key, manifest[key]))
  107. # Loading Enclave Attributes
  108. def get_enclave_attributes(manifest):
  109. sgx_flags = {
  110. 'FLAG_DEBUG': struct.pack("<Q", SGX_FLAGS_DEBUG),
  111. 'FLAG_MODE64BIT': struct.pack("<Q", SGX_FLAGS_MODE64BIT),
  112. }
  113. sgx_xfrms = {
  114. 'XFRM_LEGACY': struct.pack("<Q", SGX_XFRM_LEGACY),
  115. 'XFRM_AVX': struct.pack("<Q", SGX_XFRM_AVX),
  116. 'XFRM_AVX512': struct.pack("<Q", SGX_XFRM_AVX512),
  117. 'XFRM_MPX': struct.pack("<Q", SGX_XFRM_MPX),
  118. }
  119. sgx_miscs = {
  120. 'MISC_EXINFO': struct.pack("<L", SGX_MISCSELECT_EXINFO),
  121. }
  122. default_attributes = {
  123. 'FLAG_DEBUG',
  124. 'XFRM_LEGACY',
  125. }
  126. if ARCHITECTURE == 'amd64':
  127. default_attributes.add('FLAG_MODE64BIT')
  128. manifest_options = {
  129. 'debug': 'FLAG_DEBUG',
  130. 'require_avx': 'XFRM_AVX',
  131. 'require_avx512': 'XFRM_AVX512',
  132. 'require_mpx': 'XFRM_MPX',
  133. 'support_exinfo': 'MISC_EXINFO',
  134. }
  135. attributes = default_attributes
  136. for opt in manifest_options:
  137. key = 'sgx.' + opt
  138. if key in manifest:
  139. if manifest[key] == '1':
  140. attributes.add(manifest_options[opt])
  141. else:
  142. attributes.discard(manifest_options[opt])
  143. flags_raw = struct.pack("<Q", 0)
  144. xfrms_raw = struct.pack("<Q", 0)
  145. miscs_raw = struct.pack("<L", 0)
  146. for attr in attributes:
  147. if attr in sgx_flags:
  148. flags_raw = bytes([a | b for a, b in
  149. zip(flags_raw, sgx_flags[attr])])
  150. if attr in sgx_xfrms:
  151. xfrms_raw = bytes([a | b for a, b in
  152. zip(xfrms_raw, sgx_xfrms[attr])])
  153. if attr in sgx_miscs:
  154. miscs_raw = bytes([a | b for a, b in
  155. zip(miscs_raw, sgx_miscs[attr])])
  156. return flags_raw, xfrms_raw, miscs_raw
  157. # Generate Checksums / Measurement
  158. def resolve_uri(uri, check_exist=True):
  159. orig_uri = uri
  160. if uri.startswith('file:'):
  161. target = os.path.normpath(uri[5:])
  162. else:
  163. target = os.path.normpath(uri)
  164. if check_exist and not os.path.exists(target):
  165. raise Exception(
  166. 'Cannot resolve ' + orig_uri + ' or the file does not exist.')
  167. return target
  168. def get_checksum(file):
  169. digest = hashlib.sha256()
  170. with open(file, 'rb') as f:
  171. digest.update(f.read())
  172. return digest.digest()
  173. def get_trusted_files(manifest, args, check_exist=True, do_checksum=True):
  174. targets = dict()
  175. if 'exec' in args:
  176. targets['exec'] = (args['exec'], resolve_uri(args['exec'],
  177. check_exist))
  178. if 'loader.preload' in manifest:
  179. for i, uri in enumerate(str.split(manifest['loader.preload'], ',')):
  180. targets['preload' + str(i)] = (uri, resolve_uri(uri, check_exist))
  181. for (key, val) in manifest.items():
  182. if not key.startswith('sgx.trusted_files.'):
  183. continue
  184. key = key[len('sgx.trusted_files.'):]
  185. if key in targets:
  186. raise Exception(
  187. 'repeated key in manifest: sgx.trusted_files.' + key)
  188. targets[key] = (val, resolve_uri(val, check_exist))
  189. if do_checksum:
  190. for (key, val) in targets.items():
  191. (uri, target) = val
  192. checksum = get_checksum(target).hex()
  193. targets[key] = (uri, target, checksum)
  194. return targets
  195. def get_trusted_children(manifest, check_exist=True, do_checksum=True):
  196. targets = dict()
  197. for (key, val) in manifest.items():
  198. if not key.startswith('sgx.trusted_children.'):
  199. continue
  200. key = key[len('sgx.trusted_children.'):]
  201. if key in targets:
  202. raise Exception(
  203. 'repeated key in manifest: sgx.trusted_children.' + key)
  204. target = resolve_uri(val, check_exist)
  205. if not target.endswith('.sig'):
  206. target += '.sig'
  207. if do_checksum:
  208. sig = open(target, 'rb').read()[
  209. SGX_ARCH_ENCLAVE_CSS_ENCLAVE_HASH:
  210. SGX_ARCH_ENCLAVE_CSS_ENCLAVE_HASH + SGX_HASH_SIZE].hex()
  211. targets[key] = (val, target, sig)
  212. else:
  213. targets[key] = (val, target)
  214. return targets
  215. # Populate Enclave Memory
  216. PAGEINFO_R = 0x1
  217. PAGEINFO_W = 0x2
  218. PAGEINFO_X = 0x4
  219. PAGEINFO_TCS = 0x100
  220. PAGEINFO_REG = 0x200
  221. def get_loadcmds(filename):
  222. loadcmds = []
  223. p = subprocess.Popen(['readelf', '-l', '-W', filename],
  224. stdout=subprocess.PIPE, stderr=subprocess.PIPE)
  225. while True:
  226. line = p.stdout.readline()
  227. if not line:
  228. break
  229. line = line.decode()
  230. stripped = line.strip()
  231. if not stripped.startswith('LOAD'):
  232. continue
  233. tokens = stripped.split()
  234. if len(tokens) < 6:
  235. continue
  236. if len(tokens) >= 7 and tokens[7] == "E":
  237. tokens[6] += tokens[7]
  238. prot = 0
  239. for t in tokens[6]:
  240. if t == "R":
  241. prot = prot | 4
  242. if t == "W":
  243. prot = prot | 2
  244. if t == "E":
  245. prot = prot | 1
  246. loadcmds.append((int(tokens[1][2:], 16), # offset
  247. int(tokens[2][2:], 16), # addr
  248. int(tokens[4][2:], 16), # filesize
  249. int(tokens[5][2:], 16), # memsize
  250. prot))
  251. p.wait()
  252. if p.returncode != 0:
  253. return None
  254. return loadcmds
  255. class MemoryArea:
  256. def __init__(self, desc, file=None, content=None, addr=None, size=None,
  257. flags=None, measure=True):
  258. self.desc = desc
  259. self.file = file
  260. self.content = content
  261. self.addr = addr
  262. self.size = size
  263. self.flags = flags
  264. self.is_binary = False
  265. self.measure = measure
  266. if file:
  267. loadcmds = get_loadcmds(file)
  268. if loadcmds:
  269. mapaddr = 0xffffffffffffffff
  270. mapaddr_end = 0
  271. for (_, addr_, _, memsize, _) in loadcmds:
  272. if rounddown(addr_) < mapaddr:
  273. mapaddr = rounddown(addr_)
  274. if roundup(addr_ + memsize) > mapaddr_end:
  275. mapaddr_end = roundup(addr_ + memsize)
  276. self.is_binary = True
  277. self.size = mapaddr_end - mapaddr
  278. if mapaddr > 0:
  279. self.addr = mapaddr
  280. else:
  281. self.size = os.stat(file).st_size
  282. if self.addr is not None:
  283. self.addr = rounddown(self.addr)
  284. if self.size is not None:
  285. self.size = roundup(self.size)
  286. def get_memory_areas(attr, args):
  287. areas = []
  288. areas.append(
  289. MemoryArea('ssa',
  290. size=attr['thread_num'] * SSAFRAMESIZE * SSAFRAMENUM,
  291. flags=PAGEINFO_R | PAGEINFO_W | PAGEINFO_REG))
  292. areas.append(MemoryArea('tcs', size=attr['thread_num'] * TCS_SIZE,
  293. flags=PAGEINFO_TCS))
  294. areas.append(MemoryArea('tls', size=attr['thread_num'] * PAGESIZE,
  295. flags=PAGEINFO_R | PAGEINFO_W | PAGEINFO_REG))
  296. for _ in range(attr['thread_num']):
  297. areas.append(MemoryArea('stack', size=ENCLAVE_STACK_SIZE,
  298. flags=PAGEINFO_R | PAGEINFO_W | PAGEINFO_REG))
  299. areas.append(MemoryArea('pal', file=args['libpal'], flags=PAGEINFO_REG))
  300. if 'exec' in args:
  301. areas.append(MemoryArea('exec', file=args['exec'],
  302. flags=PAGEINFO_W | PAGEINFO_REG))
  303. return areas
  304. def find_areas(areas, desc):
  305. return [area for area in areas if area.desc == desc]
  306. def find_area(areas, desc, allow_none=False):
  307. matching = find_areas(areas, desc)
  308. if not matching and allow_none:
  309. return None
  310. if len(matching) != 1:
  311. raise KeyError(
  312. "Could not find exactly one MemoryArea '{}'".format(desc))
  313. return matching[0]
  314. def entry_point(elf_path):
  315. env = os.environ
  316. env['LC_ALL'] = 'C'
  317. out = subprocess.check_output(
  318. ['readelf', '-l', '--', elf_path], env=env)
  319. for line in out.splitlines():
  320. line = line.decode()
  321. if line.startswith("Entry point "):
  322. return int(line[12:], 0)
  323. raise ValueError("Could not find entry point of elf file")
  324. def baseaddr():
  325. if enclave_heap_min == 0:
  326. return ENCLAVE_HIGH_ADDRESS
  327. return 0
  328. def gen_area_content(attr, areas):
  329. manifest_area = find_area(areas, 'manifest')
  330. exec_area = find_area(areas, 'exec', True)
  331. pal_area = find_area(areas, 'pal')
  332. ssa_area = find_area(areas, 'ssa')
  333. tcs_area = find_area(areas, 'tcs')
  334. tls_area = find_area(areas, 'tls')
  335. stacks = find_areas(areas, 'stack')
  336. tcs_data = bytearray(tcs_area.size)
  337. def set_tcs_field(t, offset, pack_fmt, value):
  338. struct.pack_into(pack_fmt, tcs_data, t * TCS_SIZE + offset, value)
  339. tls_data = bytearray(tls_area.size)
  340. def set_tls_field(t, offset, value):
  341. struct.pack_into('<Q', tls_data, t * PAGESIZE + offset, value)
  342. enclave_heap_max = pal_area.addr - MEMORY_GAP
  343. # Sanity check that we measure everything except the heap which is zeroed
  344. # on enclave startup.
  345. for area in areas:
  346. if (area.addr + area.size <= enclave_heap_min or
  347. area.addr >= enclave_heap_max or area is exec_area):
  348. if not area.measure:
  349. raise ValueError("Memory area, which is not the heap, "
  350. "is not measured")
  351. elif area.desc != 'free':
  352. raise ValueError("Unexpected memory area is in heap range")
  353. for t in range(0, attr['thread_num']):
  354. ssa_offset = ssa_area.addr + SSAFRAMESIZE * SSAFRAMENUM * t
  355. ssa = baseaddr() + ssa_offset
  356. set_tcs_field(t, TCS_OSSA, '<Q', ssa_offset)
  357. set_tcs_field(t, TCS_NSSA, '<L', SSAFRAMENUM)
  358. set_tcs_field(t, TCS_OENTRY, '<Q',
  359. pal_area.addr + entry_point(pal_area.file))
  360. set_tcs_field(t, TCS_OGS_BASE, '<Q', tls_area.addr + PAGESIZE * t)
  361. set_tcs_field(t, TCS_OFS_LIMIT, '<L', 0xfff)
  362. set_tcs_field(t, TCS_OGS_LIMIT, '<L', 0xfff)
  363. set_tls_field(t, SGX_COMMON_SELF,
  364. tls_area.addr + PAGESIZE * t + baseaddr())
  365. set_tls_field(t, SGX_ENCLAVE_SIZE, attr['enclave_size'])
  366. set_tls_field(t, SGX_TCS_OFFSET, tcs_area.addr + TCS_SIZE * t)
  367. set_tls_field(t, SGX_INITIAL_STACK_OFFSET,
  368. stacks[t].addr + stacks[t].size)
  369. set_tls_field(t, SGX_SSA, ssa)
  370. set_tls_field(t, SGX_GPR, ssa + SSAFRAMESIZE - SGX_GPR_SIZE)
  371. set_tls_field(t, SGX_MANIFEST_SIZE,
  372. os.stat(manifest_area.file).st_size)
  373. set_tls_field(t, SGX_HEAP_MIN, baseaddr() + enclave_heap_min)
  374. set_tls_field(t, SGX_HEAP_MAX, baseaddr() + enclave_heap_max)
  375. if exec_area is not None:
  376. set_tls_field(t, SGX_EXEC_ADDR, baseaddr() + exec_area.addr)
  377. set_tls_field(t, SGX_EXEC_SIZE, exec_area.size)
  378. tcs_area.content = tcs_data
  379. tls_area.content = tls_data
  380. def populate_memory_areas(attr, areas):
  381. populating = attr['enclave_size']
  382. for area in areas:
  383. if area.addr is not None:
  384. continue
  385. area.addr = populating - area.size
  386. if area.addr < enclave_heap_min:
  387. raise Exception("Enclave size is not large enough")
  388. populating = max(area.addr - MEMORY_GAP, 0)
  389. free_areas = []
  390. for area in areas:
  391. if area.addr + area.size + MEMORY_GAP < populating:
  392. addr = area.addr + area.size + MEMORY_GAP
  393. flags = PAGEINFO_R | PAGEINFO_W | PAGEINFO_X | PAGEINFO_REG
  394. free_areas.append(
  395. MemoryArea('free', addr=addr, size=populating - addr,
  396. flags=flags, measure=False))
  397. populating = max(area.addr - MEMORY_GAP, 0)
  398. if populating > enclave_heap_min:
  399. flags = PAGEINFO_R | PAGEINFO_W | PAGEINFO_X | PAGEINFO_REG
  400. free_areas.append(
  401. MemoryArea('free', addr=enclave_heap_min,
  402. size=populating - enclave_heap_min, flags=flags,
  403. measure=False))
  404. gen_area_content(attr, areas)
  405. return areas + free_areas
  406. def generate_measurement(attr, areas):
  407. def do_ecreate(digest, size):
  408. data = struct.pack("<8sLQ44s", b"ECREATE", SSAFRAMESIZE // PAGESIZE,
  409. size, b"")
  410. digest.update(data)
  411. def do_eadd(digest, offset, flags):
  412. data = struct.pack("<8sQQ40s", b"EADD", offset, flags, b"")
  413. digest.update(data)
  414. def do_eextend(digest, offset, content):
  415. if len(content) != 256:
  416. raise ValueError("Exactly 256 bytes expected")
  417. data = struct.pack("<8sQ48s", b"EEXTEND", offset, b"")
  418. digest.update(data)
  419. digest.update(content)
  420. def include_page(digest, offset, flags, content, measure):
  421. if len(content) != PAGESIZE:
  422. raise ValueError("Exactly one page expected")
  423. do_eadd(digest, offset, flags)
  424. if measure:
  425. for i in range(0, PAGESIZE, 256):
  426. do_eextend(digest, offset + i, content[i:i + 256])
  427. mrenclave = hashlib.sha256()
  428. do_ecreate(mrenclave, attr['enclave_size'])
  429. def print_area(addr, size, flags, desc, measured):
  430. if flags & PAGEINFO_REG:
  431. type_ = 'REG'
  432. if flags & PAGEINFO_TCS:
  433. type_ = 'TCS'
  434. prot = ['-', '-', '-']
  435. if flags & PAGEINFO_R:
  436. prot[0] = 'R'
  437. if flags & PAGEINFO_W:
  438. prot[1] = 'W'
  439. if flags & PAGEINFO_X:
  440. prot[2] = 'X'
  441. prot = ''.join(prot)
  442. desc = '(' + desc + ')'
  443. if measured:
  444. desc += ' measured'
  445. if size == PAGESIZE:
  446. print(" %016x [%s:%s] %s" % (addr, type_, prot, desc))
  447. else:
  448. print(" %016x-%016lx [%s:%s] %s" %
  449. (addr, addr + size, type_, prot, desc))
  450. def load_file(digest, f, offset, addr, filesize, memsize, desc, flags):
  451. f_addr = rounddown(offset)
  452. m_addr = rounddown(addr)
  453. m_size = roundup(addr + memsize) - m_addr
  454. print_area(m_addr, m_size, flags, desc, True)
  455. for pg in range(m_addr, m_addr + m_size, PAGESIZE):
  456. start = pg - m_addr + f_addr
  457. end = start + PAGESIZE
  458. start_zero = b""
  459. if start < offset:
  460. if offset - start >= PAGESIZE:
  461. start_zero = ZERO_PAGE
  462. else:
  463. start_zero = bytes(offset - start)
  464. end_zero = b""
  465. if end > offset + filesize:
  466. if end - offset - filesize >= PAGESIZE:
  467. end_zero = ZERO_PAGE
  468. else:
  469. end_zero = bytes(end - offset - filesize)
  470. start += len(start_zero)
  471. end -= len(end_zero)
  472. if start < end:
  473. f.seek(start)
  474. data = f.read(end - start)
  475. else:
  476. data = b""
  477. if len(start_zero + data + end_zero) != PAGESIZE:
  478. raise Exception("wrong calculation")
  479. include_page(digest, pg, flags, start_zero + data + end_zero, True)
  480. for area in areas:
  481. if area.file:
  482. with open(area.file, 'rb') as f:
  483. if area.is_binary:
  484. loadcmds = get_loadcmds(area.file)
  485. if loadcmds:
  486. mapaddr = 0xffffffffffffffff
  487. for (offset, addr, filesize, memsize,
  488. prot) in loadcmds:
  489. if rounddown(addr) < mapaddr:
  490. mapaddr = rounddown(addr)
  491. baseaddr_ = area.addr - mapaddr
  492. for (offset, addr, filesize, memsize, prot) in loadcmds:
  493. flags = area.flags
  494. if prot & 4:
  495. flags = flags | PAGEINFO_R
  496. if prot & 2:
  497. flags = flags | PAGEINFO_W
  498. if prot & 1:
  499. flags = flags | PAGEINFO_X
  500. if flags & PAGEINFO_X:
  501. desc = 'code'
  502. else:
  503. desc = 'data'
  504. load_file(mrenclave, f, offset, baseaddr_ + addr,
  505. filesize, memsize, desc, flags)
  506. else:
  507. load_file(mrenclave, f, 0, area.addr,
  508. os.stat(area.file).st_size, area.size,
  509. area.desc, area.flags)
  510. else:
  511. for a in range(area.addr, area.addr + area.size, PAGESIZE):
  512. data = ZERO_PAGE
  513. if area.content is not None:
  514. start = a - area.addr
  515. end = start + PAGESIZE
  516. data = area.content[start:end]
  517. include_page(mrenclave, a, area.flags, data, area.measure)
  518. print_area(area.addr, area.size, area.flags, area.desc,
  519. area.measure)
  520. return mrenclave.digest()
  521. def generate_sigstruct(attr, args, mrenclave):
  522. """Generate Sigstruct."""
  523. # field format: (offset, type, value)
  524. fields = {
  525. 'header': (SGX_ARCH_ENCLAVE_CSS_HEADER,
  526. "<4L", 0x00000006, 0x000000e1, 0x00010000, 0x00000000),
  527. 'module_vendor': (SGX_ARCH_ENCLAVE_CSS_MODULE_VENDOR, "<L", 0x00000000),
  528. 'date': (SGX_ARCH_ENCLAVE_CSS_DATE, "<HBB", attr['year'], attr['month'], attr['day']),
  529. 'header2': (SGX_ARCH_ENCLAVE_CSS_HEADER2,
  530. "<4L", 0x00000101, 0x00000060, 0x00000060, 0x00000001),
  531. 'hw_version': (SGX_ARCH_ENCLAVE_CSS_HW_VERSION, "<L", 0x00000000),
  532. 'misc_select': (SGX_ARCH_ENCLAVE_CSS_MISC_SELECT, "4s", attr['misc_select']),
  533. 'misc_mask': (SGX_ARCH_ENCLAVE_CSS_MISC_MASK, "4s", attr['misc_select']),
  534. 'attributes': (SGX_ARCH_ENCLAVE_CSS_ATTRIBUTES, "8s8s", attr['flags'], attr['xfrms']),
  535. 'attribute_mask': (SGX_ARCH_ENCLAVE_CSS_ATTRIBUTE_MASK,
  536. "8s8s", attr['flags'], attr['xfrms']),
  537. 'enclave_hash': (SGX_ARCH_ENCLAVE_CSS_ENCLAVE_HASH, "32s", mrenclave),
  538. 'isv_prod_id': (SGX_ARCH_ENCLAVE_CSS_ISV_PROD_ID, "<H", attr['isv_prod_id']),
  539. 'isv_svn': (SGX_ARCH_ENCLAVE_CSS_ISV_SVN, "<H", attr['isv_svn']),
  540. }
  541. sign_buffer = bytearray(128 + 128)
  542. for field in fields.values():
  543. if field[0] >= SGX_ARCH_ENCLAVE_CSS_MISC_SELECT:
  544. struct.pack_into(field[1], sign_buffer,
  545. field[0] - SGX_ARCH_ENCLAVE_CSS_MISC_SELECT + 128,
  546. *field[2:])
  547. else:
  548. struct.pack_into(field[1], sign_buffer, field[0], *field[2:])
  549. p = subprocess.Popen(
  550. ['openssl', 'rsa', '-modulus', '-in', args['key'], '-noout'],
  551. stdout=subprocess.PIPE)
  552. modulus_out = p.communicate()[0]
  553. modulus = bytes.fromhex(modulus_out[8:8+SE_KEY_SIZE*2].decode())
  554. modulus = bytes(reversed(modulus))
  555. p = subprocess.Popen(
  556. ['openssl', 'sha256', '-binary', '-sign', args['key']],
  557. stdin=subprocess.PIPE, stdout=subprocess.PIPE)
  558. signature = p.communicate(sign_buffer)[0]
  559. signature = signature[::-1]
  560. modulus_int = int.from_bytes(modulus, byteorder='little')
  561. signature_int = int.from_bytes(signature, byteorder='little')
  562. tmp1 = signature_int * signature_int
  563. q1_int = tmp1 // modulus_int
  564. tmp2 = tmp1 % modulus_int
  565. q2_int = tmp2 * signature_int // modulus_int
  566. q1 = q1_int.to_bytes(384, byteorder='little')
  567. q2 = q2_int.to_bytes(384, byteorder='little')
  568. fields.update({
  569. 'modulus': (SGX_ARCH_ENCLAVE_CSS_MODULUS, "384s", modulus),
  570. 'exponent': (SGX_ARCH_ENCLAVE_CSS_EXPONENT, "<L", 3),
  571. 'signature': (SGX_ARCH_ENCLAVE_CSS_SIGNATURE, "384s", signature),
  572. 'q1': (SGX_ARCH_ENCLAVE_CSS_Q1, "384s", q1),
  573. 'q2': (SGX_ARCH_ENCLAVE_CSS_Q2, "384s", q2),
  574. })
  575. buffer = bytearray(SGX_ARCH_ENCLAVE_CSS_SIZE)
  576. for field in fields.values():
  577. struct.pack_into(field[1], buffer, field[0], *field[2:])
  578. return buffer
  579. # Main Program
  580. argparser = argparse.ArgumentParser(
  581. epilog='With sign mode(without -depend), libpal and key are also required')
  582. argparser.add_argument('--output', '-output', metavar='OUTPUT',
  583. type=str, required=True,
  584. help='Output .manifest.sgx file '
  585. '(manifest augmented with autogenerated fields)')
  586. argparser.add_argument('--libpal', '-libpal', metavar='LIBPAL',
  587. type=str, required=False,
  588. help='Input libpal file '
  589. '(required as part of the enclave measurement)')
  590. argparser.add_argument('--key', '-key', metavar='KEY',
  591. type=str, required=False,
  592. help='specify signing key(.pem) file')
  593. argparser.add_argument('--manifest', '-manifest', metavar='MANIFEST',
  594. type=str, required=True,
  595. help='Input .manifest file '
  596. '(user-prepared manifest template)')
  597. argparser.add_argument('--exec', '-exec', metavar='EXEC',
  598. type=str, required=False,
  599. help='Input executable file '
  600. '(required as part of the enclave measurement)')
  601. argparser.add_argument('--depend', '-depend',
  602. action='store_true', required=False,
  603. help='Generate dependency for Makefile')
  604. def parse_args(args):
  605. args = argparser.parse_args(args)
  606. args_dict = {
  607. 'output': args.output,
  608. 'libpal': args.libpal,
  609. 'key': args.key,
  610. 'manifest': args.manifest,
  611. }
  612. if args.exec is not None:
  613. args_dict['exec'] = args.exec
  614. if args.depend:
  615. args_dict['depend'] = True
  616. else:
  617. # libpal and key are required
  618. if args.libpal is None or args.key is None:
  619. argparser.error("libpal and key are also required to sign")
  620. return None
  621. return args_dict
  622. def main_sign(args):
  623. (manifest, manifest_layout) = read_manifest(args['manifest'])
  624. if exec_sig_manifest(args, manifest) != 0:
  625. return 1
  626. # Get attributes from manifest
  627. attr = dict()
  628. def parse_int(s):
  629. return int(s, 0)
  630. for key, default, parse, attr_key in [
  631. ('enclave_size', DEFAULT_ENCLAVE_SIZE, parse_size, 'enclave_size'),
  632. ('thread_num', str(DEFAULT_THREAD_NUM), parse_int, 'thread_num'),
  633. ('isvprodid', '0', parse_int, 'isv_prod_id'),
  634. ('isvsvn', '0', parse_int, 'isv_svn'),
  635. ]:
  636. attr[attr_key] = parse(manifest.setdefault('sgx.' + key, default))
  637. (attr['flags'], attr['xfrms'], attr['misc_select']) = get_enclave_attributes(manifest)
  638. today = datetime.date.today()
  639. attr['year'] = today.year
  640. attr['month'] = today.month
  641. attr['day'] = today.day
  642. print("Attributes:")
  643. print(" size: %d" % attr['enclave_size'])
  644. print(" thread_num: %d" % attr['thread_num'])
  645. print(" isv_prod_id: %d" % attr['isv_prod_id'])
  646. print(" isv_svn: %d" % attr['isv_svn'])
  647. print(" attr.flags: %016x" % int.from_bytes(attr['flags'], byteorder='big'))
  648. print(" attr.xfrm: %016x" % int.from_bytes(attr['xfrms'], byteorder='big'))
  649. print(" misc_select: %08x" % int.from_bytes(attr['misc_select'], byteorder='big'))
  650. print(" date: %d-%02d-%02d" % (attr['year'], attr['month'], attr['day']))
  651. # Check client info for remote attestation
  652. # (if sgx.ra_client.spid is provided)
  653. print("Attestation:")
  654. if 'sgx.ra_client_spid' in manifest and manifest['sgx.ra_client_spid']:
  655. print(" spid: " + manifest['sgx.ra_client_spid'])
  656. if 'sgx.ra_client_key' in manifest and manifest['sgx.ra_client_key']:
  657. print(" key: " + manifest['sgx.ra_client_key'])
  658. else:
  659. print(" *** sgx.ra_client_key not specified ***")
  660. return 1
  661. if 'sgx.ra_client_linkable' in manifest:
  662. print(" linkable: " + manifest['sgx.ra_client_linkable'])
  663. else:
  664. print(" linkable: 0")
  665. else:
  666. print(" *** Client info is not specified. Graphene will not perform"
  667. " remote attestation before execution. Please provide"
  668. " sgx.ra_client_spid and sgx.ra_client_key in the manifest. ***")
  669. # Get trusted checksums and measurements
  670. print("Trusted files:")
  671. for key, val in get_trusted_files(manifest, args).items():
  672. (uri, _, checksum) = val
  673. print(" %s %s" % (checksum, uri))
  674. manifest['sgx.trusted_checksum.' + key] = checksum
  675. print("Trusted children:")
  676. for key, val in get_trusted_children(manifest).items():
  677. (uri, _, mrenclave) = val
  678. print(" %s %s" % (mrenclave, uri))
  679. manifest['sgx.trusted_mrenclave.' + key] = mrenclave
  680. # Try populate memory areas
  681. memory_areas = get_memory_areas(attr, args)
  682. if manifest.get('sgx.static_address', None) is None:
  683. # If static_address is not specified explicitly, deduce from executable
  684. if any([a.addr is not None for a in memory_areas]):
  685. manifest['sgx.static_address'] = '1'
  686. else:
  687. global enclave_heap_min
  688. enclave_heap_min = 0
  689. manifest['sgx.static_address'] = '0'
  690. # Add manifest at the top
  691. shutil.copy2(args['manifest'], args['output'])
  692. output_manifest(args['output'], manifest, manifest_layout)
  693. memory_areas = [
  694. MemoryArea('manifest', file=args['output'],
  695. flags=PAGEINFO_R | PAGEINFO_REG)
  696. ] + memory_areas
  697. memory_areas = populate_memory_areas(attr, memory_areas)
  698. print("Memory:")
  699. # Generate measurement
  700. mrenclave = generate_measurement(attr, memory_areas)
  701. print("Measurement:")
  702. print(" %s" % mrenclave.hex())
  703. # Generate sigstruct
  704. open(args['sigfile'], 'wb').write(
  705. generate_sigstruct(attr, args, mrenclave))
  706. return 0
  707. def make_depend(args):
  708. manifest_file = args['manifest']
  709. output = args['output']
  710. (manifest, _) = read_manifest(manifest_file)
  711. if exec_sig_manifest(args, manifest) != 0:
  712. return 1
  713. dependencies = set()
  714. for filename in get_trusted_files(manifest, args, check_exist=False,
  715. do_checksum=False).values():
  716. dependencies.add(filename[1])
  717. for filename in get_trusted_children(manifest, check_exist=False,
  718. do_checksum=False).values():
  719. dependencies.add(filename[1])
  720. with open(output, 'w') as f:
  721. manifest_sgx = output
  722. if manifest_sgx.endswith('.d'):
  723. manifest_sgx = manifest_sgx[:-len('.d')]
  724. f.write('%s %s:' % (manifest_sgx, args['sigfile']))
  725. for filename in dependencies:
  726. f.write(' \\\n\t%s' % filename)
  727. f.write('\n')
  728. return 0
  729. def main(args=None):
  730. args = parse_args(args)
  731. if args is None:
  732. return 1
  733. if args.get('depend'):
  734. return make_depend(args)
  735. return main_sign(args)
  736. if __name__ == "__main__":
  737. sys.exit(main())