<?xml version='1.0' encoding='utf-8'?>
<?xml-stylesheet type="text/xsl" href="rfc2629.xslt" ?>
<!-- generated by https://github.com/cabo/kramdown-rfc2629 version 1.4.2 -->
<!DOCTYPE rfc SYSTEM "rfc2629-xhtml.ent">
<?rfc toc="yes"?>
<?rfc sortrefs="yes"?>
<?rfc symrefs="yes"?>
<?rfc comments="yes"?>
<rfc xmlns:xi="http://www.w3.org/2001/XInclude" ipr="trust200902" docName="draft-wiethuechter-drip-registry-http-00" category="std" obsoletes="" updates="" submissionType="IETF" xml:lang="en" tocInclude="true" sortRefs="true" symRefs="true" version="3">
  <!-- xml2rfc v2v3 conversion 3.7.0 -->
  <front>
    <title abbrev="DRIP Registry HTTP Interface">DRIP Registry HTTP Interface</title>
    <seriesInfo name="Internet-Draft" value="draft-wiethuechter-drip-registry-http-00"/>
    <author initials="A." surname="Wiethuechter" fullname="Adam Wiethuechter">
      <organization>AX Enterprize, LLC</organization>
      <address>
        <postal>
          <street>4947 Commercial Drive</street>
          <city>Yorkville</city>
          <region>NY</region>
          <code>13495</code>
          <country>USA</country>
        </postal>
        <email>adam.wiethuechter@axenterprize.com</email>
      </address>
    </author>
    <author initials="S." surname="Card" fullname="Stuart Card">
      <organization>AX Enterprize, LLC</organization>
      <address>
        <postal>
          <street>4947 Commercial Drive</street>
          <city>Yorkville</city>
          <region>NY</region>
          <code>13495</code>
          <country>USA</country>
        </postal>
        <email>stu.card@axenterprize.com</email>
      </address>
    </author>
    <author initials="R." surname="Moskowitz" fullname="Robert Moskowitz">
      <organization>HTT Consulting</organization>
      <address>
        <postal>
          <street/>
          <city>Oak Park</city>
          <region>MI</region>
          <code>48237</code>
          <country>USA</country>
        </postal>
        <email>rgm@labs.htt-consult.com</email>
      </address>
    </author>
    <date year="2022" month="September" day="27"/>
    <area>Internet</area>
    <workgroup>drip Working Group</workgroup>
    <keyword>Internet-Draft</keyword>
    <abstract>
      <t>This document defines an HTTP based interface using either JSON or CBOR for object encodings for the DRIP Registry from a DRIP Provisioning Agent (DPA) to support DRIP Entity Tag (DET) and its additional information registration into a DRIP Identity Management Entity (DIME). The Registry is a logically required component of a DIME that handles the various DNS functions for DRIP registration and lookup using DETs.</t>
    </abstract>
  </front>
  <middle>
    <section anchor="introduction" numbered="true" toc="default">
      <name>Introduction</name>
      <t>The Registry is one of the required components in a DIME for it to fulfill the role of registration of DRIP Entity Tags (DETs) of clients. A standardized interface is needed for this to avoid interoperability issues between vendors supporting DRIP and the various logical components of the DIME.</t>
      <t>Per <xref target="drip-detim" format="default"/> the Registry MUST:</t>
      <ul empty="true" spacing="normal">
        <li>provided an interface for interactions with the DPA. This interface MAY be over HTTPS using JSON/CBOR encoding ...</li>
      </ul>
      <t>This document is the definition of this interface and its behavior; specifically between the Registry and a DPA. A snapshot of the OpenAPI specification is in <xref target="api-spec" format="default"/> at the time of this documents publishing; with a URI to access an updated specification.</t>
    </section>
    <section anchor="terminology" numbered="true" toc="default">
      <name>Terminology</name>
      <section anchor="required-terminology" numbered="true" toc="default">
        <name>Required Terminology</name>
        <t>The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in BCP 14 <xref target="RFC2119" format="default"/> <xref target="RFC8174" format="default"/> when, and only when, they appear in all capitals, as shown here.</t>
      </section>
    </section>
    <section anchor="endpoint-definitions-behavior" numbered="true" toc="default">
      <name>Endpoint Definitions &amp; Behavior</name>
      <t>All endpoints that send DRIP Endorsements use the JSON/CBOR forms as specified in <xref target="drip-detim" format="default"/>.</t>
      <t>If there is any failure during validation in any endpoint a HTTP 400 code MUST be sent to the client with a detailed reason for the error.</t>
      <section anchor="serial-number" numbered="true" toc="default">
        <name>Serial Number</name>
        <t>TODO</t>
      </section>
      <section anchor="operator" numbered="true" toc="default">
        <name>Operator</name>
        <t>TODO</t>
      </section>
      <section anchor="ground-control-station" numbered="true" toc="default">
        <name>Ground Control Station</name>
        <t>TODO</t>
      </section>
      <section anchor="session-id" numbered="true" toc="default">
        <name>Session ID</name>
        <t>TODO</t>
      </section>
      <section anchor="child-dime" numbered="true" toc="default">
        <name>Child DIME</name>
        <t>TODO</t>
      </section>
    </section>
  </middle>
  <back>
    <references>
      <name>Normative References</name>
      <reference anchor="RFC9153" target="https://www.rfc-editor.org/info/rfc9153">
        <front>
          <title>Drone Remote Identification Protocol (DRIP) Requirements and Terminology</title>
          <author fullname="S. Card" initials="S." role="editor" surname="Card">
            <organization/>
          </author>
          <author fullname="A. Wiethuechter" initials="A." surname="Wiethuechter">
            <organization/>
          </author>
          <author fullname="R. Moskowitz" initials="R." surname="Moskowitz">
            <organization/>
          </author>
          <author fullname="A. Gurtov" initials="A." surname="Gurtov">
            <organization/>
          </author>
          <date month="February" year="2022"/>
          <abstract>
            <t>This document defines terminology and requirements for solutions produced by the Drone Remote Identification Protocol (DRIP) Working Group. These solutions will support Unmanned Aircraft System Remote Identification and tracking (UAS RID) for security, safety, and other purposes (e.g., initiation of identity-based network sessions supporting UAS applications). DRIP will facilitate use of existing Internet resources to support RID and to enable enhanced related services, and it will enable online and offline verification that RID information is trustworthy.</t>
          </abstract>
        </front>
        <seriesInfo name="RFC" value="9153"/>
        <seriesInfo name="DOI" value="10.17487/RFC9153"/>
      </reference>
      <reference anchor="drip-detim" target="https://www.ietf.org/archive/id/draft-wiethuechter-drip-detim-arch-00.txt">
        <front>
          <title>DRIP Entity Tag (DET) Identity Management Architecture</title>
          <author fullname="Adam Wiethuechter" initials="A." surname="Wiethuechter">
            <organization>AX Enterprize, LLC</organization>
          </author>
          <author fullname="Stuart W. Card" initials="S. W." surname="Card">
            <organization>AX Enterprize, LLC</organization>
          </author>
          <author fullname="Robert Moskowitz" initials="R." surname="Moskowitz">
            <organization>HTT Consulting</organization>
          </author>
          <author fullname="Jim Reid" initials="J." surname="Reid">
            <organization>RTFM llp</organization>
          </author>
          <date day="27" month="September" year="2022"/>
          <abstract>
            <t>   This document describes the high level architecture for the
   registration and discovery of DRIP Entity Tags (DETs) using DNS
   technologies and practices.  Discovery of DETs and their artifacts
   are through the existing DNS structure and methods by using FQDNs.  A
   general overview of the interfaces required between components is
   described in this document with supporting documents giving technical
   specifications.

            </t>
          </abstract>
        </front>
        <seriesInfo name="Internet-Draft" value="draft-wiethuechter-drip-detim-arch-00"/>
      </reference>
      <reference anchor="RFC2119" target="https://www.rfc-editor.org/info/rfc2119">
        <front>
          <title>Key words for use in RFCs to Indicate Requirement Levels</title>
          <author fullname="S. Bradner" initials="S." surname="Bradner">
            <organization/>
          </author>
          <date month="March" year="1997"/>
          <abstract>
            <t>In many standards track documents several words are used to signify the requirements in the specification.  These words are often capitalized. This document defines these words as they should be interpreted in IETF documents.  This document specifies an Internet Best Current Practices for the Internet Community, and requests discussion and suggestions for improvements.</t>
          </abstract>
        </front>
        <seriesInfo name="BCP" value="14"/>
        <seriesInfo name="RFC" value="2119"/>
        <seriesInfo name="DOI" value="10.17487/RFC2119"/>
      </reference>
      <reference anchor="RFC8174" target="https://www.rfc-editor.org/info/rfc8174">
        <front>
          <title>Ambiguity of Uppercase vs Lowercase in RFC 2119 Key Words</title>
          <author fullname="B. Leiba" initials="B." surname="Leiba">
            <organization/>
          </author>
          <date month="May" year="2017"/>
          <abstract>
            <t>RFC 2119 specifies common key words that may be used in protocol  specifications.  This document aims to reduce the ambiguity by clarifying that only UPPERCASE usage of the key words have the  defined special meanings.</t>
          </abstract>
        </front>
        <seriesInfo name="BCP" value="14"/>
        <seriesInfo name="RFC" value="8174"/>
        <seriesInfo name="DOI" value="10.17487/RFC8174"/>
      </reference>
    </references>
    <section anchor="api-spec" numbered="true" toc="default">
      <name>OpenAPI Specification</name>
      <t>TODO</t>
      <!-- TODO: put OpenAPI YAML/JSON file into GitHub of draft and point it here -->

