Merge pull request #347 from w3c/osp-network-protocol

SHA: 5966ada
Reason: push, by markafoltz

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

index.html

@@ -7,7 +7,7 @@
   <link href="https://www.w3.org/StyleSheets/TR/2021/W3C-ED" rel="stylesheet">
   <meta content="Bikeshed version 6270e4735, updated Tue Aug 6 12:12:30 2024 -0700" name="generator">
   <link href="https://w3c.github.io/openscreenprotocol/" rel="canonical">
-  <meta content="9f704d479c84f2be583650c19a15c24ba548efcf" name="revision">
+  <meta content="5966adaee9cc412baaff330f33311fc6f054f033" name="revision">
   <meta content="dark light" name="color-scheme">
   <link href="https://www.w3.org/StyleSheets/TR/2021/dark.css" media="(prefers-color-scheme: dark)" rel="stylesheet" type="text/css">
 <style>
@@ -632,7 +632,7 @@
   <div class="head">
    <p data-fill-with="logo"><a class="logo" href="https://www.w3.org/"> <img alt="W3C" height="48" src="https://www.w3.org/StyleSheets/TR/2021/logos/W3C" width="72"> </a> </p>
    <h1 class="p-name no-ref" id="title">Open Screen Protocol</h1>
-   <p id="w3c-state"><a href="https://www.w3.org/standards/types#ED">Editor’s Draft</a>, <time class="dt-updated" datetime="2024-09-19">19 September 2024</time></p>
+   <p id="w3c-state"><a href="https://www.w3.org/standards/types#ED">Editor’s Draft</a>, <time class="dt-updated" datetime="2024-09-20">20 September 2024</time></p>
    <details open>
     <summary>More details about this document</summary>
     <div data-fill-with="spec-metadata">

network_messages.html

@@ -0,0 +1,48 @@
+<div class="highlight"><div><pre><span class="c1">; type key 1001</span>
+<span class="nc"><dfn>auth-capabilities</dfn> </span><span class="p">=</span> <span class="p">{</span>
+  <span class="mi">0</span><span class="p">:</span> <span class="kt">uint</span> <span class="c1">; psk-ease-of-input</span>
+  <span class="mi">1</span><span class="p">:</span> <span class="p">[</span><span class="o">*</span> <span class="nx">psk-input-method</span><span class="p">]</span> <span class="c1">; psk-input-methods</span>
+  <span class="mi">2</span><span class="p">:</span> <span class="kt">uint</span> <span class="c1">; psk-min-bits-of-entropy</span>
+<span class="p">}</span>
+
+<span class="nc">psk-input-method </span><span class="p">=</span> <span class="o">&amp;</span><span class="p">(</span>
+  <span class="nx">numeric</span><span class="p">:</span> <span class="mi">0</span>
+  <span class="nx">qr-code</span><span class="p">:</span> <span class="mi">1</span>
+<span class="p">)</span>
+
+<span class="nc"><dfn>auth-initiation-token</dfn> </span><span class="p">=</span> <span class="p">{</span>
+  <span class="p">?</span> <span class="mi">0</span><span class="p">:</span> <span class="nx">text </span><span class="c1">; token</span>
+<span class="p">}</span>
+
+<span class="nc">auth-spake2-psk-status </span><span class="p">=</span> <span class="o">&amp;</span><span class="p">(</span>
+  <span class="nx">psk-needs-presentation</span><span class="p">:</span> <span class="mi">0</span>
+  <span class="nx">psk-shown</span><span class="p">:</span> <span class="mi">1</span>
+  <span class="nx">psk-input</span><span class="p">:</span> <span class="mi">2</span>
+<span class="p">)</span>
+
+<span class="c1">; type key 1003</span>
+<span class="nc"><dfn>auth-spake2-confirmation</dfn> </span><span class="p">=</span> <span class="p">{</span>
+  <span class="mi">0</span><span class="p">:</span> <span class="nx">bytes .size 64 </span><span class="c1">; confirmation-value</span>
+<span class="p">}</span>
+
+<span class="nc">auth-status-result </span><span class="p">=</span> <span class="o">&amp;</span><span class="p">(</span>
+  <span class="nx">authenticated</span><span class="p">:</span> <span class="mi">0</span>
+  <span class="nx">unknown-error</span><span class="p">:</span> <span class="mi">1</span>
+  <span class="nx">timeout</span><span class="p">:</span> <span class="mi">2</span>
+  <span class="nx">secret-unknown</span><span class="p">:</span> <span class="mi">3</span>
+  <span class="nx">validation-took-too-long </span><span class="p">:</span> <span class="mi">4</span>
+  <span class="nx">proof-invalid</span><span class="p">:</span> <span class="mi">5</span>
+<span class="p">)</span>
+
+<span class="c1">; type key 1004</span>
+<span class="nc"><dfn>auth-status</dfn> </span><span class="p">=</span> <span class="p">{</span>
+  <span class="mi">0</span><span class="p">:</span> <span class="nx">auth-status-result </span><span class="c1">; result</span>
+<span class="p">}</span>
+
+<span class="c1">; type key 1005</span>
+<span class="nc"><dfn>auth-spake2-handshake</dfn> </span><span class="p">=</span> <span class="p">{</span>
+  <span class="mi">0</span><span class="p">:</span> <span class="nx">auth-initiation-token</span><span class="c1">; initiation-token</span>
+  <span class="mi">1</span><span class="p">:</span> <span class="nx">auth-spake2-psk-status </span><span class="c1">; psk-status</span>
+  <span class="mi">2</span><span class="p">:</span> <span class="nx">bytes </span><span class="c1">; public-value</span>
+<span class="p">}</span>
+</pre></div></div>