<div dir="ltr">Hi Adam,<div>Thanks very much for doing this. I guess one question I have is whether events is an array of objects or a single object with name value pairs. The SET spec (rfc8417) seems to suggest it's a set of name-value pairs, the name defining the event name and the value being the event itself.</div><div><br></div><div>Atul</div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Wed, Jul 29, 2020 at 7:47 AM Adam Hampton via Openid-specs-risc <<a href="mailto:openid-specs-risc@lists.openid.net">openid-specs-risc@lists.openid.net</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
<div lang="EN-US">
<div class="gmail-m_5081221554395863529WordSection1">
<p class="MsoNormal"><span style="font-size:11pt">Good Morning,<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt"><u></u> <u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt">Recently I have been able to focus more full time on the SSE/CAEP efforts for SailPoint. I have been working on implementing a Java based object model for the JSON examples in Atul’s draft of “openid-sse-profile-draft2”
at (</span><a href="https://docs.google.com/document/d/15zf0kwJhrrteDW-wA8iMwTVFQo2CK6kKK5kNq2IkLuM" target="_blank">https://docs.google.com/document/d/15zf0kwJhrrteDW-wA8iMwTVFQo2CK6kKK5kNq2IkLuM</a><span style="font-size:11pt">). I’ve added some questions and comments
in that document related to the JSON examples. I realize that Java is only one of many languages that the standard will be implemented in and my primary concerns are that the examples show tested, verified JSON examples that are conformant to the relevant
JSON specs.<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt"><u></u> <u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt">As currently drafted the examples show two things that are concerning:<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt"><u></u> <u></u></span></p>
<ul style="margin-top:0in" type="disc">
<li class="gmail-m_5081221554395863529MsoListParagraph" style="margin-left:0in"><span style="font-size:11pt">Using event type as a key field name for an event in a list of events. When multiple events of the same type are shipped in one SET this would require
JSON parsers to accept repeated field names, which many do not. This can be seen in figures 1 and 2, and others, of the doc.<u></u><u></u></span></li><li class="gmail-m_5081221554395863529MsoListParagraph" style="margin-left:0in"><span style="font-size:11pt">Using singleton bodies in place of arrays where for the list of Events when the SET only contains a single Event. While many parsers support treating
a singleton as a member of a list of size one, not all parsers do and we should probably not show that deviation from well-formed JSON as an example. This can be seen also in figures 1, 2 and others in the doc.<u></u><u></u></span></li></ul>
<p class="MsoNormal"><span style="font-size:11pt"><u></u> <u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt">I’ve built an object model, parser and pretty printer using Java’s Jackson JSON parser which produces clean JSON from Atul’s example data. I’ve pasted them below. I would like to discuss the formatting differences
on the next call and propose these examples for figures 1 through 5 get substituted into for what is in the draft today. I would also like to delve deeper into the Transmitter Config response JSON fields on the next call.<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt"><u></u> <u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"># Draft Figure 1, 'SET Containing a SSE Event with an Email Subject Identifier', page 6 top:<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier">{<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> "iss" : "<a href="https://idp.example.com/" target="_blank">https://idp.example.com/</a>",<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> "iat" : 1596032109225,<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> "jti" : "756E69717565206964656E746966696572",<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> "aud" : "636C69656E745F6964",<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> "events" : [ {<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> "subject" : {<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> "subject_type" : "email",<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> "subject" : "<a href="mailto:foo@example.com" target="_blank">foo@example.com</a>"<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> },<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> "type" : "<a href="https://schemas.openid.net/secevent/risc/event-type/account-enabled" target="_blank">https://schemas.openid.net/secevent/risc/event-type/account-enabled</a>"<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> } ]<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier">}<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"><u></u> <u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"># Draft Figure 2, 'Example SET', page 6 bottom:<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier">{<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> "iss" : "<a href="https://idp.example.com/" target="_blank">https://idp.example.com/</a>",<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> "iat" : 1596032109393,<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> "jti" : "756E69717565206964656E746966696572",<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> "aud" : "636C69656E745F6964",<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> "events" : [ {<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> "subject" : {<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> "subject_type" : "iss_sub",<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> "iss" : "<a href="https://issuer.example.com/" target="_blank">https://issuer.example.com/</a>",<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> "subject" : "abc1234"<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> },<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> "type" : "<a href="https://schemas.openid.net/secevent/risc/event-type/account-enabled" target="_blank">https://schemas.openid.net/secevent/risc/event-type/account-enabled</a>"<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> } ]<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier">}<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"><u></u> <u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"># Draft Figure 3, 'Example SET', page 7 top:<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier">{<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> "iss" : "<a href="https://sp.example2.com/" target="_blank">https://sp.example2.com/</a>",<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> "iat" : 1596032109395,<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> "jti" : "756E69717565206964656E746966696572",<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> "aud" : "636C69656E745F6964",<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> "events" : [ {<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> "subject" : {<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> "subject_type" : "email",<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> "subject" : "<a href="mailto:foo@example.com" target="_blank">foo@example.com</a>"<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> },<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> "type" : "<a href="https://schemas.openid.net/secevent/risc/event-type/ip-address-changed" target="_blank">https://schemas.openid.net/secevent/risc/event-type/ip-address-changed</a>",<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> "ip_address" : "123.45.67.89"<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> } ]<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier">}<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"><u></u> <u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"># Draft Figure 4, 'SET Containing a SSE Event with a SPAG Subject Type', page 7 bottom:<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier">{<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> "iss" : "<a href="https://sp.example2.com/" target="_blank">https://sp.example2.com/</a>",<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> "iat" : 1596032109397,<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> "jti" : "756E69717565206964656E746966696572",<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> "aud" : "636C69656E745F6964",<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> "events" : [ {<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> "subject" : {<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> "subject_type" : "spag",<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> "spag_id" : "<a href="https://example.com/v2/Groups/e9e30dba-f08f-4109-8486-d5c6a331660a" target="_blank">https://example.com/v2/Groups/e9e30dba-f08f-4109-8486-d5c6a331660a</a>"<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> },<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> "type" : "<a href="https://schemas.openid.net/secevent/risc/event-type/ip-address-changed" target="_blank">https://schemas.openid.net/secevent/risc/event-type/ip-address-changed</a>"<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> } ]<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier">}<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"><u></u> <u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"># Draft Figure 5, 'SET Containing a SSE Event with Common Claims in the Subject', page 8 top:<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier">{<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> "iss" : "<a href="https://sp.example2.com/" target="_blank">https://sp.example2.com/</a>",<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> "iat" : 1596032109399,<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> "jti" : "756E69717565206964656E746966696572",<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> "aud" : "636C69656E745F6964",<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> "events" : [ {<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> "subject" : {<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> "subject_type" : "id_token_claims",<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> "spag_id" : "<a href="https://example.com/v2/Groups/e9e30dba-f08f-4109-8486-d5c6a331660a" target="_blank">https://example.com/v2/Groups/e9e30dba-f08f-4109-8486-d5c6a331660a</a>",<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> "category" : "device",<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> "phone_number" : "<a href="tel:(408)%20555-1212" value="+14085551212" target="_blank">+1 (408) 555-1212</a>"<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> },<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> "type" : "<a href="https://schemas.openid.net/secevent/risc/event-type/ip-address-changed" target="_blank">https://schemas.openid.net/secevent/risc/event-type/ip-address-changed</a>"<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> } ]<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier">}<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"><u></u> <u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier">TransmitterConfig JSON example:<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier">{<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> "issuer" : "<a href="https://ssedemo.identitynow.com" target="_blank">https://ssedemo.identitynow.com</a>",<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> "jwks_uri" : "<a href="https://ssedemo.identitynow.com/jwks" target="_blank">https://ssedemo.identitynow.com/jwks</a>",<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> "configuration_endpoint" : "<a href="https://ssedemo.identitynow.com/config" target="_blank">https://ssedemo.identitynow.com/config</a>",<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> "delivery_methods_supported" : [ "https" ],<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> "status_endpoint" : "<a href="https://ssedemo.identitynow.com/status" target="_blank">https://ssedemo.identitynow.com/status</a>",<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> "verification_endpoint" : "<a href="https://ssedemo.identitynow.com/verify" target="_blank">https://ssedemo.identitynow.com/verify</a>",<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> "add_subject_endpoint" : "<a href="https://ssedemo.identitynow.com/addSubject" target="_blank">https://ssedemo.identitynow.com/addSubject</a>",<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> "remove_subject_endpoint" : "<a href="https://ssedemo.identitynow.com/removeSubject" target="_blank">https://ssedemo.identitynow.com/removeSubject</a>",<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier"> "supported_versions" : "1.0"<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Courier">}<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt"><u></u> <u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt"><u></u> <u></u></span></p>
<p class="MsoNormal">Thanks and Best Regards,<u></u><u></u></p>
<p class="MsoNormal">--<span style="font-size:11pt"><u></u><u></u></span></p>
<p class="MsoNormal"><b><span style="font-size:10pt;font-family:Arial,sans-serif">Adam Hampton</span></b><span style="font-size:11pt;font-family:Arial,sans-serif"><br>
</span><i><span style="font-size:9pt;font-family:Arial,sans-serif">Principal Engineer</span></i><span style="font-size:9pt;font-family:Arial,sans-serif">
<br>
</span><a href="https://www.sailpoint.com/" target="_blank"><span style="font-size:9pt;font-family:Arial,sans-serif;color:blue;text-decoration:none"><img border="0" width="170" height="41" style="width: 1.7708in; height: 0.427in;" id="gmail-m_5081221554395863529_x0000_i1026" src="https://i.xink.io/Images/Get/N9791/s4.png"></span></a><span style="font-size:9pt;font-family:Arial,sans-serif"><br>
<span style="color:rgb(0,181,226)"><a href="mailto:adam.hampton@sailpoint.com" target="_blank"><span style="color:rgb(0,181,226);text-decoration:none">adam.hampton@sailpoint.com</span></a>
</span><br>
<span style="color:rgb(0,181,226)"><a href="https://www.sailpoint.com/company/careers/" target="_blank"><span style="color:rgb(0,181,226);text-decoration:none">Join the #SailPointCrew</span></a></span></span><span style="font-size:11pt"><br>
</span><a href="https://www.sailpoint.com/" target="_blank"><span style="font-size:11pt;color:blue;text-decoration:none"><img border="0" width="500" height="120" style="width: 5.2083in; height: 1.25in;" id="gmail-m_5081221554395863529_x0000_i1025" src="https://i.xink.io/Images/Get/N9791/s3.png" alt="The Power of Identity - SailPoint Email Signature"></span></a><u></u><u></u></p>
</div>
</div>
_______________________________________________<br>
Openid-specs-risc mailing list<br>
<a href="mailto:Openid-specs-risc@lists.openid.net" target="_blank">Openid-specs-risc@lists.openid.net</a><br>
<a href="http://lists.openid.net/mailman/listinfo/openid-specs-risc" rel="noreferrer" target="_blank">http://lists.openid.net/mailman/listinfo/openid-specs-risc</a><br>
</blockquote></div>