Skip to main content

Handling of Identity Header Errors for Secure Telephone Identity Revisited (STIR)
draft-ietf-stir-identity-header-errors-handling-08

Revision differences

Document history

Date Rev. By Action
2024-01-26
08 Gunter Van de Velde Request closed, assignment withdrawn: Tina Tsou Last Call OPSDIR review
2024-01-26
08 Gunter Van de Velde Closed request for Last Call review by OPSDIR with state 'Overtaken by Events': Cleaning up stale OPSDIR queue
2023-07-26
08 (System) RFC Editor state changed to AUTH48-DONE from AUTH48
2023-07-11
08 (System) RFC Editor state changed to AUTH48
2023-05-25
08 (System) RFC Editor state changed to RFC-EDITOR from EDIT
2023-04-13
08 (System) IANA Action state changed to RFC-Ed-Ack from Waiting on RFC Editor
2023-04-13
08 (System) IANA Action state changed to Waiting on RFC Editor from In Progress
2023-04-13
08 (System) IANA Action state changed to In Progress from Waiting on Authors
2023-04-05
08 (System) IANA Action state changed to Waiting on Authors
2023-03-29
08 Tero Kivinen Closed request for Last Call review by SECDIR with state 'Overtaken by Events'
2023-03-29
08 Tero Kivinen Assignment of request for Last Call review by SECDIR to Richard Barnes was marked no-response
2023-03-29
08 (System) RFC Editor state changed to EDIT
2023-03-29
08 (System) IESG state changed to RFC Ed Queue from Approved-announcement sent
2023-03-29
08 (System) Announcement was received by RFC Editor
2023-03-28
08 Cindy Morgan IESG state changed to Approved-announcement sent from Approved-announcement to be sent
2023-03-28
08 Cindy Morgan IESG has approved the document
2023-03-28
08 Cindy Morgan Closed "Approve" ballot
2023-03-28
08 Cindy Morgan Ballot approval text was generated
2023-03-27
08 Murray Kucherawy IESG state changed to Approved-announcement to be sent from Approved-announcement sent
2023-03-15
08 Russ Housley Added to session: IETF-116: stir  Wed-0630
2023-03-01
08 Murray Kucherawy IESG state changed to Approved-announcement sent from Approved-announcement to be sent::AD Followup
2023-02-25
08 Chris Wendt New version available: draft-ietf-stir-identity-header-errors-handling-08.txt
2023-02-25
08 Chris Wendt New version accepted (logged-in submitter: Chris Wendt)
2023-02-25
08 Chris Wendt Uploaded new revision
2023-01-24
07 Sabrina Tanamal IANA Experts State changed to Expert Reviews OK from Reviews assigned
2023-01-24
07 Sabrina Tanamal IANA Review state changed to IANA OK - Actions Needed from IANA - Not OK
2022-12-04
07 Murray Kucherawy Awaiting resolution of IANA review (showing "Not OK").
2022-12-01
07 (System) Removed all action holders (IESG state changed)
2022-12-01
07 Cindy Morgan IESG state changed to Approved-announcement to be sent::AD Followup from IESG Evaluation
2022-12-01
07 Francesca Palombini
[Ballot comment]
Thank you for the work on this document.

Many thanks to Martin Dürst for his ART ART review: https://mailarchive.ietf.org/arch/msg/art/Jqiy69abgnAMBuSH7oLpt1Ae62I/, and to the …
[Ballot comment]
Thank you for the work on this document.

Many thanks to Martin Dürst for his ART ART review: https://mailarchive.ietf.org/arch/msg/art/Jqiy69abgnAMBuSH7oLpt1Ae62I/, and to the author for addressing his comments.
2022-12-01
07 Francesca Palombini [Ballot Position Update] New position, No Objection, has been recorded for Francesca Palombini
2022-11-30
07 Paul Wouters
[Ballot comment]
# Sec AD review of draft-ietf-stir-identity-header-errors-handling-07

CC @paulwouters

See https://www.ietf.org/about/groups/iesg/statements/handling-ballot-positions
for more information about how to handle DISCUSS and COMMENT positions.

This review …
[Ballot comment]
# Sec AD review of draft-ietf-stir-identity-header-errors-handling-07

CC @paulwouters

See https://www.ietf.org/about/groups/iesg/statements/handling-ballot-positions
for more information about how to handle DISCUSS and COMMENT positions.

This review uses the format specified in https://github.com/mnot/ietf-comments/
which allows automated tools to process items (eg to produce github issers)

## Comments

### "ppi" parameter

```
  The association of a Reason header field
  and error to a specific Identity header field is accomplished by
  adding a PASSporT identifier, "ppi", parameter containing the
  PASSporT string as an identifier for the identity header and
  corresponding PASSporT that generated the error to the Reason header
  field.  The "ppi" parameter for the Reason header field is
  RECOMMENDED in particular [...]
```
It feels like the "is accomplished" really means the "ppi" parameter MUST
be used, yet further on it states the "ppi parameter" is only RECOMMENDED ?
Should this RECOMMENDED not be REQUIRED? Also the construct of
"RECOMMENDED in particular" is a little odd.

