<?xml version="1.0" encoding="utf-8"?>
<?xml-model href="rfc7991bis.rnc"?>  <!-- Required for schema validation and schema-aware editing -->
<!-- <?xml-stylesheet type="text/xsl" href="rfc2629.xslt" ?> -->

<!DOCTYPE rfc [
  <!ENTITY nbsp    "&#160;">
  <!ENTITY zwsp   "&#8203;">
  <!ENTITY nbhy   "&#8209;">
  <!ENTITY wj     "&#8288;">
]>
<rfc
  xmlns:xi="http://www.w3.org/2001/XInclude"
  category="std"
  docName="draft-blanchet-regext-rdap-space-00"
  ipr="trust200902"
  obsoletes=""
  updates=""
  submissionType="IETF"
  xml:lang="en"
  version="3">
  <front>
    <title abbrev="Abbreviated Title">RDAP Query and Response for Space Objects and Networks</title>
    <seriesInfo name="Internet-Draft" value="draft-blanchet-regext-rdap-space-00"/>
   
    <author fullname="Marc Blanchet" initials="MB" surname="Blanchet">
      <address>
        <email>Marc.Blanchet@viagenie.ca</email>
      </address>
    </author>
    <date/>
    <area>General</area>
    <workgroup>Internet Engineering Task Force</workgroup>
    <keyword>RDAP DTN Space</keyword>
    <abstract>
      <t>Objects and networks in space are owned by entities, have locations and have identity or network address. This document describes Registration Data Access Protocol(RDAP) queries and response for these space objects and networks.</t>
    </abstract>
 
  </front>

  <middle>
    
    <section>
      <name>Introduction</name>
      <t>Objects and networks in space are owned by entities, have locations and have identity or network address. The space community through the Consultative Committee for Space Data Systems<xref target="ccsds"/> has setup registres<xref target="sana"/> and its related policies. These registries are managed by the Space Assigned Numbers Authority (SANA) that documents those properties for space objects and networks. Instead of reinventing another access protocol for registration data access, this document extends the Internet Registration Data Access Protocol(RDAP) (STD95) used for domain names, IP addresses and AS numbers by defining new queries and responses for the space objects and networks.</t>
      <t>Except if explicitly specified or not relevant, all considerations of <xref target="RFC9082"/>, <xref target="RFC9083"/> are herein inherited.</t>
      <section>
        <name>Requirements Language</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"/>
          <xref target="RFC8174"/> when, and only when, they appear in
          all capitals, as shown here.</t>
      </section>
    </section>
    
    <section>
      <name>Queries</name>
      <t>This section is inspired and somewhat supplements <xref target="RFC9082"/> by adding new queries.</t>
      <t>In order to avoid any future name collision when an RDAP server may be answering both Internet domain names and IP addresses queries as well as this specification queries, the "space" keyword is prefixed in the path for the queries in this specification.</t>
      <t>Examples in this section use "https://examplespacerdapserver.org/rdap" as the URL prefix before the specified query path segment.</t>
      <section>
          <name>OID Path Segment</name>
          <t>Syntax: space/oid/&lt;oid&gt;</t>
          <t>Space objects, assets, organizations and networks are managed using unique identifiers based on the ISO Object Identifier hierarchy (OID). Therefore, any object may be queried using its OID. The OID must be provided from the ISO root. The OID is specified in its native form, which is number.number.number.number ...  Response format for each kind of object is specified in the Response section in this document.</t>
          <t>Examples:</t>
              <ul>
                  <li>https://examplespacerdapserver.org/rdap/space/oid/1.3.112.4.7.84 returns the data for the NASA Mars Reconnaissance Orbiter spacecraft.</li>
                  <li>https://examplespacerdapserver.org/rdap/space/oid/1.3.112.4.34.1 returns the data for a range of Bundle Protocol Node numbers belonging to NASA Goddard.</li>
              </ul>
      </section>
      <section>
          <name>CBHE Node Numbers Path Segment</name>
          <t>Syntax: space/cbhe/&lt;number-range&gt;</t>
          <t>Bundle protocol CBHE node numbers<xref target="RFC5050"/> are specified by a range of two unsigned integers separated by '-'. In case of a single node number, only the number is specified.</t>
          <t>Examples:</t>
              <ul>
                  <li>https://examplespacerdapserver.org/rdap/space/cbhe/100-256 returns the data for this range.</li>
                  <li>https://examplespacerdapserver.org/rdap/space/cbhe/45623 returns the data for this specific node.</li>
              </ul>
      </section>
      <section>
         <name>Others TBD: assets, service sites, ...</name>
        <t>TBD</t>
      </section>
    </section>
    
    <section>
        <name>JSON Responses</name>
        <t>As JSON is liberal for adding new properties that receivers should ignore when they are unknown, it is forseen that some space RDAP registries may add more properties in their response than those specified in this document.</t>
        <t>This section inherits all considerations of <xref target="RFC9083"/> except noted.</t>
       <section>
         <name>ObjectClassName: entity</name>
         <t>Use JSContact instead of jCard as in RFC9083</t>
       </section>
       <section>
         <name>Node Id</name>
         <t></t>
       </section>
       <section>
         <name>ObjectClassName: serviceSite</name>