</section>
  </back>
  <!-- ##markdown-source:
H4sIAFkYM2MAA81WbW/bNhD+bsD/4ZoAQwNUqpO6aOMNRV3bazz4bbaDLhiG
gZJoi7NMaiRlzw3633dHSracbuvXfZJIHnnPPXfPkUEQNBuxSoRcd6Cwq+Bt
s9FsWGEz3oH+fDiDOV8LY/UB7pbLGQyl5XrFYt5ssCjSfPctq0TFkm3xsESz
lQ32gtu04HGKBkGiRR7ocmeQWpsHrRbCYZavlT50wNiE4Ihcd8DqwtibVuu2
dYO+NWcd70Zy22zs1+RA5PBJ6Q3GAh+1KvJmY7M/WQV9QuCOP55sLJPJ7yxT
EhEeuGk2ctGBX62KX4BR2mq+Mvh32PqfWG23XFrzG+1lhU2V7tBvAABCmg50
Q/hUi7DZwAXw8XcTtv2HRaURevcXGBDKXIvP/AWMRj2/iLxwjmjbt+030CPn
OhYsg74WO+5NYmGRqAcMeyeyrJwkTpXswOShNFIJIrh+1b59XU0U0hLD94uu
n+FbJrIOMEQZ1pP0nv3Fj9BCJKAW7SKEHtNJPcqFLZi2ten/WXzGFmGM4P4r
rHkIY2U2ai/s53pscxVxjO3JmgsQqx7xS1NkFqvvPLiLi3okU7aBGdOb80DG
w3og7bc3r958IxC93r7PWGRClE0Qe9c+jmZDKr1lFins+C3zH3u3169fdeAS
Ssn9WQjNXSl7CzedcCu2qJegH/6bWJ1JwHScOl3KVc0TMhgEgJCsZrGl8TIV
BrABFOQJEr4Skhtg0jeJiBmeIONlq4DCkHC5sCnX8NNiOkFqofdhOgf0Air6
g8cWuPTNyrhJNH3SflZabYH5yZlWO2GQXzq3uyYMz/uz7hVYBabIc9S3N8Ta
xNzAkq3RYLC8QogIzCLUJBEWD8CSPMaqJJQtyw8wAFV5HCbcHzVmkq0dwdXh
z/vD8eAqhCVCPqJFehhkai1ilmUHKPOSUJ/JsSXhbrWis3ErxsospIgsQw4p
8B3TQhUG+pMFrAoZExpPi8NyBpICypTaFHlJM4ZpwipnW5EkJK1m45K6pVZJ
4U7zOTzHi7AIFAH4Gq5BNiq8BERY4npVZCvUrt+jMrf/DB2On+TBuESYK1qK
M0FHh9AF165RvajZeuUgLMl5gnO+KHBMOdkpUVqpnGsWiYxOF8YUyGDE7Z5z
CTsuE6VNVRCOG8JCjNVZLrNUj7WkgaJ1VM6wbh8fTzr58sWtH9kb3y+WTifv
IKfSJMBM1uJwlNGIlcnELpN6H7MulY4wNetx9wGjALVDtySoRZlaks5Lp5tK
LBCG4dd6FL6MnCxFlQd77qMSQsRTthNKfw8m57FYlQVbkXgWJu1hHjFmTLLc
pMpWZE1zLruz4ekYryFXOI+PLBcBrSBzWOxkjzTyI64KuoG8iDJhUozte08S
g/v50GU9jrlxTabIE3xIJOeuQl/lS663QipM6gEeL+1p9MWtX2I0ZW3XLCs5
bPgB9konBi4opRcv/BcmU/c/H/x8P5wP+vS/uOuORsefymJxN70f9U9/p529
6Xg8mPT9ZpyFJ1OYc/wQwxfT2XI4nXRHF0TdGT2AryOiAotD+DuOEw8MLbiJ
tYiceOBDbwbXbWT9Gd4PN9fXt8i6H7y9ftPGwT7l0jtTEpPth5gUTHGec6ad
2FHXMabNsgzfR+gCk72XgC2cl1QPZJIrxAH9Y6EZ+A4+lBVFRl08hJdmxjc6
g+OqKZA+/WWFFc5dWZxqnLqycY59mn1s5zJ0SIauALXrFkziTYHXaIHDpNAk
kR3LRFJ1dGdQIcLacvdVu9Vy97PTMZFriGvkmQD5JlXVIvrF0xEKPlMNnljd
VVxrpcOyxBZc01tnUmwj7mhYTvvTcm1KDcuqp9P0qkVe8KWBTTrDxxY7tumT
0QLrn8IY9p8s9FKRJa5d1RfoAohYvPHZqvS5ONPn4+VRmfWtPzzDvTTooCDt
ce9Ddzx66S5wbPvcX5Afhb0rIlKye1q4qvLs4h3h0hIE7xp/A2BLAq6ODAAA

-->

</rfc>