Why not:

For a SIP INVITE containing multiple Identity header fields, the
"ppi" parameter for the Reason header field is REQUIRED.


### 7 lines is a lot for a single sentence

```
  In cases where local policy dictates that a call should continue
  regardless of any verification errors that may have occured,
  including 4XX errors described in [RFC8224] Section 6.2.2, then the
  verification service MUST NOT send the 4XX as a response, but rather
  include the error response code and reason phrase in a Reason header
  field, defined in [RFC3326], in the next provisional or final
  responses sent to the authentication service.
```

This sentence does not parse (due to the ", then the"). It is also 7 lines
long so it would improve readability to split this in various sentences.
2022-11-30
07 Paul Wouters [Ballot Position Update] New position, No Objection, has been recorded for Paul Wouters
2022-11-30
07 Martin Duke [Ballot Position Update] New position, No Objection, has been recorded for Martin Duke
2022-11-30
07 Amanda Baber IANA Review state changed to IANA - Not OK from Version Changed - Review Needed
2022-11-30
07 Andrew Alston [Ballot Position Update] New position, No Objection, has been recorded for Andrew Alston
2022-11-29
07 John Scudder
[Ballot comment]
Thanks for this short, readable, and to the point document.

I did find a couple of nits. In both cases I leave it …
[Ballot comment]
Thanks for this short, readable, and to the point document.

I did find a couple of nits. In both cases I leave it to you to decide if a change is called for, no need to reply.

1. In Section 5, I had trouble with this sentence:

"As implied and defined in [RFC8224], error codes associated with STIR targeted at authentication services that produced a specific identity header field represent a single error occurring with the verification and processing of that identity header field."

I'm willing to believe that for someone expert in STIR, SIP, et al, that sentence might be parsable into something that makes sense. It defied me, though, so I mention it in case you want to re-word it.

2. In Section 6, isn't this a comma splice and it should really be two sentences?

"As mentioned previously, the potential use of multiple Reason header fields defined in [RFC3326] is updated in [I-D.ietf-sipcore-multiple-reasons] allowing multiple Reason header fields with the same protocol value, for this specification "STIR" should be used for any STIR error defined in [RFC8224] or future specifications."
2022-11-29
07 John Scudder [Ballot Position Update] New position, No Objection, has been recorded for John Scudder
2022-11-25
07 Robert Wilton [Ballot Position Update] New position, No Objection, has been recorded for Robert Wilton
2022-11-24
07 Éric Vyncke
[Ballot comment]

# Éric Vyncke, INT AD, comments for draft-ietf-stir-identity-header-errors-handling-07

CC @evyncke

Thank you for the work put into this document.

Please find below one …
[Ballot comment]

# Éric Vyncke, INT AD, comments for draft-ietf-stir-identity-header-errors-handling-07

CC @evyncke

Thank you for the work put into this document.

Please find below one nit.

Special thanks to Ben Campbell for the shepherd's detailed write-up including the WG consensus and the justification of the intended status.

I hope that this review helps to improve the document,

Regards,

-éric


## NITS

### Placement of ';' in the examples

Just to exhibit my lack of SIP/STIR knowledge, I was wondering about the placement of ';' in the different examples, e.g.,
```
Reason: STIR ;cause=436 ;text
Reason: STIR ;cause=438 ; text
```

I guess that this is not a SIP violation but it looks weird to the reader.

## Notes

This review is in the ["IETF Comments" Markdown format][ICMF], You can use the
[`ietf-comments` tool][ICT] to automatically convert this review into
individual GitHub issues.

[ICMF]: https://github.com/mnot/ietf-comments/blob/main/format.md
[ICT]: https://github.com/mnot/ietf-comments
2022-11-24
07 Éric Vyncke [Ballot Position Update] New position, No Objection, has been recorded for Éric Vyncke
2022-11-22
07 Roman Danyliw [Ballot Position Update] New position, No Objection, has been recorded for Roman Danyliw
2022-11-21
07 Erik Kline [Ballot Position Update] New position, No Objection, has been recorded for Erik Kline
2022-11-08
07 Cindy Morgan Placed on agenda for telechat - 2022-12-01
2022-11-08
07 Murray Kucherawy Ballot has been issued
2022-11-08
07 Murray Kucherawy [Ballot Position Update] New position, Yes, has been recorded for Murray Kucherawy
2022-11-08
07 Murray Kucherawy Created "Approve" ballot
2022-11-08
07 Murray Kucherawy IESG state changed to IESG Evaluation from Waiting for Writeup
2022-11-08
07 Murray Kucherawy Ballot writeup was changed
2022-11-07
07 Chris Wendt New version available: draft-ietf-stir-identity-header-errors-handling-07.txt
2022-11-07
07 Chris Wendt New version accepted (logged-in submitter: Chris Wendt)
2022-11-07
07 Chris Wendt Uploaded new revision
2022-11-07
06 (System) IANA Review state changed to Version Changed - Review Needed from IANA - Not OK
2022-11-07
06 Chris Wendt New version available: draft-ietf-stir-identity-header-errors-handling-06.txt
2022-11-07
06 Chris Wendt New version accepted (logged-in submitter: Chris Wendt)
2022-11-07
06 Chris Wendt Uploaded new revision
2022-11-04
05 Stewart Bryant Request for Last Call review by GENART Completed: Ready. Reviewer: Stewart Bryant. Sent review to list.
2022-11-04
05 Martin Dürst Request for Last Call review by ARTART Completed: Ready with Issues. Reviewer: Martin Dürst. Sent review to list.
2022-11-03
05 Sabrina Tanamal IANA Experts State changed to Reviews assigned
2022-11-03
05 (System) IANA Review state changed to IANA - Not OK from IANA - Review Needed
2022-11-03
05 Sabrina Tanamal
(Via drafts-lastcall@iana.org): IESG/Authors/WG Chairs:

