Definitions and Terminology in Section 9 - IdP

I have some comments and questions about terminology and naming in the Identity Provider APIs, Section 9.

I can’t figure out what is the different between an “identity assertion” (in the Section 9.2.3.1 definition of ‘assertion’) and a “payload of the identity assertion” (in the Section 9.2.3.3 definition of ‘contents’).  Are these the same thing?  I can’t seem to find a definition of either.

Section 5.7 of draft-ietf-rtcweb-security-arch-11 gives an example of ‘contents’ as:

     "contents": "{\"fingerprint\":[ ... ]}"

which seems to imply that it is the fingerprint from the SDP.

Section 5.6.6 of the I-D also gives this example of ‘assertion’:

     "assertion": "{\"identity\":\"bob@example.org\",
                    \"contents\":\"abcdefghijklmnopqrstuvwyz\",
                    \"signature\":\"010203040506\"

which seems to imply that ‘contents’ is a subset of ‘assertion’.  Is it required that the ‘contents’ object in the ‘assertion’ passed in validateAssertion be returned unchanged in the ‘contents’ object of the promise?

Where is normative definition of the structure of the “identity assertion” and the “payload of the identity assertion” and the 'contents' and 'assertion' objects defined?

Also, in Section 9, ‘payload’ means something very different from ‘payload’ in the rest of the document, where is usually refers to an RTP payload.  Choosing a different word here might reduce confusion.

Examples 4 and 5 at the end of Section 9 aren’t very helpful, either.

Am I just not finding the relevant text?

Thanks,
Alan

Received on Wednesday, 6 January 2016 23:12:39 UTC