Skip to main content

Discovery of Oblivious Services via Service Binding Records
draft-ietf-ohai-svcb-config-07

Revision differences

Document history

Date Rev. By Action
2024-02-21
(System)
Received changes through RFC Editor sync (changed state to RFC, created became rfc relationship between draft-ietf-ohai-svcb-config and RFC 9540, changed IESG state to RFC …
Received changes through RFC Editor sync (changed state to RFC, created became rfc relationship between draft-ietf-ohai-svcb-config and RFC 9540, changed IESG state to RFC Published)
2024-02-07
07 (System) RFC Editor state changed to AUTH48-DONE from AUTH48
2024-02-02
07 (System) RFC Editor state changed to AUTH48
2024-01-26
07 Gunter Van de Velde Request closed, assignment withdrawn: Joel Jaeggli Last Call OPSDIR review
2024-01-26
07 Gunter Van de Velde Closed request for Last Call review by OPSDIR with state 'Overtaken by Events': Cleaning up stale OPSDIR queue
2023-12-12
07 (System) RFC Editor state changed to RFC-EDITOR from EDIT
2023-10-26
07 Tero Kivinen Closed request for Last Call review by SECDIR with state 'Overtaken by Events'
2023-10-26
07 Tero Kivinen Assignment of request for Last Call review by SECDIR to Aanchal Malhotra was marked no-response
2023-10-25
07 (System) IANA Action state changed to RFC-Ed-Ack from Waiting on RFC Editor
2023-10-25
07 (System) IANA Action state changed to Waiting on RFC Editor from In Progress
2023-10-25
07 (System) IANA Action state changed to In Progress from Waiting on Authors
2023-10-25
07 (System) RFC Editor state changed to EDIT
2023-10-25
07 (System) IESG state changed to RFC Ed Queue from Approved-announcement sent
2023-10-25
07 (System) Announcement was received by RFC Editor
2023-10-25
07 (System) IANA Action state changed to Waiting on Authors from In Progress
2023-10-23
07 (System) IANA Action state changed to In Progress
2023-10-23
07 (System) Removed all action holders (IESG state changed)
2023-10-23
07 Cindy Morgan IESG state changed to Approved-announcement sent from Approved-announcement to be sent
2023-10-23
07 Cindy Morgan IESG has approved the document
2023-10-23
07 Cindy Morgan Closed "Approve" ballot
2023-10-23
07 Cindy Morgan Ballot approval text was generated
2023-10-23
07 Murray Kucherawy IESG state changed to Approved-announcement to be sent from Approved-announcement to be sent::AD Followup
2023-10-06
07 (System) Changed action holders to Murray Kucherawy (IESG state changed)
2023-10-06
07 (System) Sub state has been changed to AD Followup from Revised I-D Needed
2023-10-06
07 Tommy Pauly New version available: draft-ietf-ohai-svcb-config-07.txt
2023-10-06
07 Tommy Pauly New version approved
2023-10-06
07 (System) Request for posting confirmation emailed to previous authors: "Tirumaleswar Reddy.K" , Tommy Pauly
2023-10-06
07 Tommy Pauly Uploaded new revision
2023-10-05
06 Murray Kucherawy Authors have some minor edits to make before it moves forward.
2023-10-05
06 (System) Changed action holders to Tirumaleswar Reddy.K, Tommy Pauly (IESG state changed)
2023-10-05
06 Murray Kucherawy IESG state changed to Approved-announcement to be sent::Revised I-D Needed from Approved-announcement to be sent::AD Followup
2023-10-05
06 Cindy Morgan IESG state changed to Approved-announcement to be sent::AD Followup from IESG Evaluation
2023-10-05
06 Andrew Alston [Ballot Position Update] New position, No Objection, has been recorded for Andrew Alston
2023-10-04
06 Warren Kumari [Ballot comment]
I'd like to thank the authors for writing this document, and especially Ralf Weber for the DnsDir review (https://datatracker.ietf.org/doc/review-ietf-ohai-svcb-config-06-dnsdir-telechat-weber-2023-10-03/) and followup.
2023-10-04
06 Warren Kumari [Ballot Position Update] New position, No Objection, has been recorded for Warren Kumari
2023-10-04
06 Zaheduzzaman Sarker
[Ballot comment]
Thanks for working on this specification. Thanks to David Black for the TSVART review.

Like David I haven't find any TSV related issues …
[Ballot comment]
Thanks for working on this specification. Thanks to David Black for the TSVART review.

Like David I haven't find any TSV related issues in this specification. However, section 5 says -

    By default, the gateway for a target is defined as a well-known resource ([WELLKNOWN]) on the target, "/.well-known/ohttp-gateway".

I would like to know where is this default behavior defined? Unless I have missed it, the OHTTP specification does not define this. In case this is something defined in the current document then I would suggest to use Normative language for this requirement.
2023-10-04
06 Zaheduzzaman Sarker Ballot comment text updated for Zaheduzzaman Sarker
2023-10-04
06 Zaheduzzaman Sarker
[Ballot comment]
Thanks for working on this specification. Thanks to David Black for the TSVART review.

Like David I haven't find any TSV related issues …
[Ballot comment]
Thanks for working on this specification. Thanks to David Black for the TSVART review.

Like David I haven't find any TSV related issues in this specification. However, section 5 says -

    By default, the gateway for a target is defined as a well-known resource ([WELLKNOWN]) on the target, "/.well-known/ohttp-gateway".

I would like to know where is this default behavior defined? Unless I have missed it the OHTTP specification does not define this. In case this is something defined in the current document then I would suggest to use Normative language for this requirement.
2023-10-04
06 Zaheduzzaman Sarker [Ballot Position Update] New position, No Objection, has been recorded for Zaheduzzaman Sarker
2023-10-03
06 Ralf Weber Request for Telechat review by DNSDIR Completed: Ready. Reviewer: Ralf Weber. Sent review to list. Submission of review completed at an earlier date.
2023-10-03
06 Ralf Weber Request for Telechat review by DNSDIR Completed: Ready. Reviewer: Ralf Weber.
2023-10-03
06 John Scudder [Ballot Position Update] New position, No Objection, has been recorded for John Scudder
2023-10-03
06 Jim Guichard [Ballot Position Update] New position, No Objection, has been recorded for Jim Guichard
2023-10-02
06 Lars Eggert
[Ballot comment]
# GEN AD review of draft-ietf-ohai-svcb-config-06

CC @larseggert

Thanks to Thomas Fossati for the General Area Review Team (Gen-ART) review
(https://mailarchive.ietf.org/arch/msg/gen-art/jt6viRvUbQrX-DnVQkJL328ccco). …
[Ballot comment]
# GEN AD review of draft-ietf-ohai-svcb-config-06

CC @larseggert

Thanks to Thomas Fossati for the General Area Review Team (Gen-ART) review
(https://mailarchive.ietf.org/arch/msg/gen-art/jt6viRvUbQrX-DnVQkJL328ccco).

## 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. Review generated by the [`ietf-reviewtool`][IRT].

[ICMF]: https://github.com/mnot/ietf-comments/blob/main/format.md
[ICT]: https://github.com/mnot/ietf-comments
[IRT]: https://github.com/larseggert/ietf-reviewtool
2023-10-02
06 Lars Eggert [Ballot Position Update] New position, No Objection, has been recorded for Lars Eggert
2023-10-02
06 Erik Kline
[Ballot comment]
# Internet AD comments for draft-ietf-ohai-svcb-config-06
CC @ekline

* comment syntax:
  - https://github.com/mnot/ietf-comments/blob/main/format.md

* "Handling Ballot Positions":
  - https://ietf.org/about/groups/iesg/statements/handling-ballot-positions/

## Nits …
[Ballot comment]
# Internet AD comments for draft-ietf-ohai-svcb-config-06
CC @ekline

* comment syntax:
  - https://github.com/mnot/ietf-comments/blob/main/format.md

* "Handling Ballot Positions":
  - https://ietf.org/about/groups/iesg/statements/handling-ballot-positions/

## Nits

### S4.1

* It seems a (small) waste that if "ohttp" is in the mandatory parameter
  it also appears in the parameter list.  But... shrug, I guess.
2023-10-02
06 Erik Kline [Ballot Position Update] New position, Yes, has been recorded for Erik Kline
2023-10-02
06 Amanda Baber IANA Review state changed to IANA OK - Actions Needed from Version Changed - Review Needed
2023-10-02
06 Paul Wouters [Ballot Position Update] New position, No Objection, has been recorded for Paul Wouters
2023-10-02
06 Francesca Palombini
[Ballot comment]
Thank you for the work on this document.

Many thanks to Christian Amsüss for his ART ART review: https://mailarchive.ietf.org/arch/msg/art/mn_I-CQwqVJ20tWFchpvWrrvvqA/, and to the …
[Ballot comment]
Thank you for the work on this document.

Many thanks to Christian Amsüss for his ART ART review: https://mailarchive.ietf.org/arch/msg/art/mn_I-CQwqVJ20tWFchpvWrrvvqA/, and to the authors for addressing Christian's comments.
2023-10-02
06 Francesca Palombini [Ballot Position Update] New position, No Objection, has been recorded for Francesca Palombini
2023-10-02
06 Robert Wilton
[Ballot comment]
Hi,

Thanks for this document.  I have one minor level:

(1) p 7, sec 7.  Security and Privacy Considerations

Is another security/privacy consideration …
[Ballot comment]
Hi,

Thanks for this document.  I have one minor level:

(1) p 7, sec 7.  Security and Privacy Considerations

Is another security/privacy consideration here that the target service (since it is collocated with the gateway) potentially has knowledge about whether the request is coming via a OHTTP gateway and hence may offer a different service to those clients connected via the OHTTP gateway vs those clients that are directly connected?  For example, if the target server is a DNS resolver, then perhaps that DNS resolver doesn't resolve requests for some domains when offering service via an oblivious gateway.

Regards,
Rob
2023-10-02
06 Robert Wilton [Ballot Position Update] New position, No Objection, has been recorded for Robert Wilton
2023-10-02
06 Éric Vyncke
[Ballot comment]

# Éric Vyncke, INT AD, comments for draft-ietf-ohai-svcb-config-06

Thank you for the work put into this document.

Please find below some non-blocking COMMENT …
[Ballot comment]

# Éric Vyncke, INT AD, comments for draft-ietf-ohai-svcb-config-06

Thank you for the work put into this document.

Please find below some non-blocking COMMENT points (but replies would be appreciated even if only for my own education), and some nits.

Special thanks to Shivan Kaul Sahib for the shepherd's detailed write-up including the WG consensus ***and*** the justification of the intended status.

Please note that Ralf Weber is the DNS directorate reviewer and you may want to consider this dns-dir review as well when it will be available (no need to wait for it though):
https://datatracker.ietf.org/doc/draft-ietf-ohai-svcb-config/reviewrequest/18156/ (and I have read Tommy's reply to Ralf's Last Call review)

I hope that this review helps to improve the document,

Regards,

-éric

# COMMENTS


## Section 1

Should DNR also be mentioned (if applicable) ? Esp as this I-D contains section 4.2.2.

## Section 3

I would expect a direct object in ` it "upgrades"`, i.e., what is upgraded ?

## Section 4.2.2

Suggest to also add examples as in the DDR/HTTP sections above.

## Section 5

I hesitated to raise a DISCUSS level on this one... Should normative language be used in `By default, the gateway for a target is defined as a well-known resource ([WELLKNOWN]) on the target, "/.well-known/ohttp-gateway".` ? I.e., 'by default' is rather vague.
2023-10-02
06 Éric Vyncke Ballot comment text updated for Éric Vyncke
2023-10-02
06 Éric Vyncke
[Ballot comment]

# Éric Vyncke, INT AD, comments for draft-ietf-ohai-svcb-config-06

Thank you for the work put into this document.

Please find below one blocking DISCUSS …
[Ballot comment]

# Éric Vyncke, INT AD, comments for draft-ietf-ohai-svcb-config-06

Thank you for the work put into this document.

Please find below one blocking DISCUSS points (easy to address), some non-blocking COMMENT points (but replies would be appreciated even if only for my own education), and some nits.

Special thanks to Shivan Kaul Sahib for the shepherd's detailed write-up including the WG consensus ***and*** the justification of the intended status.

Please note that Ralf Weber is the DNS directorate reviewer and you may want to consider this dns-dir review as well when it will be available (no need to wait for it though):
https://datatracker.ietf.org/doc/draft-ietf-ohai-svcb-config/reviewrequest/18156/ (and I have read Tommy's reply to Ralf's Last Call review)

I hope that this review helps to improve the document,

Regards,

-éric


# DISCUSS

As noted in https://www.ietf.org/blog/handling-iesg-ballot-positions/, a DISCUSS ballot is a request to have a discussion on the following topics:

##

# COMMENTS


## Section 1

Should DNR also be mentioned (if applicable) ? Esp as this I-D contains section 4.2.2.

## Section 3

I would expect a direct object in ` it "upgrades"`, i.e., what is upgraded ?

## Section 4.2.2

Suggest to also add examples as in the DDR/HTTP sections above.

## Section 5

I hesitated to raise a DISCUSS level on this one... Should normative language be used in `By default, the gateway for a target is defined as a well-known resource ([WELLKNOWN]) on the target, "/.well-known/ohttp-gateway".` ? I.e., 'by default' is rather vague.
2023-10-02
06 Éric Vyncke [Ballot Position Update] New position, No Objection, has been recorded for Éric Vyncke
2023-09-29
06 Roman Danyliw
[Ballot comment]
** Section 4.2.1
  If a configuration occurs where the resolver is accessible,
  but cannot use certificate-based validation, the client needs to …
[Ballot comment]
** Section 4.2.1
  If a configuration occurs where the resolver is accessible,
  but cannot use certificate-based validation, the client needs to
  ensure that the relay only accesses the gateway and target using the
  unencrypted resolver's original IP address.

Should this be s/the client needs to ensure/the client MUST ensure/?

** Section 7.2

  Clients SHOULD mitigate such attacks.  This can be done with a check
  for consistency, such as using a mechanism described in [CONSISTENCY]
  to validate the dohpath value with another source.  It can also be
  done by limiting the allowable values of dohpath to a single value,
  such as the commonly used "/dns-query{?dns}".

Is it possible to describe the circumstances where the client is not interested in mitigating such attacks?
2023-09-29
06 Roman Danyliw [Ballot Position Update] New position, No Objection, has been recorded for Roman Danyliw
2023-09-25
06 Jim Reid Request for Telechat review by DNSDIR is assigned to Ralf Weber
2023-09-25
06 Cindy Morgan Placed on agenda for telechat - 2023-10-05
2023-09-24
06 Murray Kucherawy Ballot has been issued
2023-09-24
06 Murray Kucherawy [Ballot Position Update] New position, Yes, has been recorded for Murray Kucherawy
2023-09-24
06 Murray Kucherawy Created "Approve" ballot
2023-09-24
06 Murray Kucherawy IESG state changed to IESG Evaluation from Waiting for AD Go-Ahead::AD Followup
2023-09-24
06 Murray Kucherawy Ballot writeup was changed
2023-09-22
06 (System) Changed action holders to Murray Kucherawy (IESG state changed)
2023-09-22
06 (System) Sub state has been changed to AD Followup from Revised I-D Needed
2023-09-22
06 (System) IANA Review state changed to Version Changed - Review Needed from IANA OK - Actions Needed
2023-09-22
06 Tommy Pauly New version available: draft-ietf-ohai-svcb-config-06.txt
2023-09-22
06 Tommy Pauly New version approved
2023-09-22
06 (System) Request for posting confirmation emailed to previous authors: "Tirumaleswar Reddy.K" , Tommy Pauly
2023-09-22
06 Tommy Pauly Uploaded new revision
2023-08-21
05 Christian Amsüss Request for Last Call review by ARTART Completed: Ready with Nits. Reviewer: Christian Amsüss. Sent review to list.
2023-08-21
05 Murray Kucherawy Last Call resulted in some pull requests that need to be merged and posted.
2023-08-21
05 (System) Changed action holders to Murray Kucherawy, Tommy Pauly, Tirumaleswar Reddy.K (IESG state changed)
2023-08-21
05 Murray Kucherawy IESG state changed to Waiting for AD Go-Ahead::Revised I-D Needed from Waiting for AD Go-Ahead
2023-08-21
05 Ralf Weber Request for Last Call review by DNSDIR Completed: Ready with Nits. Reviewer: Ralf Weber. Sent review to list.
2023-08-21
05 (System) IESG state changed to Waiting for AD Go-Ahead from In Last Call
2023-08-20
05 (System) IANA Review state changed to IANA OK - Actions Needed from IANA - Not OK
2023-08-20
05 David Dong IANA Experts State changed to Expert Reviews OK from Reviews assigned
2023-08-19
05 David Dong IANA Experts State changed to Reviews assigned
2023-08-19
05 (System) IANA Review state changed to IANA - Not OK from IANA - Review Needed
2023-08-19
05 David Dong
(Via drafts-lastcall@iana.org): IESG/Authors/WG Chairs:

The IANA Functions Operator has completed its review of draft-ietf-ohai-svcb-config-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-ohai-svcb-config-05. If any part of this review is inaccurate, please let us know.

The IANA Functions Operator understands that, upon approval of this document, there are two actions which we must complete.

First, in the Service Parameter Keys (SvcParamKeys) registry on the DNS Service Bindings (SVCB) registry page located at:

https://www.iana.org/assignments/dns-svcb/

the existing early allocation for:

Number Name Meaning
8 ohttp Denotes that a service operates an Oblivious HTTP target

willl be made permanent and its reference changed to [ RFC-to-be ].

Second, in the Well-Known URIs registry located at:

https://www.iana.org/assignments/well-known-uris/

a single new registration will be made as follows:

URI Suffix: ohttp-gateway
Change Controller: IETF
Reference: [ RFC-to-be ]
Status: permanent
Related Information:
Date registered: [ TBD-at-Registration ]

As this document requests registrations in an Expert Review or 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."

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,

David Dong
IANA Services Sr. Specialist
2023-08-17
05 Dave Thaler Request for Last Call review by INTDIR Completed: Ready with Nits. Reviewer: Dave Thaler. Sent review to list.
2023-08-16
05 David Black Request for Last Call review by TSVART Completed: Ready. Reviewer: David Black. Sent review to list.
2023-08-16
05 Wesley Eddy Request for Last Call review by TSVART is assigned to David Black
2023-08-15
05 Thomas Fossati Request for Last Call review by GENART Completed: Ready. Reviewer: Thomas Fossati. Sent review to list.
2023-08-12
05 Gunter Van de Velde Request for Last Call review by OPSDIR is assigned to Joel Jaeggli
2023-08-10
05 Jean Mahoney Request for Last Call review by GENART is assigned to Thomas Fossati
2023-08-10
05 Tero Kivinen Request for Last Call review by SECDIR is assigned to Aanchal Malhotra
2023-08-09
05 Barry Leiba Request for Last Call review by ARTART is assigned to Christian Amsüss
2023-08-08
05 Geoff Huston Request for Last Call review by DNSDIR is assigned to Ralf Weber
2023-08-08
05 Bernie Volz Request for Last Call review by INTDIR is assigned to Dave Thaler
2023-08-07
05 Éric Vyncke Requested Last Call review by DNSDIR
2023-08-07
05 Éric Vyncke Requested Last Call review by INTDIR
2023-08-07
05 Cindy Morgan IANA Review state changed to IANA - Review Needed
2023-08-07
05 Cindy Morgan
The following Last Call announcement was sent out (ends 2023-08-21):

From: The IESG
To: IETF-Announce
CC: draft-ietf-ohai-svcb-config@ietf.org, ohai-chairs@ietf.org, ohai@ietf.org, shivankaulsahib@gmail.com, superuser@gmail.com …
The following Last Call announcement was sent out (ends 2023-08-21):

From: The IESG
To: IETF-Announce
CC: draft-ietf-ohai-svcb-config@ietf.org, ohai-chairs@ietf.org, ohai@ietf.org, shivankaulsahib@gmail.com, superuser@gmail.com
Reply-To: last-call@ietf.org
Sender:
Subject: Last Call:  (Discovery of Oblivious Services via Service Binding Records) to Proposed Standard


The IESG has received a request from the Oblivious HTTP Application
Intermediation WG (ohai) to consider the following document: - 'Discovery of
Oblivious Services via Service Binding Records'
  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 2023-08-21. 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 defines a parameter that can be included in SVCB and
  HTTPS DNS resource records to denote that a service is accessible
  using Oblivious HTTP, by offering an Oblivious Gateway Resource
  through which to access the target.  This document also defines a
  mechanism to learn the key configuration of the discovered Oblivious
  Gateway Resource.




The file can be obtained via
https://datatracker.ietf.org/doc/draft-ietf-ohai-svcb-config/



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




2023-08-07
05 Cindy Morgan IESG state changed to In Last Call from Last Call Requested
2023-08-07
05 Murray Kucherawy Last call was requested
2023-08-07
05 Murray Kucherawy Ballot approval text was generated
2023-08-07
05 Murray Kucherawy Ballot writeup was generated
2023-08-07
05 (System) Changed action holders to Murray Kucherawy (IESG state changed)
2023-08-07
05 Murray Kucherawy IESG state changed to Last Call Requested from AD Evaluation::AD Followup
2023-08-07
05 Murray Kucherawy Last call announcement was generated
2023-08-07
05 (System) Removed all action holders (IESG state changed)
2023-08-07
05 (System) Sub state has been changed to AD Followup from Revised I-D Needed
2023-08-07
05 Tommy Pauly New version available: draft-ietf-ohai-svcb-config-05.txt
2023-08-07
05 Tommy Pauly New version approved
2023-08-07
05 (System) Request for posting confirmation emailed to previous authors: "Tirumaleswar Reddy.K" , Tommy Pauly
2023-08-07
05 Tommy Pauly Uploaded new revision
2023-08-03
04 Murray Kucherawy Changed action holders to Tommy Pauly, Tirumaleswar Reddy.K
2023-08-03
04 (System) Changed action holders to Murray Kucherawy, Tommy Pauly, Tirumaleswar Reddy.K (IESG state changed)
2023-08-03
04 Murray Kucherawy IESG state changed to AD Evaluation::Revised I-D Needed from AD Evaluation::AD Followup
2023-08-02
04 Murray Kucherawy IESG state changed to AD Evaluation::AD Followup from AD Evaluation
2023-07-27
04 (System) Changed action holders to Murray Kucherawy (IESG state changed)
2023-07-27
04 Murray Kucherawy IESG state changed to AD Evaluation from Publication Requested
2023-07-27
04 Murray Kucherawy Shepherding AD changed to Murray Kucherawy
2023-07-20
04 Shivan Sahib
# Document Shepherd Write-Up for Group Documents

*This version is dated 4 July 2022.*

Thank you for your service as a document shepherd. Among the …
# Document Shepherd Write-Up for Group Documents

*This version is dated 4 July 2022.*

Thank you for your service as a document shepherd. Among the responsibilities is
answering the questions in this write-up to give helpful context to Last Call
and Internet Engineering Steering Group ([IESG][1]) reviewers, and your
diligence in completing it is appreciated. The full role of the shepherd is
further described in [RFC 4858][2]. You will need the cooperation of the authors
and editors to complete these checks.

Note that some numbered items contain multiple related questions; please be sure
to answer all of them.

## 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?
 
The draft reached broad agreement, as ascertained through both IETF session participation and mailing list/GitHub discussion. Quite a few folks [raised issues on GitHub](https://github.com/ietf-wg-ohai/draft-ohai-svcb-config/issues?q=is%3Aissue+is%3Aclosed), including the authors of the [main protocol document](https://datatracker.ietf.org/doc/draft-ietf-ohai-ohttp/),  which were resolved.

2. Was there controversy about particular points, or were there decisions where
  the consensus was particularly rough?
 
No real controversy.

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.

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)?
 
There is interest in deploying the protocol by [Akamai](https://mailarchive.ietf.org/arch/msg/ohai/e3tmoWds-f34tfdO1mEUDJc-2Ms/), [Apple](https://mailarchive.ietf.org/arch/msg/ohai/Rj68RPnago25AUWjM6AbVmILT8E/), [Cox](https://mailarchive.ietf.org/arch/msg/ohai/K2_ahn95NsJ6p-SuJFgR-DqMS3w/).

## 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.

External formal reviews have not yet taken place, but the participants are active in closely-related WGs such as ADD and DNSOP.

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 ["ohttp" DNS SVCB parameter](https://www.iana.org/assignments/dns-svcb/dns-svcb.xhtml) was given an early allocation on request of the draft authors and after confirming with the [Working Group](https://mailarchive.ietf.org/arch/msg/ohai/aLwGZKMcuabnvKi4rw1F9TXkiq8/) and our [Area Director](https://mailarchive.ietf.org/arch/msg/ohai/PD8_Y06JHfGONLXF7PW3XdQuJFk/).

The document also adds an entry to the "Well-Known" registry in [Section 8.2](https://datatracker.ietf.org/doc/html/draft-ietf-ohai-svcb-config-04#section-8.2). A [request has been made](https://github.com/protocol-registries/well-known-uris/issues/35) to add it to the registry.

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]?
 
N/A

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.

N.A

## 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?
 
Yes.

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?
   
This document overlaps most with OPS and SEC areas, and has had review and participation from both communities. It went through Expert Review for the DNS SVCB parameter early registration.

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?
   
Proposed Standard, because it involves multiple parties (client, gateway) implementing a commonly-understood protocol. Yes, the datatracker reflects that intent.

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 authors have confirmed that no IPR exists to their knowledge.

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.
   
Yes.

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.)
   
There is one error reported by the Nits tool: no Security Considerations section is found in the document. This is because the section is called "Security and Privacy Considerations".

Some of the references to Internet-Drafts are out of date (newer draft versions exist). This will be fixed automatically when a new version of the draft is uploaded.

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

16. List any normative references that are not freely available to anyone. Did
    the community have sufficient access to review any such normative
    references?
   
None.

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.
   
None.

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 document contains normative references to the following in-progress documents:

- [[DDR](https://datatracker.ietf.org/doc/html/draft-ietf-add-ddr-10)] draft-ietf-add-ddr-10. Part of [C461 on RFC Editor Queue](https://www.rfc-editor.org/cluster_info.php?cid=C461)
- [[DNR](https://datatracker.ietf.org/doc/html/draft-ietf-add-dnr-16)] draft-ietf-add-dnr-16. Part of [C461 on RFC Editor Queue](https://www.rfc-editor.org/cluster_info.php?cid=C461)
- [[DNS-SVCB](https://datatracker.ietf.org/doc/html/draft-ietf-add-svcb-dns-08)] draft-ietf-add-svcb-dns-08. Part of [C461 on RFC Editor Queue](https://www.rfc-editor.org/cluster_info.php?cid=C461)
- [[SVCB](https://datatracker.ietf.org/doc/html/draft-ietf-dnsop-svcb-https-12)] draft-ietf-dnsop-svcb-https-12. Part of [C461 on RFC Editor Queue](https://www.rfc-editor.org/cluster_info.php?cid=C461)
- [[OHTTP](https://datatracker.ietf.org/doc/html/draft-ietf-ohai-ohttp-08)] draft-ietf-ohai-ohttp-08. A late-breaking forward compatibility issue was found when it was in the RFC Editor Queue; it's going through a second WGLC out of an abundance of caution.



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.
   
No.

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 IANA considerations section looks accurate.


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.

N/A

[1]: https://www.ietf.org/about/groups/iesg/
[2]: https://www.rfc-editor.org/rfc/rfc4858.html
[3]: https://www.rfc-editor.org/rfc/rfc7942.html
[4]: https://wiki.ietf.org/group/ops/yang-review-tools
[5]: https://www.rfc-editor.org/rfc/rfc8342.html
[6]: https://wiki.ietf.org/group/iesg/ExpertTopics
[7]: https://www.rfc-editor.org/info/bcp79
[8]: https://www.ietf.org/tools/idnits/
[9]: https://www.rfc-editor.org/rfc/rfc3967.html
[10]: https://www.rfc-editor.org/info/bcp97
[11]: https://www.rfc-editor.org/rfc/rfc8126.html
[12]: https://www.rfc-editor.org/rfc/rfc2026.html#section-5
[13]: https://www.rfc-editor.org/rfc/rfc2026.html#section-4.1
[14]: https://www.rfc-editor.org/rfc/rfc2026.html#section-4.2
[15]: https://authors.ietf.org/en/content-guidelines-overview
[16]: https://www.ietf.org/about/groups/iesg/statements/normative-informative-references/
[17]: https://datatracker.ietf.org/doc/downref/
2023-07-20
04 Shivan Sahib Responsible AD changed to Francesca Palombini
2023-07-20
04 Shivan Sahib IETF WG state changed to Submitted to IESG for Publication from WG Consensus: Waiting for Write-Up
2023-07-20
04 Shivan Sahib IESG state changed to Publication Requested from I-D Exists
2023-07-20
04 Shivan Sahib Document is now in IESG state Publication Requested
2023-07-20
04 Shivan Sahib Tag Doc Shepherd Follow-up Underway cleared.
2023-07-20
04 Shivan Sahib Changed consensus to Yes from Unknown
2023-07-20
04 Shivan Sahib Intended Status changed to Proposed Standard from None
2023-07-20
04 Shivan Sahib
# Document Shepherd Write-Up for Group Documents

*This version is dated 4 July 2022.*

Thank you for your service as a document shepherd. Among the …
# Document Shepherd Write-Up for Group Documents

*This version is dated 4 July 2022.*

Thank you for your service as a document shepherd. Among the responsibilities is
answering the questions in this write-up to give helpful context to Last Call
and Internet Engineering Steering Group ([IESG][1]) reviewers, and your
diligence in completing it is appreciated. The full role of the shepherd is
further described in [RFC 4858][2]. You will need the cooperation of the authors
and editors to complete these checks.

Note that some numbered items contain multiple related questions; please be sure
to answer all of them.

## 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?
 
The draft reached broad agreement, as ascertained through both IETF session participation and mailing list/GitHub discussion. Quite a few folks [raised issues on GitHub](https://github.com/ietf-wg-ohai/draft-ohai-svcb-config/issues?q=is%3Aissue+is%3Aclosed), including the authors of the [main protocol document](https://datatracker.ietf.org/doc/draft-ietf-ohai-ohttp/),  which were resolved.

2. Was there controversy about particular points, or were there decisions where
  the consensus was particularly rough?
 
No real controversy.

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.

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)?
 
There is interest in deploying the protocol by [Akamai](https://mailarchive.ietf.org/arch/msg/ohai/e3tmoWds-f34tfdO1mEUDJc-2Ms/), [Apple](https://mailarchive.ietf.org/arch/msg/ohai/Rj68RPnago25AUWjM6AbVmILT8E/), [Cox](https://mailarchive.ietf.org/arch/msg/ohai/K2_ahn95NsJ6p-SuJFgR-DqMS3w/).

## 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.

External formal reviews have not yet taken place, but the participants are active in closely-related WGs such as ADD and DNSOP.

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 ["ohttp" DNS SVCB parameter](https://www.iana.org/assignments/dns-svcb/dns-svcb.xhtml) was given an early allocation on request of the draft authors and after confirming with the [Working Group](https://mailarchive.ietf.org/arch/msg/ohai/aLwGZKMcuabnvKi4rw1F9TXkiq8/) and our [Area Director](https://mailarchive.ietf.org/arch/msg/ohai/PD8_Y06JHfGONLXF7PW3XdQuJFk/).

The document also adds an entry to the "Well-Known" registry in [Section 8.2](https://datatracker.ietf.org/doc/html/draft-ietf-ohai-svcb-config-04#section-8.2). A [request has been made](https://github.com/protocol-registries/well-known-uris/issues/35) to add it to the registry.

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]?
 
N/A

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.

N.A

## 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?
 
Yes.

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?
   
This document overlaps most with OPS and SEC areas, and has had review and participation from both communities. It went through Expert Review for the DNS SVCB parameter early registration.

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?
   
Proposed Standard, because it involves multiple parties (client, gateway) implementing a commonly-understood protocol. Yes, the datatracker reflects that intent.

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 authors have confirmed that no IPR exists to their knowledge.

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.
   
Yes.

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.)
   
There is one error reported by the Nits tool: no Security Considerations section is found in the document. This is because the section is called "Security and Privacy Considerations".

Some of the references to Internet-Drafts are out of date (newer draft versions exist). This will be fixed automatically when a new version of the draft is uploaded.

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

16. List any normative references that are not freely available to anyone. Did
    the community have sufficient access to review any such normative
    references?
   
None.

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.
   
None.

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 document contains normative references to the following in-progress documents:

- [[DDR](https://datatracker.ietf.org/doc/html/draft-ietf-add-ddr-10)] draft-ietf-add-ddr-10. Part of [C461 on RFC Editor Queue](https://www.rfc-editor.org/cluster_info.php?cid=C461)
- [[DNR](https://datatracker.ietf.org/doc/html/draft-ietf-add-dnr-16)] draft-ietf-add-dnr-16. Part of [C461 on RFC Editor Queue](https://www.rfc-editor.org/cluster_info.php?cid=C461)
- [[DNS-SVCB](https://datatracker.ietf.org/doc/html/draft-ietf-add-svcb-dns-08)] draft-ietf-add-svcb-dns-08. Part of [C461 on RFC Editor Queue](https://www.rfc-editor.org/cluster_info.php?cid=C461)
- [[SVCB](https://datatracker.ietf.org/doc/html/draft-ietf-dnsop-svcb-https-12)] draft-ietf-dnsop-svcb-https-12. Part of [C461 on RFC Editor Queue](https://www.rfc-editor.org/cluster_info.php?cid=C461)
- [[OHTTP](https://datatracker.ietf.org/doc/html/draft-ietf-ohai-ohttp-08)] draft-ietf-ohai-ohttp-08. A late-breaking forward compatibility issue was found when it was in the RFC Editor Queue; it's going through a second WGLC out of an abundance of caution.



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.
   
No.

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 IANA considerations section looks accurate.


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.

N/A

[1]: https://www.ietf.org/about/groups/iesg/
[2]: https://www.rfc-editor.org/rfc/rfc4858.html
[3]: https://www.rfc-editor.org/rfc/rfc7942.html
[4]: https://wiki.ietf.org/group/ops/yang-review-tools
[5]: https://www.rfc-editor.org/rfc/rfc8342.html
[6]: https://wiki.ietf.org/group/iesg/ExpertTopics
[7]: https://www.rfc-editor.org/info/bcp79
[8]: https://www.ietf.org/tools/idnits/
[9]: https://www.rfc-editor.org/rfc/rfc3967.html
[10]: https://www.rfc-editor.org/info/bcp97
[11]: https://www.rfc-editor.org/rfc/rfc8126.html
[12]: https://www.rfc-editor.org/rfc/rfc2026.html#section-5
[13]: https://www.rfc-editor.org/rfc/rfc2026.html#section-4.1
[14]: https://www.rfc-editor.org/rfc/rfc2026.html#section-4.2
[15]: https://authors.ietf.org/en/content-guidelines-overview
[16]: https://www.ietf.org/about/groups/iesg/statements/normative-informative-references/
[17]: https://datatracker.ietf.org/doc/downref/
2023-07-20
04 Shivan Sahib Notification list changed to shivankaulsahib@gmail.com because the document shepherd was set
2023-07-20
04 Shivan Sahib Document shepherd changed to Shivan Kaul Sahib
2023-06-28
04 Shivan Sahib Tag Doc Shepherd Follow-up Underway set. Tag Revised I-D Needed - Issue raised by WGLC cleared.
2023-06-28
04 Shivan Sahib IETF WG state changed to WG Consensus: Waiting for Write-Up from In WG Last Call
2023-06-19
04 Tommy Pauly New version available: draft-ietf-ohai-svcb-config-04.txt
2023-06-19
04 Tommy Pauly New version approved
2023-06-19
04 (System) Request for posting confirmation emailed to previous authors: "Tirumaleswar Reddy.K" , Tommy Pauly
2023-06-19
04 Tommy Pauly Uploaded new revision
2023-06-16
03 Shivan Sahib Tag Revised I-D Needed - Issue raised by WGLC set.
2023-06-16
03 Shivan Sahib IETF WG state changed to In WG Last Call from WG Document
2023-06-16
03 Shivan Sahib Changed document external resources from: None to:

github_repo https://github.com/ietf-wg-ohai/draft-ohai-svcb-config
2023-06-09
03 Tommy Pauly New version available: draft-ietf-ohai-svcb-config-03.txt
2023-06-09
03 (System) New version approved
2023-06-09
03 (System) Request for posting confirmation emailed to previous authors: "Tirumaleswar Reddy.K" , Tommy Pauly
2023-06-09
03 Tommy Pauly Uploaded new revision
2023-05-09
02 Tommy Pauly New version available: draft-ietf-ohai-svcb-config-02.txt
2023-05-09
02 Tommy Pauly New version approved
2023-05-09
02 (System) Request for posting confirmation emailed to previous authors: "Tirumaleswar Reddy.K" , Tommy Pauly
2023-05-09
02 Tommy Pauly Uploaded new revision
2023-03-05
01 Tommy Pauly New version available: draft-ietf-ohai-svcb-config-01.txt
2023-03-05
01 Tommy Pauly New version approved
2023-03-05
01 (System) Request for posting confirmation emailed to previous authors: "Tirumaleswar Reddy.K" , Tommy Pauly
2023-03-05
01 Tommy Pauly Uploaded new revision
2022-10-26
00 Shivan Sahib This document now replaces draft-pauly-ohai-svcb-config instead of None
2022-10-24
00 Tommy Pauly New version available: draft-ietf-ohai-svcb-config-00.txt
2022-10-24
00 Richard Barnes WG -00 approved
2022-10-24
00 Tommy Pauly Set submitter to "Tommy Pauly ", replaces to (none) and sent approval email to group chairs: ohai-chairs@ietf.org
2022-10-24
00 Tommy Pauly Uploaded new revision