The IANA Functions Operator has completed its review of draft-ietf-stir-identity-header-errors-handling-05. If any part of this review is inaccurate, please let …
(Via drafts-lastcall@iana.org): IESG/Authors/WG Chairs:

The IANA Functions Operator has completed its review of draft-ietf-stir-identity-header-errors-handling-05. If any part of this review is inaccurate, please let us know.

We understand that, upon approval of this document, there are two actions which we must complete.

First, in the Reason Protocols registry on the Session Initiation Protocol (SIP) Parameters registry page located at:

https://www.iana.org/assignments/sip-parameters/

a new registration is to be made as follows:

Protocol Value: STIR
Protocol Cause: STIR Error Code
Reference: [RFC8224]

As this document requests registrations in a Specification Required (see RFC 8126) registry, we will initiate the required Expert Review via a separate request. This review must be completed before the document's IANA state can be changed to "IANA OK."

Second, in the Header Field Parameters and Parameter Values registry also on the Session Initiation Protocol (SIP) Parameters registry page located at:

https://www.iana.org/assignments/sip-parameters/

a new registration is to be made as follows:

Header Field: Reason
Parameter Name: ppi
Predefined Values: No
Reference: [ RFC-to-be ]

The IANA Functions Operator understands that these are the only actions required to be completed upon approval of this document.

Note:  The actions requested in this document will not be completed until the document has been approved for publication as an RFC. This message is meant only to confirm the list of actions that will be performed.

For definitions of IANA review states, please see:

https://datatracker.ietf.org/help/state/draft/iana-review

Thank you,

Sabrina Tanamal
Lead IANA Services Specialist
2022-11-03
05 (System) IESG state changed to Waiting for Writeup from In Last Call
2022-10-30
05 Tero Kivinen Request for Last Call review by SECDIR is assigned to Richard Barnes
2022-10-30
05 Tero Kivinen Request for Last Call review by SECDIR is assigned to Richard Barnes
2022-10-25
05 Gunter Van de Velde Request for Last Call review by OPSDIR is assigned to Tina Tsou
2022-10-25
05 Gunter Van de Velde Request for Last Call review by OPSDIR is assigned to Tina Tsou
2022-10-22
05 Barry Leiba Request for Last Call review by ARTART is assigned to Martin Dürst
2022-10-22
05 Barry Leiba Request for Last Call review by ARTART is assigned to Martin Dürst
2022-10-20
05 Jean Mahoney Request for Last Call review by GENART is assigned to Stewart Bryant
2022-10-20
05 Jean Mahoney Request for Last Call review by GENART is assigned to Stewart Bryant
2022-10-20
05 Cindy Morgan IANA Review state changed to IANA - Review Needed
2022-10-20
05 Cindy Morgan
The following Last Call announcement was sent out (ends 2022-11-03):

From: The IESG
To: IETF-Announce
CC: ben@nostrum.com, draft-ietf-stir-identity-header-errors-handling@ietf.org, stir-chairs@ietf.org, stir@ietf.org, superuser@gmail.com …
The following Last Call announcement was sent out (ends 2022-11-03):

From: The IESG
To: IETF-Announce
CC: ben@nostrum.com, draft-ietf-stir-identity-header-errors-handling@ietf.org, stir-chairs@ietf.org, stir@ietf.org, superuser@gmail.com
Reply-To: last-call@ietf.org
Sender:
Subject: Last Call:  (Identity Header Errors Handling) to Proposed Standard


The IESG has received a request from the Secure Telephone Identity Revisited
WG (stir) to consider the following document: - 'Identity Header Errors
Handling'
  as Proposed
  Standard

The IESG plans to make a decision in the next few weeks, and solicits final
comments on this action. Please send substantive comments to the
last-call@ietf.org mailing lists by 2022-11-03. Exceptionally, comments may
be sent to iesg@ietf.org instead. In either case, please retain the beginning
of the Subject line to allow automated sorting.

