Changes between Version 6 and Version 7 of CredPrinterDocs

Timestamp:

Oct 6, 2011 11:11:50 AM (13 years ago)

Author:

faber

Comment:

--

CredPrinterDocs

@@ -195 +195 @@
     an integer, the [source:doc/API libabac return code] of the attempted conversion.  If this is non-zero, the '''str''' and '''auxstr''' contents are undefined.  ({{{cred_server.py}}} sets them to the empty string, but do not rely on that.)
 
+Attribute certificates include two additional fields containing the parsed contents of the head and tail of the credential.  These are in struct fields '''head''' and '''tail'''. Each of those structs containe between 2 and 4 of these fields, corresponding the the analogous Creddy fields:
+  '''principal'''::
+   the keyid of the principal (always prsent)
+  '''pretty_principal''':
+   the human-readable name of the principal (CN) if known, or the keyid if not (always present)
+  '''role''':
+   Simple role (no dots).  Present if a role is being assigned
+  '''linked_role''':
+   The linked role, present if a this is a linking role
+
 The output array is ''not'' guaranteed to be in the same order as the input array (and generally will not be).  Use the '''id''' member to match input and output.
 
@@ -202 +212 @@
 {{{
 [
-   {'credential': <xmlrpclib.Binary instance at 0x28b3dacc>, 'id': '000'}, 
-   {'credential': <xmlrpclib.Binary instance at 0x28b3db6c>, 'id': '001'}, 
-   {'credential': <xmlrpclib.Binary instance at 0x28b3db4c>, 'id': '002'}
+ {'credential': <xmlrpclib.Binary instance at 0x803667cb0>, 'id': '000'},
+ {'credential': <xmlrpclib.Binary instance at 0x803667cf8>, 'id': '001'},
+ {'credential': <xmlrpclib.Binary instance at 0x803667d40>, 'id': '002'},
+ {'credential': <xmlrpclib.Binary instance at 0x803667d88>, 'id': '003'}
 ]
 }}}
 
-Three dicts/structs are encoded with a serial number as id and the binary of the credential.
+Four dicts/structs are encoded with a serial number as id and the binary of the credential.
 
 Response
 {{{
 [
-   {'credential': <xmlrpclib.Binary instance at 0x28b3dacc>, 'errcode': 0, 'auxstr': 'Acme', 'str': '9b47d3669b99a4ce1d3a0055be002ea6a580041a', 'type': 'identity', 'id': '000'}, 
-   {'credential': <xmlrpclib.Binary instance at 0x28b3db6c>, 'errcode': 0, 'auxstr': 'Acme.partner <- f923e9f69d33b52d8bbdfd19f2ec89dde7beedd7', 'str': '9b47d3669b99a4ce1d3a0055be002ea6a580041a.partner <- f923e9f69d33b52d8bbdfd19f2ec89dde7beedd7', 'type': 'attribute', 'id': '001'}, 
-   {'credential': <xmlrpclib.Binary instance at 0x28b3db4c>, 'errcode': -1, 'auxstr': '', 'str': '', 'type': 'unknown', 'id': '002'}
+ {'auxstr': 'Acme',
+  'credential': <xmlrpclib.Binary instance at 0x803667cb0>,
+  'errcode': 0,
+  'id': '000',
+  'str': 'bb2f2f3544daa44f9f8f3b5cd2d8d71f6dc2974d',
+  'type': 'identity'},
+ {'auxstr': 'Acme.buy_rockets <- Acme.preferred_customer',
+  'credential': <xmlrpclib.Binary instance at 0x803667cf8>,
+  'errcode': 0,
+  'head': {'pretty_principal': 'Acme',
+           'principal': 'bb2f2f3544daa44f9f8f3b5cd2d8d71f6dc2974d',
+           'role': 'buy_rockets'},
+  'id': '001',
+  'str': 'bb2f2f3544daa44f9f8f3b5cd2d8d71f6dc2974d.buy_rockets <- bb2f2f3544daa44f9f8f3b5cd2d8d71f6dc2974d.preferred_customer',
+  'tail': {'pretty_principal': 'Acme',
+           'principal': 'bb2f2f3544daa44f9f8f3b5cd2d8d71f6dc2974d',
+           'role': 'preferred_customer'},
+  'type': 'attribute'},
+ {'auxstr': 'Acme.preferred_customer <- 9b2c1d0949e667a2264b200602aba5f3560e8404',
+  'credential': <xmlrpclib.Binary instance at 0x803667d40>,
+  'errcode': 0,
+  'head': {'pretty_principal': 'Acme',
+           'principal': 'bb2f2f3544daa44f9f8f3b5cd2d8d71f6dc2974d',
+           'role': 'preferred_customer'},
+  'id': '002',
+  'str': 'bb2f2f3544daa44f9f8f3b5cd2d8d71f6dc2974d.preferred_customer <- 9b2c1d0949e667a2264b200602aba5f3560e8404',
+  'tail': {'pretty_principal': '9b2c1d0949e667a2264b200602aba5f3560e8404',
+           'principal': '9b2c1d0949e667a2264b200602aba5f3560e8404'},
+  'type': 'attribute'},
+ {'auxstr': '',
+  'credential': <xmlrpclib.Binary instance at 0x803667d88>,
+  'errcode': -1,
+  'id': '003',
+  'str': '',
+  'type': 'unknown'}
 ]
 }}}
 
-The first dict/struct is an identity, the second an attribute, and the third an invalid certificate.
+The first dict/struct is an identity, the second and third are attributes, and the fourth an invalid certificate.