3 # sfi -- slice-based facility interface
9 from types import StringTypes, ListType
10 from optparse import OptionParser
12 from sfa.trust.certificate import Keypair, Certificate
13 from sfa.trust.credential import Credential
15 from sfa.util.geniclient import GeniClient
16 from sfa.util.record import *
17 from sfa.util.rspec import Rspec
18 from sfa.util.xmlrpcprotocol import ServerException
19 from sfa.util.config import Config
21 # xxx todo xxx auto-load ~/.sfi/sfi_config
23 sfi_dir = os.path.expanduser("~/.sfi/")
31 # Establish Connection to SliceMgr and Registry Servers
33 def set_servers(options):
39 config_file = sfi_dir + os.sep + "sfi_config"
41 config = Config (config_file)
43 print "Failed to read configuration file",config_file
44 print "Make sure to remove the export clauses and to add quotes"
45 if not options.verbose:
46 print "Re-run with -v for more details"
53 if (options.sm is not None):
55 elif hasattr(config,"SFI_SM"):
56 sm_url = config.SFI_SM
58 print "You need to set e.g. SFI_SM='http://your.slicemanager.url:12347/' in %s"%config_file
62 if (options.registry is not None):
63 reg_url = options.registry
64 elif hasattr(config,"SFI_REGISTRY"):
65 reg_url = config.SFI_REGISTRY
67 print "You need to set e.g. SFI_REGISTRY='http://your.registry.url:12345/' in %s"%config_file
71 if (options.user is not None):
73 elif hasattr(config,"SFI_USER"):
74 user = config.SFI_USER
76 print "You need to set e.g. SFI_USER='plc.princeton.username' in %s"%config_file
80 if (options.auth is not None):
81 authority = options.auth
82 elif hasattr(config,"SFI_AUTH"):
83 authority = config.SFI_AUTH
85 print "You need to set e.g. SFI_AUTH='plc.princeton' in %s"%config_file
92 print "Contacting Slice Manager at:", sm_url
93 print "Contacting Registry at:", reg_url
95 # Get key and certificate
96 key_file = get_key_file()
97 cert_file = get_cert_file(key_file)
99 # Establish connection to server(s)
100 slicemgr = GeniClient(sm_url, key_file, cert_file, options.protocol)
101 registry = GeniClient(reg_url, key_file, cert_file, options.protocol)
105 # Get various credential and spec files
107 # Establishes limiting conventions
108 # - conflates MAs and SAs
109 # - assumes last token in slice name is unique
111 # Bootstraps credentials
112 # - bootstrap user credential from self-signed certificate
113 # - bootstrap authority credential from user credential
114 # - bootstrap slice credential from user credential
118 parts = name.split(".")
122 file = os.path.join(sfi_dir, get_leaf(user) + ".pkey")
123 if (os.path.isfile(file)):
126 print "Key file", file, "does not exist"
130 def get_cert_file(key_file):
133 file = os.path.join(sfi_dir, get_leaf(user) + ".cert")
134 if (os.path.isfile(file)):
137 k = Keypair(filename = key_file)
138 cert = Certificate(subject=user)
140 cert.set_issuer(k, user)
143 print "Writing self-signed certificate to", file
144 cert.save_to_file(file)
150 file = os.path.join(sfi_dir, get_leaf(user) + ".cred")
151 if (os.path.isfile(file)):
152 user_cred = Credential(filename=file)
155 # bootstrap user credential
156 user_cred = registry.get_credential(None, "user", user)
158 user_cred.save_to_file(file, save_parents=True)
160 print "Writing user credential to", file
163 print "Failed to get user credential"
170 print "no authority specified. Use -a or set SF_AUTH"
173 file = os.path.join(sfi_dir, get_leaf("authority") +".cred")
174 if (os.path.isfile(file)):
175 auth_cred = Credential(filename=file)
178 # bootstrap authority credential from user credential
179 user_cred = get_user_cred()
180 auth_cred = registry.get_credential(user_cred, "sa", authority)
182 auth_cred.save_to_file(file, save_parents=True)
184 print "Writing authority credential to", file
187 print "Failed to get authority credential"
190 def get_slice_cred(name):
191 file = os.path.join(sfi_dir, "slice_" + get_leaf(name) + ".cred")
192 if (os.path.isfile(file)):
193 slice_cred = Credential(filename=file)
196 # bootstrap slice credential from user credential
197 user_cred = get_user_cred()
198 slice_cred = registry.get_credential(user_cred, "slice", name)
200 slice_cred.save_to_file(file, save_parents=True)
202 print "Writing slice credential to", file
205 print "Failed to get slice credential"
208 def delegate_cred(cred, hrn, type = 'authority'):
209 # the gid and hrn of the object we are delegating
210 object_gid = cred.get_gid_object()
211 object_hrn = object_gid.get_hrn()
212 cred.set_delegate(True)
213 if not cred.get_delegate():
214 raise Exception, "Error: Object credential %(object_hrn)s does not have delegate bit set" % locals()
217 records = registry.resolve(cred, hrn)
218 records = filter_records(type, records)
221 raise Exception, "Error: Didn't find a %(type)s record for %(hrn)s" % locals()
223 # the gid of the user who will be delegated too
224 delegee_gid = records[0].get_gid_object()
225 delegee_hrn = delegee_gid.get_hrn()
227 # the key and hrn of the user who will be delegating
228 user_key = Keypair(filename = get_key_file())
229 user_hrn = cred.get_gid_caller().get_hrn()
231 dcred = Credential(subject=object_hrn + " delegated to " + delegee_hrn)
232 dcred.set_gid_caller(delegee_gid)
233 dcred.set_gid_object(object_gid)
234 dcred.set_privileges(cred.get_privileges())
235 dcred.set_delegate(True)
236 dcred.set_pubkey(object_gid.get_pubkey())
237 dcred.set_issuer(user_key, user_hrn)
238 dcred.set_parent(cred)
244 def get_rspec_file(rspec):
245 if (os.path.isabs(rspec)):
248 file = os.path.join(sfi_dir, rspec)
249 if (os.path.isfile(file)):
252 print "No such rspec file", rspec
255 def get_record_file(record):
256 if (os.path.isabs(record)):
259 file = os.path.join(sfi_dir, record)
260 if (os.path.isfile(file)):
263 print "No such registry record file", record
266 def load_publickey_string(fn):
268 key_string = f.read()
270 # if the filename is a private key file, then extract the public key
271 if "PRIVATE KEY" in key_string:
272 outfn = tempfile.mktemp()
273 cmd = "openssl rsa -in " + fn + " -pubout -outform PEM -out " + outfn
276 key_string = f.read()
281 # Generate sub-command parser
283 def create_cmd_parser(command, additional_cmdargs = None):
284 cmdargs = {"list": "name",
290 "resources": "[name]",
291 "create": "name rspec",
299 if additional_cmdargs:
300 cmdargs.update(additional_cmdargs)
302 if command not in cmdargs:
303 print "Invalid command\n"
305 for key in cmdargs.keys():
310 parser = OptionParser(usage="sfi [sfi_options] %s [options] %s" \
311 % (command, cmdargs[command]))
313 # This option is for all commands
314 parser.add_option("-x", "--dumpformat", dest="dumpformat", type="choice",
315 help="dump format (text|xml)",default="text",
316 choices=("text","xml"))
318 if command in ("resources"):
319 parser.add_option("-f", "--format", dest="format",type="choice",
320 help="display format (dns|ip|rspec)",default="rspec",
321 choices=("dns","ip","rspec"))
322 if command in ("list", "show", "remove"):
323 parser.add_option("-t", "--type", dest="type",type="choice",
324 help="type filter (user|slice|sa|ma|node|aggregate)",
325 choices=("user","slice","sa","ma","node","aggregate", "all"),
327 if command in ("show", "list", "resources"):
328 parser.add_option("-o", "--output", dest="file",
329 help="output XML to file", metavar="FILE", default=None)
330 if command in ("delegate"):
331 parser.add_option("-u", "--user",
332 action="store_true", dest="delegate_user", default=False,
333 help="delegate user credential")
334 parser.add_option("-s", "--slice", dest="delegate_slice",
335 help="delegate slice credential", metavar="HRN", default=None)
339 # Generate command line parser
340 parser = OptionParser(usage="sfi [options] command [command_options] [command_args]",
341 description="Commands: list,show,remove,add,update,nodes,slices,resources,create,delete,start,stop,reset")
342 parser.add_option("-r", "--registry", dest="registry",
343 help="root registry", metavar="URL", default=None)
344 parser.add_option("-s", "--slicemgr", dest="sm",
345 help="slice manager", metavar="URL", default=None)
346 parser.add_option("-d", "--dir", dest="dir",
347 help="working directory", metavar="PATH", default = sfi_dir)
348 parser.add_option("-u", "--user", dest="user",
349 help="user name", metavar="HRN", default=None)
350 parser.add_option("-a", "--auth", dest="auth",
351 help="authority name", metavar="HRN", default=None)
352 parser.add_option("-v", "--verbose",
353 action="store_true", dest="verbose", default=False,
355 parser.add_option("-p", "--protocol",
356 dest="protocol", default="xmlrpc",
357 help="RPC protocol (xmlrpc or soap)")
358 parser.disable_interspersed_args()
362 def dispatch(command, cmd_opts, cmd_args):
363 globals()[command](cmd_opts, cmd_args)
366 # Main: parse arguments and dispatch to command
371 parser = create_parser()
372 (options, args) = parser.parse_args()
375 print "No command given. Use -h for help."
379 (cmd_opts, cmd_args) = create_cmd_parser(command).parse_args(args[1:])
380 verbose = options.verbose
382 print "Resgistry %s, sm %s, dir %s, user %s, auth %s" % (options.registry,
387 print "Command %s" %command
388 if command in ("resources"):
389 print "resources cmd_opts %s" %cmd_opts.format
390 elif command in ("list","show","remove"):
391 print "cmd_opts.type %s" %cmd_opts.type
392 print "cmd_args %s" %cmd_args
397 dispatch(command, cmd_opts, cmd_args)
400 print "Command not found:", command
406 # Following functions implement the commands
408 # Registry-related commands
411 # list entires in named authority registry
412 def list(opts, args):
414 user_cred = get_user_cred()
416 list = registry.list(user_cred, args[0])
418 raise Exception, "Not enough parameters for the 'list' command"
420 # filter on person, slice, site, node, etc.
421 # THis really should be in the filter_records funct def comment...
422 list = filter_records(opts.type, list)
424 print "%s (%s)" % (record['hrn'], record['type'])
426 save_records_to_file(opts.file, list)
429 # show named registry record
430 def show(opts, args):
432 user_cred = get_user_cred()
433 records = registry.resolve(user_cred, args[0])
434 records = filter_records(opts.type, records)
436 print "No record of type", opts.type
437 for record in records:
438 if record['type'] in ['user']:
439 record = UserRecord(dict = record)
440 elif record['type'] in ['slice']:
441 record = SliceRecord(dict = record)
442 elif record['type'] in ['node']:
443 record = NodeRecord(dict = record)
444 elif record['type'] in ['authority', 'ma', 'sa']:
445 record = AuthorityRecord(dict = record)
447 record = GeniRecord(dict = record)
449 if (opts.dumpformat=="text"):
452 print record.save_to_string()
455 save_records_to_file(opts.file, records)
458 def delegate(opts, args):
460 user_cred = get_user_cred()
461 if opts.delegate_user:
462 object_cred = user_cred
463 elif opts.delegate_slice:
464 object_cred = get_slice_cred(opts.delegate_slice)
466 print "Must specify either --user or --slice <hrn>"
469 # the gid and hrn of the object we are delegating
470 object_gid = object_cred.get_gid_object()
471 object_hrn = object_gid.get_hrn()
473 if not object_cred.get_delegate():
474 print "Error: Object credential", object_hrn, "does not have delegate bit set"
477 records = registry.resolve(user_cred, args[0])
478 records = filter_records("user", records)
481 print "Error: Didn't find a user record for", args[0]
484 # the gid of the user who will be delegated too
485 delegee_gid = records[0].get_gid_object()
486 delegee_hrn = delegee_gid.get_hrn()
488 # the key and hrn of the user who will be delegating
489 user_key = Keypair(filename = get_key_file())
490 user_hrn = user_cred.get_gid_caller().get_hrn()
492 dcred = Credential(subject=object_hrn + " delegated to " + delegee_hrn)
493 dcred.set_gid_caller(delegee_gid)
494 dcred.set_gid_object(object_gid)
495 dcred.set_privileges(object_cred.get_privileges())
496 dcred.set_delegate(True)
497 dcred.set_pubkey(object_gid.get_pubkey())
498 dcred.set_issuer(user_key, user_hrn)
499 dcred.set_parent(object_cred)
503 if opts.delegate_user:
504 dest_fn = os.path.join(sfi_dir, get_leaf(delegee_hrn) + "_" + get_leaf(object_hrn) + ".cred")
505 elif opts.delegate_slice:
506 dest_fn = os.path_join(sfi_dir, get_leaf(delegee_hrn) + "_slice_" + get_leaf(object_hrn) + ".cred")
508 dcred.save_to_file(dest_fn, save_parents = True)
510 print "delegated credential for", object_hrn, "to", delegee_hrn, "and wrote to", dest_fn
512 # removed named registry record
513 # - have to first retrieve the record to be removed
514 def remove(opts, args):
516 auth_cred = get_auth_cred()
517 return registry.remove(auth_cred, opts.type, args[0])
519 # add named registry record
522 auth_cred = get_auth_cred()
523 rec_file = get_record_file(args[0])
524 record = load_record_from_file(rec_file)
526 return registry.register(auth_cred, record)
528 # update named registry entry
529 def update(opts, args):
531 user_cred = get_user_cred()
532 rec_file = get_record_file(args[0])
533 record = load_record_from_file(rec_file)
534 if record.get_type() == "user":
535 if record.get_name() == user_cred.get_gid_object().get_hrn():
538 cred = get_auth_cred()
539 elif record.get_type() in ["slice"]:
541 cred = get_slice_cred(record.get_name())
542 except ServerException, e:
543 # XXX smbaker -- once we have better error return codes, update this
544 # to do something better than a string compare
545 if "Permission error" in e.args[0]:
546 cred = get_auth_cred()
549 elif record.get_type() in ["authority"]:
550 cred = get_auth_cred()
551 elif record.get_type() == 'node':
552 cred = get_auth_cred()
554 raise "unknown record type" + record.get_type()
555 return registry.update(cred, record)
558 # Slice-related commands
561 # list available nodes -- now use 'resources' w/ no argument instead
562 #def nodes(opts, args):
564 # user_cred = get_user_cred()
565 # if not opts.format:
568 # context = opts.format
569 # results = slicemgr.list_nodes(user_cred)
570 # if opts.format in ['rspec']:
571 # display_rspec(results)
573 # display_list(results)
574 # if (opts.file is not None):
575 # rspec = slicemgr.list_nodes(user_cred)
576 # save_rspec_to_file(rspec, opts.file)
579 # list instantiated slices
580 def slices(opts, args):
582 user_cred = get_user_cred()
583 results = slicemgr.get_slices(user_cred)
584 display_list(results)
587 # show rspec for named slice
588 def resources(opts, args):
591 slice_cred = get_slice_cred(args[0])
592 result = slicemgr.get_resources(slice_cred, args[0])
594 user_cred = get_user_cred()
595 result = slicemgr.get_resources(user_cred)
597 display_rspec(result, format)
598 if (opts.file is not None):
599 save_rspec_to_file(result, opts.file)
602 # created named slice with given rspec
603 def create(opts, args):
606 slice_cred = get_slice_cred(slice_hrn)
607 rspec_file = get_rspec_file(args[1])
608 rspec=open(rspec_file).read()
609 return slicemgr.create_slice(slice_cred, slice_hrn, rspec)
612 def delete(opts, args):
615 slice_cred = get_slice_cred(slice_hrn)
617 return slicemgr.delete_slice(slice_cred, slice_hrn)
620 def start(opts, args):
623 slice_cred = get_slice_cred(args[0])
624 return slicemgr.start_slice(slice_cred, slice_hrn)
627 def stop(opts, args):
630 slice_cred = get_slice_cred(args[0])
631 return slicemgr.stop_slice(slice_cred, slice_hrn)
634 def reset(opts, args):
637 slice_cred = get_slice_cred(args[0])
638 return slicemgr.reset_slice(slice_cred, slice_hrn)
642 # Display, Save, and Filter RSpecs and Records
643 # - to be replace by EMF-generated routines
647 def display_rspec(rspec, format = 'rspec'):
648 if format in ['dns']:
650 spec.parseString(rspec)
652 nodespecs = spec.getDictsByTagName('NodeSpec')
653 for nodespec in nodespecs:
654 if nodespec.has_key('name') and nodespec['name']:
655 if isinstance(nodespec['name'], ListType):
656 hostnames.extend(nodespec['name'])
657 elif isinstance(nodespec['name'], StringTypes):
658 hostnames.append(nodespec['name'])
660 elif format in ['ip']:
662 spec.parseString(rspec)
664 ifspecs = spec.getDictsByTagName('IfSpec')
665 for ifspec in ifspecs:
666 if ifspec.has_key('addr') and ifspec['addr']:
667 ips.append(ifspec['addr'])
675 def display_list(results):
676 for result in results:
679 def save_rspec_to_file(rspec, filename):
680 if not filename.startswith(os.sep):
681 filename = sfi_dir + filename
682 if not filename.endswith(".rspec"):
683 filename = filename + ".rspec"
685 f = open(filename, 'w')
690 def display_records(recordList, dump = False):
691 ''' Print all fields in the record'''
692 for record in recordList:
693 display_record(record, dump)
695 def display_record(record, dump = False):
699 info = record.getdict()
700 print "%s (%s)" % (info['hrn'], info['type'])
703 def filter_records(type, records):
704 filtered_records = []
705 for record in records:
706 if (record.get_type() == type) or (type == "all"):
707 filtered_records.append(record)
708 return filtered_records
710 def save_records_to_file(filename, recordList):
712 for record in recordList:
714 save_record_to_file(filename + "." + str(index), record)
716 save_record_to_file(filename, record)
719 def save_record_to_file(filename, record):
720 if not filename.startswith(os.sep):
721 filename = sfi_dir + filename
722 str = record.save_to_string()
723 file(filename, "w").write(str)
726 def load_record_from_file(filename):
727 str = file(filename, "r").read()
728 record = GeniRecord(string=str)
731 if __name__=="__main__":