Abstract


  This document extends STIR and the Authenticated Identity Management
  in the Session Initiation Protocol (SIP) error handling procedures to
  include the mapping of verification failure reasons to STIR defined
  4xx codes so the failure reason of an Identity header field can be
  conveyed to the upstream authentication service when local policy
  dictates that the call should continue in the presence of a
  verification failure.  This document also defines procedures that
  enable a failure reason to be mapped to a specific Identity header
  for scenarios that use multiple Identity header fields where some may
  have errors and others may not and the handling of those situations
  is defined.




The file can be obtained via
https://datatracker.ietf.org/doc/draft-ietf-stir-identity-header-errors-handling/



No IPR declarations have been submitted directly on this I-D.




2022-10-20
05 Cindy Morgan IESG state changed to In Last Call from Last Call Requested
2022-10-20
05 Cindy Morgan Last call announcement was generated
2022-10-19
05 Murray Kucherawy Last call was requested
2022-10-19
05 Murray Kucherawy Ballot approval text was generated
2022-10-19
05 Murray Kucherawy Ballot writeup was generated
2022-10-19
05 Murray Kucherawy IESG state changed to Last Call Requested from AD Evaluation
2022-10-19
05 Murray Kucherawy Last call announcement was generated
2022-10-16
05 (System) Changed action holders to Murray Kucherawy (IESG state changed)
2022-10-16
05 Murray Kucherawy IESG state changed to AD Evaluation from Publication Requested
2022-10-11
05 Ben Campbell
# Document Shepherd Write-Up for Group Documents

*This version is dated 4 July 2022.*


## Document History

1. Does the working group (WG) consensus represent …
# Document Shepherd Write-Up for Group Documents

*This version is dated 4 July 2022.*


## Document History

1. Does the working group (WG) consensus represent the strong concurrence of a
  few individuals, with others being silent, or did it reach broad agreement?
 
  There was general agreement among a fairly small group of STIR participants.
  This group included people with SIP and STIR implementation experience.

2. Was there controversy about particular points, or were there decisions where
  the consensus was particularly rough?
 
  There was no significant controversy. There were some architectural questions
  and some questions about potential privacy leaks that that were worked
  through to consensus. One participant questioned whether the mechanism
  could be deployed in practice, but most active participants did not see a
  problem.

3. Has anyone threatened an appeal or otherwise indicated extreme discontent? If
  so, please summarize the areas of conflict in separate email messages to the
  responsible Area Director. (It should be in a separate email because this
  questionnaire is publicly available.)
 
  No one has threatened an appeal or expressed extreme discontent.

4. For protocol documents, are there existing implementations of the contents of
  the document? Have a significant number of potential implementers indicated
  plans to implement? Are any existing implementations reported somewhere,
  either in the document itself (as [RFC 7942][3] recommends) or elsewhere
  (where)?
 
  The shepherd is not aware of existing implementations. However, this work is
  likely to be adopted by the ATIS/SIP Forum IP-NNI task force, which will
  likely result in wide-spread implementation in the voice service provider
  community.

## Additional Reviews

5. Do the contents of this document closely interact with technologies in other
  IETF working groups or external organizations, and would it therefore benefit
  from their review? Have those reviews occurred? If yes, describe which
  reviews took place.
 
  This work, like all work in STIR, is closely related to SIP, which is
  maintained by SIPCORE. However, there is enough cross-participation between
  the groups that a separate review in SIPCORE is probably not needed. There
  is a companion draft to this work in SIP
  [draft-ietf-sipcore-multiple-reasons].
 
6. Describe how the document meets any required formal expert review criteria,
  such as the MIB Doctor, YANG Doctor, media type, and URI type reviews.
 
  The only additional expert review required is for registration of a new
  "Reason Protocol" in the IANA Session Initiation Protocol (SIP) Parameters
  registry. The registration procedure is "Specification Required"

7. If the document contains a YANG module, has the final version of the module
  been checked with any of the [recommended validation tools][4] for syntax and
  formatting validation? If there are any resulting errors or warnings, what is
  the justification for not fixing them at this time? Does the YANG module
  comply with the Network Management Datastore Architecture (NMDA) as specified
  in [RFC 8342][5]?
 
  The document does not contain a YANG module.

8. Describe reviews and automated checks performed to validate sections of the
  final version of the document written in a formal language, such as XML code,
  BNF rules, MIB definitions, CBOR's CDDL, etc.
 
  The draft does not use formal languages.

## Document Shepherd Checks

9. Based on the shepherd's review of the document, is it their opinion that this
  document is needed, clearly written, complete, correctly designed, and ready
  to be handed off to the responsible Area Director?
 
  In the shepherd's opinion, this document is ready to be handed off to the AD.
  The shepherd found a small number of non-substantive nits that have been
  shared with the author and do not need to block progress. They can wait
  for the next update opportunity.

10. Several IETF Areas have assembled [lists of common issues that their
    reviewers encounter][6]. For which areas have such issues been identified
    and addressed? For which does this still need to happen in subsequent
    reviews?
   
    The shepherd finds no such issues.