<sourcecode>
{
  "objectClassName": "serviceSite",
  "OID": "1.3.112.4.9.76",
  "Name": "Svalbard",
  "Abbreviation": "SVLBRD",
  "Aliases": [],
  "Location Type": "Surface",
  "Planetary Body": "Earth",
  "Country": "Norway",
  "City": "Svalbard",
  "Latitude": "-02.996090",
  "Longitude": "+040.194663",
  "Elevation": 456.01,
  "Trajectory": null,
  "Orbit": null,
  "Spacecraft": null,
  "Requestor": "1.3.112.4.2.222",
  "Affiliation": "1.3.112.4.1.37",
  "Apertures": [
    "1.3.112.4.9.76.1",
    "1.3.112.4.9.76.2",
    "1.3.112.4.9.76.3"
  ],
  "Owner": "1.3.112.4.1.37",
  "CreatedBy": "1.3.112.4.2.2",
  "Creation date": "2018-11-01T14:21:19.891375+00:00",
  "UpdatedBy": "1.3.112.4.2.2",
  "Update date": "2018-11-01T15:00:00.255626+00:00"
}
</sourcecode>
<t>TBD: explain the syntax of all properties</t>
       </section>
       <section>
          <name>Aperture</name>
<sourcecode>
  {
    "OID": "1.3.112.4.9.76.3",
    "Name": "SDA5",
    "Aliases": [],
    "Forward Links": [],
    "Return Links": [
      "1.3.112.4.9.76.3.1"
    ],
    "Location Type": "Surface",
    "Planetary Body": "Earth",
    "Latitude": "+781339.72",
    "Longitude": "+0152531.8",
    "Elevation": 460.68,
    "Diameter": null,
    "Aperture Type": null,
    "Pointing Constraints": [],
    "Available Services": [],
    "Created By": "1.3.112.4.2.2",
    "Creation date": "2018-11-01T14:58:33+00:00",
    "Updated By": "1.3.112.4.2.2",
    "Update date": "2018-11-01T17:54:58.889530+00:00"
  }
</sourcecode>
<t>TBD: explain the syntax of all properties</t>
       </section>
    </section>
    
    <section>
        <name>Transport</name>
        <t>This document assumes that queries about space objects and networks are done on the regular Internet to servers located on Earth, therefore the transport of such queries would use the same transport as specified by standard RDAP queries for domain names or IP addresses. It should be possible to carry those queries in space over an appropriate transport, such as DTN. However, this specification does not describe such transport.</t>
    </section>
    
    <section>
        <name>Finding Authoritative Servers</name>
        <t>The space community runs a service similar (and in fact inspired by) to IANA, named Space Assigned Numbers Authority (SANA) <xref target="sana"/>. Similar to <xref target="RFC9224"/>, this document specifies the bootstrap registry located at IANA with initial values.</t>
        <section>
            <name>OID Bootstrap Registry</name>
            <t>IANA will setup a new bootstrap registry for OIDs. The keys are the root of the OID subtree delegated to a specific RDAP server. The registry will be initially populated with a single entry:
                ["1.3.112.4"], ["https://rdap.sanaregistry.org/"]</t>
        </section>
    </section>
    
    <section anchor="IANA">
      <name>IANA Considerations</name>
      <t>TBD</t>
    </section>
    
    <section anchor="Security">
      <name>Security Considerations</name>
      <t>All security considerations of STD95 are herein inherited. While space assets and objects may have higher security risks than Earth equivalents, nothing in this specification add more security risks as the information of such assets is public. As with Internet RDAP, some information may be redacted (see TODO: internet draft redacted) when confidentiality is required. Moreover, authentication and authorization mechanisms such as TODO: openid-draft may be used  to access more confidential data.</t>
    </section>
  </middle>
  <back>
    <references>
      <name>References</name>
      <references>
        <name>Normative References</name>
        
        <xi:include href="https://www.rfc-editor.org/refs/bibxml/reference.RFC.2119.xml"/>
        <xi:include href="https://www.rfc-editor.org/refs/bibxml/reference.RFC.8174.xml"/>
        <xi:include href="https://www.rfc-editor.org/refs/bibxml/reference.RFC.9082.xml"/>
        <xi:include href="https://www.rfc-editor.org/refs/bibxml/reference.RFC.9083.xml"/>
        <xi:include href="https://www.rfc-editor.org/refs/bibxml/reference.RFC.9224.xml"/>
        <xi:include href="https://www.rfc-editor.org/refs/bibxml/reference.RFC.5050.xml"/>
        <!-- The recommended and simplest way to include a well known reference -->
        
      </references>
 
      <references>
        <name>Informative References</name>
        <reference anchor="sana" target="https://sanaregistry.org">
            <front><title>Space Assigned Numbers Authority (SANA)</title><author><organization>SANA</organization></author></front>
        </reference>
        <reference anchor="ccsds" target="https://ccsds.org">
        <front><title>Consultative Committee on Space Data Systems (CCSDS) </title><author><organization>CCSDS</organization></author></front>
        </reference>
      </references>
    </references>
    
    <section anchor="Acknowledgements" numbered="false">
      <name>Acknowledgements</name>
      <t>This work is based on a discussion with Peter Shames of Jet Propulsion Laboratory on how to provide information of space objects and networks.</t>
    </section>
 </back>
</rfc>
