Meeting Minutes 7 August 2019
Kantara FI-WG Teleconference
Approved on 2019-07-21 call
Date and Time
- Date: Wednesday, August 7, 2019
- Time: 16:30 EDT
Attendees
- Wessel, Keith (v)
- Roy, Nicholas (v)
- Bush, Judith (v)
- Cantor, Scott (v)
- Morgan, Andrew (v)
- Goodman, Eric
- Hoehn, Walter (v)
- Wallis, Colin
Agenda
- Roll call (QV group participation agreement)
- Agenda bash
- Approval of 7/17 meeting minutes
- Review of previous AIs:
- Walter: formatting revisions: https://github.com/KantaraInitiative/SAMLprofiles/pull/136
- Nick’s AI to update the disposition column on the feedback page: https://kantarainitiative.org/confluence/x/6IDJBg
- A couple of the items marked as accepted in the disposition column are waiting for revisions from Scott
- Issues 5 and 6 are done - email from Scott on July 23
- Rainer provided clarification on his feedback on SDP-SP23 in an email to the list dated 27 July
- Review of outstanding issues in Github
- Any further work needed on feedback received so far
Minutes
- Roll call (QV group participation agreement)
- Quorum achieved
- Agenda bash
- Administrivia: Colin mentioned that the work of this group is going to be noted in the Director’s Corner email and tweeted out later today
- Approval of 7/17 meeting minutes
- Judith motions to approve
- Walter seconds motion
- No opposition
- Minutes approved
- Review of previous AIs:
- Diffed the formatting of the implementation and deployment profiles, referred to Kantara formatting guide
- Larger questions came up:
- Recommendation: Use the first paragraph as the abstract. Start the introduction after that.
- AI: Walter will do this
- Link: https://kantarainitiative.github.io/SAMLprofiles/saml2int.html
- AI: Walter will add this as the location, we’ll use this until we get the final location just prior to approved publication
- Group should pick one of the four Kantara-approved IP agreements
- No reason we have to stick to what’s on the doc right now
- Probably the newest version of the CC share-alike attribution license would be the right way to go.
- AI: Walter will update accordingly - to cc-by-sa-4.0
- Scott is in favor of what’s there, or strike the Internet2 part, so just “copyright by its respective contributors, used under license”
- AI: Walter to change to this
- Walter suggests:
- Remove the ORCID
- Add the current authors to the top
- Put the legacy authors in an appendix
- Scott suggests:
- All authors in the appendix
- Keith and Nick agree
- No opposition to putting all authors in an appendix, it’s effectively what we have now. Just reference “see appendix” in the contributors section at the top.
- Judith notes that a paragraph of names at the beginning isn’t unusual in academia
- Keith suggests names/orgs of current contributors at the top of the doc. The appendix repeats that with orcids and email addresses at the end.
- Walter suggests removing email addresses.
- Keith says: Remove ORCID, email address, leave current and previous contributors at the top
- AI: Walter to do
- SAML v2.0 Deployment Profile for Federation Interoperability
- The group thinks these need to match
- Thank you Walter!
- AI: Walter rearrange to make these match
- If we made the notation and terminology sections as they are in the implementation profile, then all these would align across docs. Small amount of work to make this really clean.
- AI: Walter align
- Section titles:
- AI: Walter to do
- Change IdP and SP to be Identity Provider and Service Provider.
- Only use IdP/SP abbreviations in non-normative sections
- The sense is that the document contains a bit too many IdPs and SPs mentions to make it read well if they are all expanded.
- There is a normative references section and a non-normative references section. Is this necessary?
- Yes, keeping them separate is necessary.
- Could be two subsections.
- AI: Walter to break this into two sub-sections under a references section.
- There is now a blank Abstract section that must be populated.
- A blank Location section has been added. This will change just prior to final approval, but I think for now this should be pointed to the current location of the auto-rendered version, if there is such a thing.
- Please note that I changed the CC license to the same as the IP-FI. This may not be what everyone wants, but the Kantara boilerplate contains a list of "approved" licenses. I'm not sure what the process would be to use another, if that is desired.
- Is the copyright correct?
- Kantara requires a Contributors section on the "first page." Rendering what we have now at the top looks to me like a big mess. For the IP-FI, we pared the information down quite a bit, which is what I'd recommend. Other alternatives allowed by the Kantara boilerplate are to have the Contributors section link to the WG "Group Roster" page or to reference an appendix. I don't favor these approaches, although the appendix might be a reasonable solution for contributors to the old version.
- I/we need to figure out why asciidoctor is rendering the contributors section(s) inside the "ul" div, making the heading appear red and too small.
- Title discrepancy between implementation and deployment profiles. Words are flipped around. Seems less clear that they are peer documents meant to be used in tandem.
- Other things we could do to make these easier to read together
- Walter: formatting revisions: https://github.com/KantaraInitiative/SAMLprofiles/pull/136
- Walter should delete the old PR and just merge to master.
Next Meeting
- Date: Weds, Aug 7, 2019
- Time: 16:30 EDT
- Code: https://global.gotomeeting.com/join/110596309
You can also dial in using your phone.
United States: +1 (669) 224-3318
Access Code: 110-596-309
More phone numbers
Australia: +61 2 8355 1038
Austria: +43 1 2530 22500
Belgium: +32 28 93 7002
Canada: +1 (647) 497-9380
Denmark: +45 32 72 03 69
Finland: +358 923 17 0556
France: +33 170 950 590
Germany: +49 692 5736 7300
Ireland: +353 15 360 756
Italy: +39 0 230 57 81 80
Netherlands: +31 207 941 375
New Zealand: +64 9 282 9510
Norway: +47 21 93 37 37
Spain: +34 932 75 1230
Sweden: +46 853 527 818
Switzerland: +41 225 4599 60
United Kingdom: +44 330 221 0097
NOTE: Do not follow the code with a "#" symbol as it may cause the code not to be recognized.