11. What type of RFC publication is being requested on the IETF stream ([Best
    Current Practice][12], [Proposed Standard, Internet Standard][13],
    [Informational, Experimental or Historic][14])? Why is this the proper type
    of RFC? Do all Datatracker state attributes correctly reflect this intent
   
    The intended status is Proposed Standard. It describes an extension for
    error reporting for STIR, which is comprises multiple Proposed Standards.
    This is correctly reflected in the datatracker.

12. Have reasonable efforts been made to remind all authors of the intellectual
    property rights (IPR) disclosure obligations described in [BCP 79][7]? To
    the best of your knowledge, have all required disclosures been filed? If
    not, explain why. If yes, summarize any relevant discussion, including links
    to publicly-available messages when applicable.
   
    The author has explicitly confirmed that all IPR
    disclosures required for full conformance with the provisions of
    BCP 78 and BCP 79 have already been filed.  There are none.

13. Has each author, editor, and contributor shown their willingness to be
    listed as such? If the total number of authors and editors on the front page
    is greater than five, please provide a justification.
   
    This draft has a single author, whose willingness to be listed is implied
    by the submission of the draft. But the author has explicitly confirmed,
    anyway.

14. Document any remaining I-D nits in this document. Simply running the [idnits
    tool][8] is not enough; please review the ["Content Guidelines" on
    authors.ietf.org][15]. (Also note that the current idnits tool generates
    some incorrect warnings; a rewrite is underway.)
   
    The document shepherd review of the document did not find any
    issues related to the Guidelines to Authors of Internet-Drafts.


15. Should any informative references be normative or vice-versa? See the [IESG
    Statement on Normative and Informative References][16].
   
    All references are properly normative.

16. List any normative references that are not freely available to anyone. Did
    the community have sufficient access to review any such normative
    references?
   
    All references are IETF RFCs or drafts

17. Are there any normative downward references (see [RFC 3967][9] and [BCP
    97
][10]) that are not already listed in the [DOWNREF registry][17]? If so,
    list them.
   
    There are no downward references.

18. Are there normative references to documents that are not ready to be
    submitted to the IESG for publication or are otherwise in an unclear state?
    If so, what is the plan for their completion?
   
    The only unpublished dependency is draft-ietf-sipcore-multiple-reasons,
    which has already been submitted to the IESG.

19. Will publication of this document change the status of any existing RFCs? If
    so, does the Datatracker metadata correctly reflect this and are those RFCs
    listed on the title page, in the abstract, and discussed in the
    introduction? If not, explain why and point to the part of the document
    where the relationship of this document to these other RFCs is discussed.
   
    This draft does not affect the status of any existing RFC.

20. Describe the document shepherd's review of the IANA considerations section,
    especially with regard to its consistency with the body of the document.
    Confirm that all aspects of the document requiring IANA assignments are
    associated with the appropriate reservations in IANA registries. Confirm
    that any referenced IANA registries have been clearly identified. Confirm
    that each newly created IANA registry specifies its initial contents,
    allocations procedures, and a reasonable name (see [RFC 8126][11]).
   
    The shepherd has reviewed the IANA considerations and confirms all the
    above.

21. List any new IANA registries that require Designated Expert Review for
    future allocations. Are the instructions to the Designated Expert clear?
    Please include suggestions of designated experts, if appropriate.
   
    This draft does not create new registries.

2022-10-11
05 Ben Campbell Responsible AD changed to Murray Kucherawy
2022-10-11
05 Ben Campbell IETF WG state changed to Submitted to IESG for Publication from In WG Last Call
2022-10-11
05 Ben Campbell IESG state changed to Publication Requested from I-D Exists
2022-10-11
05 Ben Campbell IESG process started in state Publication Requested
2022-10-11
05 Ben Campbell This document now replaces draft-wendt-stir-identity-header-errors-handling instead of None
2022-10-11
05 Ben Campbell
# Document Shepherd Write-Up for Group Documents

*This version is dated 4 July 2022.*


## Document History

1. Does the working group (WG) consensus represent …
# Document Shepherd Write-Up for Group Documents

*This version is dated 4 July 2022.*


## Document History

1. Does the working group (WG) consensus represent the strong concurrence of a
  few individuals, with others being silent, or did it reach broad agreement?
 
  There was general agreement among a fairly small group of STIR participants.
  This group included people with SIP and STIR implementation experience.

2. Was there controversy about particular points, or were there decisions where
  the consensus was particularly rough?
 
  There was no significant controversy. There were some architectural questions
  and some questions about potential privacy leaks that that were worked
  through to consensus. One participant questioned whether the mechanism
  could be deployed in practice, but most active participants did not see a
  problem.

3. Has anyone threatened an appeal or otherwise indicated extreme discontent? If
  so, please summarize the areas of conflict in separate email messages to the
  responsible Area Director. (It should be in a separate email because this
  questionnaire is publicly available.)
 
  No one has threatened an appeal or expressed extreme discontent.

4. For protocol documents, are there existing implementations of the contents of
  the document? Have a significant number of potential implementers indicated
  plans to implement? Are any existing implementations reported somewhere,
  either in the document itself (as [RFC 7942][3] recommends) or elsewhere
  (where)?
 
  The shepherd is not aware of existing implementations. However, this work is
  likely to be adopted by the ATIS/SIP Forum IP-NNI task force, which will
  likely result in wide-spread implementation in the voice service provider
  community.

## Additional Reviews

5. Do the contents of this document closely interact with technologies in other
  IETF working groups or external organizations, and would it therefore benefit
  from their review? Have those reviews occurred? If yes, describe which
  reviews took place.
 
  This work, like all work in STIR, is closely related to SIP, which is
  maintained by SIPCORE. However, there is enough cross-participation between
  the groups that a separate review in SIPCORE is probably not needed. There
  is a companion draft to this work in SIP
  [draft-ietf-sipcore-multiple-reasons].
 
6. Describe how the document meets any required formal expert review criteria,
  such as the MIB Doctor, YANG Doctor, media type, and URI type reviews.
 
  The only additional expert review required is for registration of a new
  "Reason Protocol" in the IANA Session Initiation Protocol (SIP) Parameters
  registry. The registration procedure is "Specification Required"

7. If the document contains a YANG module, has the final version of the module
  been checked with any of the [recommended validation tools][4] for syntax and
  formatting validation? If there are any resulting errors or warnings, what is
  the justification for not fixing them at this time? Does the YANG module
  comply with the Network Management Datastore Architecture (NMDA) as specified
  in [RFC 8342][5]?
 
  The document does not contain a YANG module.

8. Describe reviews and automated checks performed to validate sections of the
  final version of the document written in a formal language, such as XML code,
  BNF rules, MIB definitions, CBOR's CDDL, etc.
 
  The draft does not use formal languages.

## Document Shepherd Checks

9. Based on the shepherd's review of the document, is it their opinion that this
  document is needed, clearly written, complete, correctly designed, and ready
  to be handed off to the responsible Area Director?
 
  In the shepherd's opinion, this document is ready to be handed off to the AD.
  The shepherd found a small number of non-substantive nits that have been
  shared with the author and do not need to block progress. They can wait
  for the next update opportunity.

10. Several IETF Areas have assembled [lists of common issues that their
    reviewers encounter][6]. For which areas have such issues been identified
    and addressed? For which does this still need to happen in subsequent
    reviews?
   
    The shepherd finds no such issues.

11. What type of RFC publication is being requested on the IETF stream ([Best
    Current Practice][12], [Proposed Standard, Internet Standard][13],
    [Informational, Experimental or Historic][14])? Why is this the proper type
    of RFC? Do all Datatracker state attributes correctly reflect this intent
   
    The intended status is Proposed Standard. It describes an extension for
    error reporting for STIR, which is comprises multiple Proposed Standards.
    This is correctly reflected in the datatracker.

12. Have reasonable efforts been made to remind all authors of the intellectual
    property rights (IPR) disclosure obligations described in [BCP 79][7]? To
    the best of your knowledge, have all required disclosures been filed? If
    not, explain why. If yes, summarize any relevant discussion, including links
    to publicly-available messages when applicable.
   
    The author has explicitly confirmed that all IPR
    disclosures required for full conformance with the provisions of
    BCP 78 and BCP 79 have already been filed.  There are none.

13. Has each author, editor, and contributor shown their willingness to be
    listed as such? If the total number of authors and editors on the front page
    is greater than five, please provide a justification.
   
    This draft has a single author, whose willingness to be listed is implied
    by the submission of the draft. But the author has explicitly confirmed,
    anyway.

14. Document any remaining I-D nits in this document. Simply running the [idnits
    tool][8] is not enough; please review the ["Content Guidelines" on
    authors.ietf.org][15]. (Also note that the current idnits tool generates
    some incorrect warnings; a rewrite is underway.)
   
    The document shepherd review of the document did not find any
    issues related to the Guidelines to Authors of Internet-Drafts.


15. Should any informative references be normative or vice-versa? See the [IESG
    Statement on Normative and Informative References][16].
   
    All references are properly normative.

16. List any normative references that are not freely available to anyone. Did
    the community have sufficient access to review any such normative
    references?
   
    All references are IETF RFCs or drafts

17. Are there any normative downward references (see [RFC 3967][9] and [BCP
    97
][10]) that are not already listed in the [DOWNREF registry][17]? If so,
    list them.
   
    There are no downward references.

18. Are there normative references to documents that are not ready to be
    submitted to the IESG for publication or are otherwise in an unclear state?
    If so, what is the plan for their completion?
   
    The only unpublished dependency is draft-ietf-sipcore-multiple-reasons,
    which has already been submitted to the IESG.

19. Will publication of this document change the status of any existing RFCs? If
    so, does the Datatracker metadata correctly reflect this and are those RFCs
    listed on the title page, in the abstract, and discussed in the
    introduction? If not, explain why and point to the part of the document
    where the relationship of this document to these other RFCs is discussed.
   
    This draft does not affect the status of any existing RFC.

20. Describe the document shepherd's review of the IANA considerations section,
    especially with regard to its consistency with the body of the document.
    Confirm that all aspects of the document requiring IANA assignments are
    associated with the appropriate reservations in IANA registries. Confirm
    that any referenced IANA registries have been clearly identified. Confirm
    that each newly created IANA registry specifies its initial contents,
    allocations procedures, and a reasonable name (see [RFC 8126][11]).
   
    The shepherd has reviewed the IANA considerations and confirms all the
    above.

21. List any new IANA registries that require Designated Expert Review for
    future allocations. Are the instructions to the Designated Expert clear?
    Please include suggestions of designated experts, if appropriate.
   
    This draft does not create new registries.

2022-10-11
05 Ben Campbell
# Document Shepherd Write-Up for Group Documents

*This version is dated 4 July 2022.*


## Document History

1. Does the working group (WG) consensus represent …
# Document Shepherd Write-Up for Group Documents

*This version is dated 4 July 2022.*


## Document History

1. Does the working group (WG) consensus represent the strong concurrence of a
  few individuals, with others being silent, or did it reach broad agreement?
 
  There was general agreement among a fairly small group of STIR participants.
  This group included people with SIP and STIR implementation experience.

2. Was there controversy about particular points, or were there decisions where
  the consensus was particularly rough?
 
  There was no significant controversy. There were some architectural questions
  and some questions about potential privacy leaks that that were worked
  through to consensus. One participant questioned whether the mechanism
  could be deployed in practice, but most active participants did not see a
  problem.

3. Has anyone threatened an appeal or otherwise indicated extreme discontent? If
  so, please summarize the areas of conflict in separate email messages to the
  responsible Area Director. (It should be in a separate email because this
  questionnaire is publicly available.)
 
  No one has threatened an appeal or expressed extreme discontent.

4. For protocol documents, are there existing implementations of the contents of
  the document? Have a significant number of potential implementers indicated
  plans to implement? Are any existing implementations reported somewhere,
  either in the document itself (as [RFC 7942][3] recommends) or elsewhere
  (where)?
 
  The shepherd is not aware of existing implementations. However, this work is
  likely to be adopted by the ATIS/SIP Forum IP-NNI task force, which will
  likely result in wide-spread implementation in the voice service provider
  community.

## Additional Reviews

5. Do the contents of this document closely interact with technologies in other
  IETF working groups or external organizations, and would it therefore benefit
  from their review? Have those reviews occurred? If yes, describe which
  reviews took place.
 
  This work, like all work in STIR is closely related to SIP, which is
  maintained by SIPCORE. However, there is enough cross-participation between
  the groups that a separate review in SIPCORE is probably not needed. There
  is a companion draft to this work in SIP
  [draft-ietf-sipcore-multiple-reasons].
 
6. Describe how the document meets any required formal expert review criteria,
  such as the MIB Doctor, YANG Doctor, media type, and URI type reviews.
 
  The only additional expert review required is for registration of a new
  "Reason Protocol" in the IANA Session Initiation Protocol (SIP) Parameters
  registry. The registration procedure is "Specification Required"

7. If the document contains a YANG module, has the final version of the module
  been checked with any of the [recommended validation tools][4] for syntax and
  formatting validation? If there are any resulting errors or warnings, what is
  the justification for not fixing them at this time? Does the YANG module
  comply with the Network Management Datastore Architecture (NMDA) as specified
  in [RFC 8342][5]?
 
  The document does not contain a YANG module.

8. Describe reviews and automated checks performed to validate sections of the
  final version of the document written in a formal language, such as XML code,
  BNF rules, MIB definitions, CBOR's CDDL, etc.
 
  The draft does not use formal languages.

## Document Shepherd Checks

9. Based on the shepherd's review of the document, is it their opinion that this
  document is needed, clearly written, complete, correctly designed, and ready
  to be handed off to the responsible Area Director?
 
  In the shepherd's opinion, this document is ready to be handed off to the AD.
  The shepherd found a small number of non-substantive nits that have been
  shared with the author and do not need to block progress. They can wait
  for the next update opportunity.

10. Several IETF Areas have assembled [lists of common issues that their
    reviewers encounter][6]. For which areas have such issues been identified
    and addressed? For which does this still need to happen in subsequent
    reviews?
   
    The shepherd finds no such issues.

11. What type of RFC publication is being requested on the IETF stream ([Best
    Current Practice][12], [Proposed Standard, Internet Standard][13],
    [Informational, Experimental or Historic][14])? Why is this the proper type
    of RFC? Do all Datatracker state attributes correctly reflect this intent
   
    The intended status is Proposed Standard. It describes an extension for
    error reporting for STIR, which is comprises multiple Proposed Standards.
    This is correctly reflected in the datatracker.

12. Have reasonable efforts been made to remind all authors of the intellectual
    property rights (IPR) disclosure obligations described in [BCP 79][7]? To
    the best of your knowledge, have all required disclosures been filed? If
    not, explain why. If yes, summarize any relevant discussion, including links
    to publicly-available messages when applicable.
   
    The author has explicitly confirmed that all IPR
    disclosures required for full conformance with the provisions of
    BCP 78 and BCP 79 have already been filed.  There are none.

13. Has each author, editor, and contributor shown their willingness to be
    listed as such? If the total number of authors and editors on the front page
    is greater than five, please provide a justification.
   
    This draft has a single author, whose willingness to be listed is implied
    by the submission of the draft. But the author has explicitly confirmed,
    anyway.

14. Document any remaining I-D nits in this document. Simply running the [idnits
    tool][8] is not enough; please review the ["Content Guidelines" on
    authors.ietf.org][15]. (Also note that the current idnits tool generates
    some incorrect warnings; a rewrite is underway.)
   
    The document shepherd review of the document did not find any
    issues related to the Guidelines to Authors of Internet-Drafts.


15. Should any informative references be normative or vice-versa? See the [IESG
    Statement on Normative and Informative References][16].
   
    All references are properly normative.

16. List any normative references that are not freely available to anyone. Did
    the community have sufficient access to review any such normative
    references?
   
    All references are IETF RFCs or drafts

17. Are there any normative downward references (see [RFC 3967][9] and [BCP
    97
][10]) that are not already listed in the [DOWNREF registry][17]? If so,
    list them.
   
    There are no downward references.

18. Are there normative references to documents that are not ready to be
    submitted to the IESG for publication or are otherwise in an unclear state?
    If so, what is the plan for their completion?
   
    The only unpublished dependency is draft-ietf-sipcore-multiple-reasons,
    which has already been submitted to the IESG.

19. Will publication of this document change the status of any existing RFCs? If
    so, does the Datatracker metadata correctly reflect this and are those RFCs
    listed on the title page, in the abstract, and discussed in the
    introduction? If not, explain why and point to the part of the document
    where the relationship of this document to these other RFCs is discussed.
   
    This draft does not affect the status of any existing RFC.

20. Describe the document shepherd's review of the IANA considerations section,
    especially with regard to its consistency with the body of the document.
    Confirm that all aspects of the document requiring IANA assignments are
    associated with the appropriate reservations in IANA registries. Confirm
    that any referenced IANA registries have been clearly identified. Confirm
    that each newly created IANA registry specifies its initial contents,
    allocations procedures, and a reasonable name (see [RFC 8126][11]).
   
    The shepherd has reviewed the IANA considerations and confirms all the
    above.

21. List any new IANA registries that require Designated Expert Review for
    future allocations. Are the instructions to the Designated Expert clear?
    Please include suggestions of designated experts, if appropriate.
   
    This draft does not create new registries.

2022-10-10
05 Ben Campbell Intended Status changed to Proposed Standard from None
2022-10-10
05 Ben Campbell Changed consensus to Yes from Unknown
2022-10-10
05 Ben Campbell Notification list changed to ben@nostrum.com because the document shepherd was set
2022-10-10
05 Ben Campbell Document shepherd changed to Ben Campbell
2022-10-03
05 Chris Wendt New version available: draft-ietf-stir-identity-header-errors-handling-05.txt
2022-10-03
05 Chris Wendt New version accepted (logged-in submitter: Chris Wendt)
2022-10-03
05 Chris Wendt Uploaded new revision
2022-09-15
04 Chris Wendt New version available: draft-ietf-stir-identity-header-errors-handling-04.txt
2022-09-15
04 Chris Wendt New version accepted (logged-in submitter: Chris Wendt)
2022-09-15
04 Chris Wendt Uploaded new revision
2022-08-21
03 Ben Campbell WGLC Period ends September 7, 2022.
2022-08-21
03 Ben Campbell IETF WG state changed to In WG Last Call from WG Document
2022-08-19
03 Chris Wendt New version available: draft-ietf-stir-identity-header-errors-handling-03.txt
2022-08-19
03 Chris Wendt New version accepted (logged-in submitter: Chris Wendt)
2022-08-19
03 Chris Wendt Uploaded new revision
2022-07-13
02 Russ Housley Added to session: IETF-114: stir  Tue-1500
2022-07-11
02 Chris Wendt New version available: draft-ietf-stir-identity-header-errors-handling-02.txt
2022-07-11
02 (System) New version approved
2022-07-11
02 (System) Request for posting confirmation emailed to previous authors: Chris Wendt
2022-07-11
02 Chris Wendt Uploaded new revision
2022-04-21
01 Ben Campbell Added to session: interim-2022-stir-01
2022-04-19
01 Chris Wendt New version available: draft-ietf-stir-identity-header-errors-handling-01.txt
2022-04-19
01 Chris Wendt New version accepted (logged-in submitter: Chris Wendt)
2022-04-19
01 Chris Wendt Uploaded new revision
2021-12-06
00 Chris Wendt New version available: draft-ietf-stir-identity-header-errors-handling-00.txt
2021-12-06
00 (System) WG -00 approved
2021-12-06
00 Chris Wendt Set submitter to "Chris Wendt ", replaces to (none) and sent approval email to group chairs: stir-chairs@ietf.org
2021-12-06
00 Chris Wendt Uploaded new revision