<p>SHCのフォーマットは発行元が認証可能な<a href="https://datatracker.ietf.org/doc/html/rfc7515">JWS</a>
を実装しています。</p>
<p>使用の方法は、図での説明が<a href="https://www.dxhealth.jp/blogs/%E5%AE%9F%E8%A3%85%E4%BE%8B/SHC%E7%94%9F%E6%88%90%E9%81%8E%E7%A8%8B">SHC生成過程</a> で表示されていますが、そのうちのデコードの部分を
下記に示していきます。</p>
<h2 id="%E3%83%9A%E3%82%A4%E3%83%AD%E3%83%BC%E3%83%89%E3%81%A8%E3%83%98%E3%83%83%E3%83%80" tabindex="-1">ペイロードとヘッダ</h2>
<p>QRCodeをデコードすると、中身はshc://のプロトコルの様な記入から始まります。
<a href="https://www.iana.org/assignments/uri-schemes/prov/shc">IAMANA</a>
その次にQR Codeで情報を伝えられない量の情報が入っている場合はその何番目のQR Codeかという情報が
入っています。（こちらはDeprecatedになっています。）
その次に数が順列されます。例は下記の様なものtです。</p>
<pre><code>shc:/56762909524320603460....
</code></pre>
<p>最後の &quot;shc:/&lt;number&gt;&quot;
これは <a href="https://datatracker.ietf.org/doc/html/rfc7797#section-5.2">rfc7797#section-5.2</a>
に基づき、UTF-8のキャラクターを２Digitsづつで表した数字です。</p>
<p>これをUTF-8のキャラクターに変更すると、下記の様になります。</p>
<pre><code>RUxMMTFXOifQ.KGJiFWI.OGZq1bUT
</code></pre>
<p>実際にはもう少し多いキャラクターになりますが、大きく二つのドットで分けられる３つのパートになります。</p>
<p>３つのパートが</p>
<p>＜ヘッダ＞．＜ペイロード＞．＜参照ハッシュ＞</p>
<p>となります。そのうち、ヘッダとペイロードはBase64のデコードし、そのバッファを
UTF-8 で エンコードし、JSONのフォーマットとして、パースできるようになります。</p>
<p>このフォーマットは(JWT-JSON Web Token)[https://www.w3.org/TR/vc-data-model/#jwt-encoding]
の仕様に基づいています。またこちらには日本語による<a href="https://tex2e.github.io/rfc-translater/html/rfc7519.html">JWTの説明</a>　内容は(https://jwt.io/)[https://jwt.io/]　のツールなどを使い、decodeできます。
がされています。
この中身は発行元のパブリックキーにより改ざんされていない証明書ということを確認できます。</p>
<p>パート１：ヘッダ(header)　</p>
<p>パート２：ペイロード（payload)</p>
<p>パート3 ：参照ハッシュ（Verify Signiture)</p>
<h2 id="%E8%AA%8D%E8%A8%BC%E3%81%AE%E3%83%97%E3%83%AD%E3%82%BB%E3%82%B9" tabindex="-1">認証のプロセス</h2>
<ol>
<li>パート１のヘッダの中か&quot;kid&quot; を取得します。</li>
<li>パート2 のペイロードの中にISSが記入されています。</li>
<li>ステップ２を利用し、パブリックキーを取得します。</li>
<li>JOSELibraryを使用し、ステップ３で取得したJWSのパブリックキーを利用し、
改ざんされていないかチェックします。</li>
</ol>
<h2 id="jws%E3%81%AE%E3%83%91%E3%83%96%E3%83%AA%E3%83%83%E3%82%AF%E3%82%AD%E3%83%BC%E3%81%AE%E5%8F%96%E5%BE%97" tabindex="-1">JWSのパブリックキーの取得</h2>
<p>このセクションではどのようにパブリックキーを取得するかを説明します。</p>
<p>パート２のペイロードには Base64 でデコードし、UTF-8のキャラクターにエンコードすると、
発行元と発行元からパブリックキーを探すBase URLが <em>iss</em> が
入っています。
そこに &quot;.well-known/jwks.json&quot; を追加し、その中に、多目的に使用されている
発行済のパブリックキーのリストがあります。</p>
<pre><code>
例で言うと日本のCovid18のワクチンのQRコードのヘッダのISSは現在、
https://vc.vrs.digital.go.jp/issuer　となっています。

そこに、&quot;.well-known/jwks.json&quot;　を追加し、
https://vc.vrs.digital.go.jp/issuer/.well-known/jwks.json
</code></pre>
<p>を取得します。
'keys'のフィールドから</p>
<pre><code>&quot;kty&quot;: &quot;EC&quot;, &quot;use&quot;: &quot;sig&quot;, and &quot;alg&quot;: &quot;ES256&quot;
</code></pre>
<p>にマッチし、また　<em>kid</em> フィールドがステップ１の<em>kid</em>と同じパブリックキーをJOSEライブラリに
読み込ませます。ここでいうパブリックキーとは下記のようなJSONのオブジェクトです。</p>
<pre><code>{
      &quot;kty&quot;: &quot;EC&quot;,
      &quot;kid&quot;: &quot;f1vhQP9oOZkityrguynQqB4aVh8u9xcf3wm4AFF4aVw&quot;,
      &quot;use&quot;: &quot;sig&quot;,
      &quot;alg&quot;: &quot;ES256&quot;,
      &quot;x5c&quot;: [
        &quot;MIIByjCCAXGgAwIBAg...=&quot;,
        &quot;MIIBlTCCATugAwIBA...==&quot;
      ],
      &quot;crv&quot;: &quot;P-256&quot;,
      &quot;x&quot;: &quot;ViKBgZ0f3pQKv-tSz653HUtIzCS8TVSNu1Hwi0tKpSk&quot;,
      &quot;y&quot;: &quot;01177apKXH2HgGfkn71ZPEljWk0Q2fcEzY2_XOfL_Zc&quot;
    }
</code></pre>
<p>パブリックキーを読み込ませた、JOSE ライブラリでJWKの <base64header>.<base64payload>.<verifykey>
を改ざんされていないか検証します。</p>
<p>実装の際には<a href="#%E5%90%84%E8%A8%80%E8%AA%9E%E3%81%AEjose%E3%83%A9%E3%82%A4%E3%83%96%E3%83%A9%E3%83%AA">各言語のJOSEライブラリ</a>の項目各言語でライブラリが用意されています。</p>
<h2 id="vci%E3%81%B8%E3%81%AE%E7%99%BB%E9%8C%B2%E7%A2%BA%E8%AA%8D%E4%BD%9C%E6%A5%AD" tabindex="-1">VCIへの登録確認作業</h2>
<p>前記の項目でSHCの発行元は認証できました。しかし、どの機関でもSHCは基準に従えば、発行できてしまいます。
まだ発行元が公式にVCI Directoryに登録されている発行元妥当ことを確認する必要があります。</p>
<p>payloadの中の iss の値を再び使用します。</p>
<p>最新の<a href="https://github.com/the-commons-project/vci-directory/blob/main/vci-issuers.json">VerifiedIssuer</a>JSONを獲得し、その中の&quot;participating_issuers&quot;の中にissの値があるか確認します。</p>
<p>issがあれば、登録確認済みとなります。</p>
<h2 id="%E5%90%84%E8%A8%80%E8%AA%9E%E3%81%AEjose%E3%83%A9%E3%82%A4%E3%83%96%E3%83%A9%E3%83%AA" tabindex="-1">各言語のJOSEライブラリ</h2>
<h3 id="java%3A" tabindex="-1">Java:</h3>
<p><a href="https://connect2id.com/products/nimbus-jose-jwt">Nimbus JOSE + JWT</a> : A comprehensive library for working with JWT (JSON Web Tokens) and related specifications, including JWS verification.</p>
<h3 id="ruby%3A" tabindex="-1">Ruby:</h3>
<p><a href="https://github.com/potatosalad/ruby-jose/blob/master/docs/GettingStarted.md">ruby-jwt</a>: A library that provides JWT and JWS support in Ruby. It allows you to verify JWS tokens and extract the payload.</p>
<h3 id="javascript%3A" tabindex="-1">JavaScript:</h3>
<p><a href="https://github.com/cisco/node-jose">node-jose</a> : A JavaScript implementation of the JSON Object Signing and Encryption (JOSE) for current web browsers and node.js-based servers. This library implements (wherever possible) all algorithms, formats, and options in JWS, JWE, JWK, and JWA and uses native cryptographic support (WebCrypto API or node.js' &quot;crypto&quot; module) where feasible.</p>
<p><a href="https://www.npmjs.com/package/jsonwebtoken">jsonwebtoken</a>: A widely used library for handling JWT and JWS in JavaScript. It provides functions to verify JWS tokens and extract the payload.</p>
<h3 id="go%3A" tabindex="-1">Go:</h3>
<p><a href="https://github.com/go-jose/go-jose">go-jose</a>: A powerful library for working with JOSE standards in Go. It includes support for JWS verification and token validation.</p>
<h3 id="python%3A" tabindex="-1">Python:</h3>
<p><a href="https://github.com/jpadilla/pyjwt">PyJWT</a>: A popular library for handling JWT in Python. It supports JWS verification and provides functions to extract the payload.</p>
<h1 id="thank-you%EF%BC%81" tabindex="-1">Thank you！</h1>
<p>この文章を制作するために御協力頂いた<a href="https://www.minacare.co.jp/">MinaCare</a> Teamの方々, ありがとうございました。</p>
<h1 id="reference" tabindex="-1">Reference</h1>
<p><a href="https://spec.smarthealth.cards/">spec.smarthealthfcards</a></p>


 SHCの情報の認証と基準

<h1 id="shl%E3%81%AE%E4%BD%9C%E6%88%90%E3%81%A8%E5%8F%96%E3%82%8A%E8%BE%BC%E3%81%BF" tabindex="-1">SHLの作成と取り込み</h1>
<p>IPSなど一回の情報の情報が多い場合、また携帯などでの保管が無理な場合は
情報のリンクのみを個人の意思で渡し、個人がそのリンクを教えた人、機関のみが閲覧できる基準をSHL(SMART® Health Link)と言います。</p>
<p>SHLはHLS7のFHIRのカテゴリーに入っており、国々を跨ぐ医療情報の提供方法として働きます。</p>
<p>情報の中身はFHIRの形式になっています。ここではSHLの処理用法とともに、医療保険の情報のシェアのユースケース、
それによって可能になる未来を取り上げてみました。</p>
<h1 id="shl%E3%81%AE%E7%9B%AE%E7%9A%84" tabindex="-1">SHLの目的</h1>
<p>SHLの目的はFHIRのリソースを<a href="https://docs.smarthealthit.org/smart-health-links/spec">SHL仕様</a>に基づき、情報開示します。</p>
<p>こちらも、
SHLを連絡するために渡す側はその際のパスコードを作成します。またリンクは仕様に沿えば、閲覧は
SHLの仕様に沿ったどのアプリケーションでも閲覧できることができます。</p>
<p>SHLの目標としては、一時的に、パスコードを使って暗号化したFHIRのデータをサーバーにおき、そのパスコードを
使い、どこからでも情報が取得できるために作られています。SHCと同じでQRコードなどで共有できますが、違いは
データ自体はそこに入っていません。</p>
<h1 id="shl" tabindex="-1">SHL</h1>
<img title="SHL" src="https://github.com/airinterface/dxhealth.jp/assets/2448586/fc375d75-1443-4f47-b665-85484f89d0ca" style="width:600px" >
<h1 id="%E5%85%B1%E6%9C%89%E6%96%B9%E6%B3%95" tabindex="-1">共有方法</h1>
<p>　共有方法は、リンクはテキストなので、様々な方法で共有できることができます。
　例）
　QRCode,Link,添付などでの共用が可能です。</p>
<h1 id="%E5%85%B1%E6%9C%89%E3%81%99%E3%82%8B%E5%86%85%E5%AE%B9" tabindex="-1">共有する内容</h1>
<p>　共有されたリンクのコンテンツはSHLのプロトコル以降がメタデータとなります。それはBase64で
エンコードされたStringですが、それをデコードすると、下記の構造のJSONデータにデコードできます。</p>
<p>例）共有されたリンク</p>
<pre><code>https://shctemp.z5.web.core.windows.net/shlink.html#shlink:/eyJ1cmwiOiJodHRwczovL3Jhdy5naXRodWJ1c2VyY29udGVudC5jb20vc2Vhbm5vL3NoYy1kZW1vLWRhdGEvbWFpbi9jYXJkcy9jaWduYS1kZXNpZ24vandzLnR4dCIsImZsYWciOiJMVSIsImtleSI6InJ4VGdZbE9hS0pQRnRjRWQwcWNjZU44d0VVNHA5NFNxQXdJV1FlNnVYN1EiLCJsYWJlbCI6IkRlbW8gU0hMIGZvciBjaWduYS1kZXNpZ24ifQ
</code></pre>
<p>SHLのデータ</p>
<pre><code>shlink:/eyJ1cmwiOiJodHRwczovL3Jhdy5naXRodWJ1c2VyY29udGVudC5jb20vc2Vhbm5vL3NoYy1kZW1vLWRhdGEvbWFpbi9jYXJkcy9jaWduYS1kZXNpZ24vandzLnR4dCIsImZsYWciOiJMVSIsImtleSI6InJ4VGdZbE9hS0pQRnRjRWQwcWNjZU44d0VVNHA5NFNxQXdJV1FlNnVYN1EiLCJsYWJlbCI6IkRlbW8gU0hMIGZvciBjaWduYS1kZXNpZ24ifQ
</code></pre>
<p>Base64のデータ</p>
<pre><code>eyJ1cmwiOiJodHRwczovL3Jhdy5naXRodWJ1c2VyY29udGVudC5jb20vc2Vhbm5vL3NoYy1kZW1vLWRhdGEvbWFpbi9jYXJkcy9jaWduYS1kZXNpZ24vandzLnR4dCIsImZsYWciOiJMVSIsImtleSI6InJ4VGdZbE9hS0pQRnRjRWQwcWNjZU44d0VVNHA5NFNxQXdJV1FlNnVYN1EiLCJsYWJlbCI6IkRlbW8gU0hMIGZvciBjaWduYS1kZXNpZ24ifQ
</code></pre>
<p>デコードされたBase64のSHLペイロード（データ）</p>
<pre><code>{
  &quot;url&quot;: &quot;https://raw.githubusercontent.com/seanno/shc-demo-data/main/cards/cigna-design/jws.txt&quot;,
  &quot;flag&quot;: &quot;LU&quot;,
  &quot;key&quot;: &quot;rxTgYlOaKJPFtcEd0qcceN8wEU4p94SqAwIWQe6uX7Q&quot;,
  &quot;label&quot;: &quot;Demo SHL for cigna-design&quot;
}
</code></pre>
<h2 id="%E3%83%87%E3%83%BC%E3%82%BF%E3%81%AE%E3%83%97%E3%83%AD%E3%83%91%E3%83%86%E3%82%A3" tabindex="-1">データのプロパティ</h2>
<p>デコードされたデータの中に医療データ情報の手段と、
いつ期限が設定されています。</p>
<p><strong>url</strong>: データ取得用のマニフェストのURL</p>
<p><strong>key</strong>: データをデコードするためのキー</p>
<p><strong>exp</strong>: 任意。エポックの秒でタイムスタンプで示されてます。このフィールドがある場合、期限切れ時間を示します。</p>
<p><strong>label</strong>: 任意。８０キャラクター以内の短いこのSHLについての内容説明</p>
<p><strong>v</strong> : 任意。SHL仕様のバージョン。このプロパティーがない場合は１となります。</p>
<p><strong>flag</strong>: 任意。フラグアルファベットの順番で、１キャラクターずつの有無が意味を持ちます。</p>
<ul>
<li>
<p>L: 同じリンクは長期使用予定を示し、URLで取得した内容が変化し続けることを示します。</p>
<p>これが内意場合はURLのデータの変化はないことを示しますが、その場合、expのフィールドを参照し、その期限を確認してください。</p>
</li>
<li>
<p>P: URLを使用したデータ取得にはパスコードが必要。このフラグがない場合は
パスコード必要なしとなります。</p>
</li>
<li>
<p>U: URLでのデータ取得の際はGETメソッド使用。
パスコード必要時（Pのフラグがある場合）はこのフラグ使用は推奨できません。</p>
</li>
</ul>
<h4 id="%E3%83%91%E3%82%B9%E3%82%B3%E3%83%BC%E3%83%89%E3%82%A8%E3%83%A9%E3%83%BC%E5%AF%BE%E5%87%A6" tabindex="-1">パスコードエラー対処</h4>
<p>サーバー側はもし、パスコードが必要な際、パスコードを間違った際は４０１のResponseとして、BodyにJSONのプロパティ　’remainingAttempts’　のナンバーを提供します。そこにあと何回提供されたパスコードでデータを取得できるかを指定しています。</p>
<h2 id="%E3%83%87%E3%83%BC%E3%82%BFmanifest%E3%81%AE%E5%87%A6%E7%90%86" tabindex="-1">データmanifestの処理</h2>
<p>SHLマニフェストURLから医療データの取得。フラグにより、リクエストの方法が
変わってくるので、注意してください。
ファイルアイテムは下記の情報のArray、もしくは、ひとつのコンテンツが入っています。</p>
<pre><code>
{
  &quot;files&quot;: [{
    &quot;contentType&quot;: &quot;application/smart-health-card&quot;,
    &quot;location&quot;: &quot;https://bucket.cloud.example.org/file1?sas=MFXK6jL3oL3SI_lRfi_-cEfzIs...&quot;
  }, 
  {
    &quot;contentType&quot;: &quot;application/smart-health-card&quot;,
    &quot;embedded&quot;: &quot;eyJhbGciOiJkaXIiLCJlbmMiOiJBMjU2R0NNIn0..8zH0NmUXGwMOqEya.xdGRpgyvE...&quot;
  },
  {
    &quot;contentType&quot;: &quot;application/fhir+json&quot;,
    &quot;location&quot;: &quot;https://bucket.cloud.example.org/file2?sas=T34xzj...&quot;
  }]
}
</code></pre>
<h3 id="%E3%83%87%E3%83%BC%E3%82%BF%E3%81%AE%E5%87%A6%E7%90%86" tabindex="-1">データの処理</h3>
<h3 id="%E3%83%87%E3%83%BC%E3%82%BF%E3%82%BF%E3%82%A4%E3%83%97" tabindex="-1">データタイプ</h3>
<p>コンテントタイプは下記のカテゴリーがあります。</p>
<p>&quot;application/smart-health-card&quot;</p>
<p>&quot;application/smart-api-access&quot;</p>
<p>&quot;application/fhir+json&quot;</p>
<p>これにより、その内容のタイプを把握します。</p>
<ol>
<li>
<p>application/smart-health-card</p>
<p>内容は <a href="https://smarthealth.cards/en/">SmartHealthCard</a>と同様となります。</p>
</li>
<li>
<p>application/smart-api-access: Smart App Launch を使用し、アクセスします。</p>
<p>この場合同じレベルに入る&quot;aud&quot;をBaseURLとし、もうひとつのフィールド&quot;query&quot;を使用して
FHIR サーバーにアクセスします。</p>
</li>
<li>
<p>application/fhir+json</p>
<p>FHIRリソースが直接データとして返されます。この場合Resource Type はBundleとして返されることがあると思います。</p>
</li>
</ol>
<p>DataのLocationがある場合はリンクを使用して、</p>
<p>上記のファイルの中には <em>location</em>　か <em>embedded</em>　が入っています。　<em>embedded</em> の場合は　そのままのデータを使い、<em>location</em>が入っている場合は、
GETにて取得します。</p>
<p>取得したデータは上記Manifestの<em>key</em>を使い、返信されたコンテンツを
JOSE のライブラリを使い、上記の<em>key</em>フラグを使い、下記のアルゴリズム
で、デコードします。</p>
<pre><code>                            alg: 'dir',
                            enc: 'A256GCM',
                            cty: &lt; Content Type &gt;
</code></pre>


 SHLの作成と取り込み

 IPSの仕様

<h1 id="%E5%8C%BB%E7%99%82%E3%83%87%E3%83%BC%E3%82%BFx%E6%94%BF%E5%BA%9C%E3%81%AE%E3%82%B5%E3%83%9D%E3%83%BC%E3%83%88" tabindex="-1">医療データx政府のサポート</h1>
<p>個人のデータの中に医療データが含まれますが、それをどこまで
政府がアクセスすることが可能かは国々で違います。
医療データが政府が発行する個人ナンバーと簡単に繋がる場合、
どこまで政府が個人データにアクセスできるのかを判断する基準になる
ためにもデータのカテゴリーを統一する必要性が出てきます。</p>
<p>アメリカでは 2020年から政府が、Final Rule for the 21st Century Cures Act　を提示
し、 医療機関へのFHIR（R4）での個人への開示を法律とし、その意向に
反する医療へは罰金が課されることになりました。
まだFHIR Resourceには色々なカテゴリー（ResourceType)があり、常に
FHIRの基準のバージョンの向上に努めているグループもあるので、
全部を提示するといったことはできていない状態です。（例）レントゲンやCATスキャンの
メディアなどはまだ課された情報開示の範囲に入っていません。</p>
<p>政府のCureActの基準化は明らかに医療機関のデジタル一本化を推進しました。</p>
<p>現在、<a href="https://www.commonhealth.org/network">The Commons Project</a>のネットワークも
それにより、１３００以上の医療機関から情報を情報取得可能となりさらに広がりつつあります。
FHIR R4は国際的に認められている基準です（例：アメリカ、イギリス）。
これは、政府、医療機関、医療保険機関、法人、民間企業、政府の団体、教育団体が働きかけて、
できた成果です。</p>
<p>しかし、この基準以上の政府のサポート、マイナンバーなどのコネクションが個人情報の不意な公開につながってしまう場合があります。それを必要とする場合もありますが、
国々でどこまで政府が実装の仕様に介入するか将来にそれがどのように影響するか
実装するアプリケーションはその情報が個人以外にどのように使用されるか明確に表示するべきでしょう。</p>


 医療データx政府のサポート

<h1 id="shc%E3%81%AE%E6%83%85%E5%A0%B1%E3%81%AE%E8%AA%8D%E8%A8%BC%E3%81%A8%E5%9F%BA%E6%BA%96" tabindex="-1">SHCの情報の認証と基準</h1>
<p>SHCのフォーマットは発行元が認証可能な<a href="https://datatracker.ietf.org/doc/html/rfc7515">JWS</a>
を実装しています。</p>
<p>使用の方法は、図での説明が<a href="https://www.dxhealth.jp/blogs/%E5%AE%9F%E8%A3%85%E4%BE%8B/SHC%E7%94%9F%E6%88%90%E9%81%8E%E7%A8%8B">SHC生成過程</a> で表示されていますが、そのうちのデコードの部分を
下記に示していきます。</p>
<h2 id="%E3%83%9A%E3%82%A4%E3%83%AD%E3%83%BC%E3%83%89%E3%81%A8%E3%83%98%E3%83%83%E3%83%80" tabindex="-1">ペイロードとヘッダ</h2>
<p>QRCodeをデコードすると、中身はshc://のプロトコルの様な記入から始まります。
<a href="https://www.iana.org/assignments/uri-schemes/prov/shc">IAMANA</a>
その次にQR Codeで情報を伝えられない量の情報が入っている場合はその何番目のQR Codeかという情報が
入っています。（こちらはDeprecatedになっています。）
その次に数が順列されます。例は下記の様なものtです。</p>
<pre><code>shc:/56762909524320603460....
</code></pre>
<p>最後の &quot;shc:/&lt;number&gt;&quot;
これは <a href="https://datatracker.ietf.org/doc/html/rfc7797#section-5.2">rfc7797#section-5.2</a>
に基づき、UTF-8のキャラクターを２Digitsづつで表した数字です。</p>
<p>これをUTF-8のキャラクターに変更すると、下記の様になります。</p>
<pre><code>RUxMMTFXOifQ.KGJiFWI.OGZq1bUT
</code></pre>
<p>実際にはもう少し多いキャラクターになりますが、大きく二つのドットで分けられる３つのパートになります。</p>
<p>３つのパートが</p>
<p>＜ヘッダ＞．＜ペイロード＞．＜参照ハッシュ＞</p>
<p>となります。そのうち、ヘッダとペイロードはBase64のデコードし、そのバッファを
UTF-8 で エンコードし、JSONのフォーマットとして、パースできるようになります。</p>
<p>このフォーマットは(JWT-JSON Web Token)[https://www.w3.org/TR/vc-data-model/#jwt-encoding]
の仕様に基づいています。またこちらには日本語による<a href="https://tex2e.github.io/rfc-translater/html/rfc7519.html">JWTの説明</a>　内容は(https://jwt.io/)[https://jwt.io/]　のツールなどを使い、decodeできます。
がされています。
この中身は発行元のパブリックキーにより改ざんされていない証明書ということを確認できます。</p>
<p>パート１：ヘッダ(header)　</p>
<p>パート２：ペイロード（payload)</p>
<p>パート3 ：参照ハッシュ（Verify Signiture)</p>
<h2 id="%E8%AA%8D%E8%A8%BC%E3%81%AE%E3%83%97%E3%83%AD%E3%82%BB%E3%82%B9" tabindex="-1">認証のプロセス</h2>
<ol>
<li>パート１のヘッダの中か&quot;kid&quot; を取得します。</li>
<li>パート2 のペイロードの中にISSが記入されています。</li>
<li>ステップ２を利用し、パブリックキーを取得します。</li>
<li>JOSELibraryを使用し、ステップ３で取得したJWSのパブリックキーを利用し、
改ざんされていないかチェックします。</li>
</ol>
<h2 id="jws%E3%81%AE%E3%83%91%E3%83%96%E3%83%AA%E3%83%83%E3%82%AF%E3%82%AD%E3%83%BC%E3%81%AE%E5%8F%96%E5%BE%97" tabindex="-1">JWSのパブリックキーの取得</h2>
<p>このセクションではどのようにパブリックキーを取得するかを説明します。</p>
<p>パート２のペイロードには Base64 でデコードし、UTF-8のキャラクターにエンコードすると、
発行元と発行元からパブリックキーを探すBase URLが <em>iss</em> が
入っています。
そこに &quot;.well-known/jwks.json&quot; を追加し、その中に、多目的に使用されている
発行済のパブリックキーのリストがあります。</p>
<pre><code>
例で言うと日本のCovid18のワクチンのQRコードのヘッダのISSは現在、
https://vc.vrs.digital.go.jp/issuer　となっています。

そこに、&quot;.well-known/jwks.json&quot;　を追加し、
https://vc.vrs.digital.go.jp/issuer/.well-known/jwks.json
</code></pre>
<p>を取得します。
'keys'のフィールドから</p>
<pre><code>&quot;kty&quot;: &quot;EC&quot;, &quot;use&quot;: &quot;sig&quot;, and &quot;alg&quot;: &quot;ES256&quot;
</code></pre>
<p>にマッチし、また　<em>kid</em> フィールドがステップ１の<em>kid</em>と同じパブリックキーをJOSEライブラリに
読み込ませます。ここでいうパブリックキーとは下記のようなJSONのオブジェクトです。</p>
<pre><code>{
      &quot;kty&quot;: &quot;EC&quot;,
      &quot;kid&quot;: &quot;f1vhQP9oOZkityrguynQqB4aVh8u9xcf3wm4AFF4aVw&quot;,
      &quot;use&quot;: &quot;sig&quot;,
      &quot;alg&quot;: &quot;ES256&quot;,
      &quot;x5c&quot;: [
        &quot;MIIByjCCAXGgAwIBAg...=&quot;,
        &quot;MIIBlTCCATugAwIBA...==&quot;
      ],
      &quot;crv&quot;: &quot;P-256&quot;,
      &quot;x&quot;: &quot;ViKBgZ0f3pQKv-tSz653HUtIzCS8TVSNu1Hwi0tKpSk&quot;,
      &quot;y&quot;: &quot;01177apKXH2HgGfkn71ZPEljWk0Q2fcEzY2_XOfL_Zc&quot;
    }
</code></pre>
<p>パブリックキーを読み込ませた、JOSE ライブラリでJWKの <base64header>.<base64payload>.<verifykey>
を改ざんされていないか検証します。</p>
<p>実装の際には<a href="#%E5%90%84%E8%A8%80%E8%AA%9E%E3%81%AEjose%E3%83%A9%E3%82%A4%E3%83%96%E3%83%A9%E3%83%AA">各言語のJOSEライブラリ</a>の項目各言語でライブラリが用意されています。</p>
<h2 id="vci%E3%81%B8%E3%81%AE%E7%99%BB%E9%8C%B2%E7%A2%BA%E8%AA%8D%E4%BD%9C%E6%A5%AD" tabindex="-1">VCIへの登録確認作業</h2>
<p>前記の項目でSHCの発行元は認証できました。しかし、どの機関でもSHCは基準に従えば、発行できてしまいます。
まだ発行元が公式にVCI Directoryに登録されている発行元妥当ことを確認する必要があります。</p>
<p>payloadの中の iss の値を再び使用します。</p>
<p>最新の<a href="https://github.com/the-commons-project/vci-directory/blob/main/vci-issuers.json">VerifiedIssuer</a>JSONを獲得し、その中の&quot;participating_issuers&quot;の中にissの値があるか確認します。</p>
<p>issがあれば、登録確認済みとなります。</p>
<h2 id="%E5%90%84%E8%A8%80%E8%AA%9E%E3%81%AEjose%E3%83%A9%E3%82%A4%E3%83%96%E3%83%A9%E3%83%AA" tabindex="-1">各言語のJOSEライブラリ</h2>
<h3 id="java%3A" tabindex="-1">Java:</h3>
<p><a href="https://connect2id.com/products/nimbus-jose-jwt">Nimbus JOSE + JWT</a> : A comprehensive library for working with JWT (JSON Web Tokens) and related specifications, including JWS verification.</p>
<h3 id="ruby%3A" tabindex="-1">Ruby:</h3>
<p><a href="https://github.com/potatosalad/ruby-jose/blob/master/docs/GettingStarted.md">ruby-jwt</a>: A library that provides JWT and JWS support in Ruby. It allows you to verify JWS tokens and extract the payload.</p>
<h3 id="javascript%3A" tabindex="-1">JavaScript:</h3>
<p><a href="https://github.com/cisco/node-jose">node-jose</a> : A JavaScript implementation of the JSON Object Signing and Encryption (JOSE) for current web browsers and node.js-based servers. This library implements (wherever possible) all algorithms, formats, and options in JWS, JWE, JWK, and JWA and uses native cryptographic support (WebCrypto API or node.js' &quot;crypto&quot; module) where feasible.</p>
<p><a href="https://www.npmjs.com/package/jsonwebtoken">jsonwebtoken</a>: A widely used library for handling JWT and JWS in JavaScript. It provides functions to verify JWS tokens and extract the payload.</p>
<h3 id="go%3A" tabindex="-1">Go:</h3>
<p><a href="https://github.com/go-jose/go-jose">go-jose</a>: A powerful library for working with JOSE standards in Go. It includes support for JWS verification and token validation.</p>
<h3 id="python%3A" tabindex="-1">Python:</h3>
<p><a href="https://github.com/jpadilla/pyjwt">PyJWT</a>: A popular library for handling JWT in Python. It supports JWS verification and provides functions to extract the payload.</p>
<h1 id="thank-you%EF%BC%81" tabindex="-1">Thank you！</h1>
<p>この文章を制作するために御協力頂いた<a href="https://www.minacare.co.jp/">MinaCare</a> Teamの方々, ありがとうございました。</p>
<h1 id="reference" tabindex="-1">Reference</h1>
<p><a href="https://spec.smarthealth.cards/">spec.smarthealthfcards</a></p>


<h1 id="%E3%83%87%E3%82%B8%E3%82%BF%E3%83%AB%E5%8C%96%E3%81%A8%E3%82%B0%E3%83%AD%E3%83%BC%E3%83%90%E3%83%AB%E5%8C%96%E3%81%AE%E3%82%AE%E3%83%A3%E3%83%83%E3%83%97" tabindex="-1">デジタル化とグローバル化のギャップ</h1>
<p>医療データのデジタル化が進む中、それが、市民に浸透するまでには国により、いろいろなギャップがあります。
The Commons Project ではFHIRのスタンダードをどのように受取りできるかという課題に取り込んでいます。
最近ではワクチン摂取証明をQRコード化、医療情報をWalletで持ち歩くことをGoogleやSamSungと行いました。
Appleも同じことを達成しています。</p>
<p>デジタル化が達成されつつありますが、まだ浸透するには様々な課題が残されています。</p>
<ul>
<li>
<p>データの受取側の実装がまだ少ない事実。しかし、これは同じ医療機関内ではすでに行われていることであり、
違う機関との受取りが少ないということ。まだ事実、日本では、FAXなどの使用例もありますし、アメリカの子供のワクチン接種証明を学校入学時に提示するのもなんと手書き。それに手書きの手数料が取られる。
これは是非他の方法に目をむけていかないといけない課題があります。</p>
</li>
<li>
<p>現在、移住を余儀なく強いられ、緊急に医療情報の持参を必要としている人々はまず、インターネットへの
接続が不可能な場所にいる場合も多く、またできたとしても、携帯自体、QRコードや医療情報を保存するアプリが保持できる、スマートフォンを持っていない場合が多いということです。グローバル化ということは、対応できる手段が様々な環境nの人々の生活に沿ってサービスを提供できていないと、達成できない。</p>
</li>
</ul>
<p>ギャップを埋める努力はとても地道であり、しかも国際政治が関係しないように繊細な注意をしながら、中立な立場で方向を決めていく必要があります。</p>


 デジタル化とグローバル化のギャップ

<p>#FHIR フォーマットの使用例</p>
<p>現在、アメリカでは保健福祉省（HHS）が医療機関からの個人への医療データのアクセスの公開を必須と
するという規則を2022年以内までに達成必須と提示しました。
これにより、この規則に沿わない医療機関へはペナルティーが発生します。
この強化により、医療機関の共通のデジタルデータFHIRフォーマットの実装率は<a href="https://ehrintelligence.com/news/api-adoption-slow-widespread-fhir-uptake-expected-by-2024">７５％を予測されています</a></p>
<p>これに連なり、医療保険機関のサービスデータのFHIRでの公開も発達してきています。</p>
<p><a href="https://www.thecommonsproject.org/">The Commons Project</a>では、アンドロイドアプリを通し、医療サービスプロバイダーからのアプリを通して
個人の医療データを安全に保存する機能、また、デバイスからデータを読み取り、FHIRをサポートする医療機関のへの
データ送信の実装をおこない、個人で自分、家族ののデータを持ち、それを他の医療機関で処理できる相互運用性
の確率を可能にします。</p>
<p><a href="https://www.apple.com/healthcare/health-records/">Apple Healthcare</a> でも同様にデータを相互運用できるように
FHIRでヘルスデータをアプリを通し、読み取り、管理できるようにできます。</p>
<p>FHIRで取り入れたデータは個人でのデータの保存の仕方は、アプリ以外でも(アプリからエキスポートした)
SMART® Health CardとしてWalletやQRコードでも参照できるようになっています。</p>


FHIR フォーマットの使用例

<h1 id="shc(smart%C2%AE-health-cards)%E3%81%AE%E7%94%9F%E6%88%90%E9%81%8E%E7%A8%8B" tabindex="-1">SHC(SMART® Health Cards)の生成過程</h1>
<p>SHCの生成過程には目標が２つあります。</p>
<ul>
<li>医療保険データの保存。</li>
<li>発行者の証明</li>
</ul>
<p>生成方法のステップは下の図を参考にしてください。</p>
<p>準備段階では、</p>
<p>情報にサインするPrivateKeyと公開するパブリックキー、キーIDを生成する。
＊詳細は<a href="https://github.com/smart-on-fhir/health-cards/blob/main/generate-examples/generate-cert-chain.sh">こちら</a>から
大事な部分は署名キーのプライベートキーを発行者が保存すること。</p>
<p>発行元（Issuer)とサイトは確保することから始めます。なぜなら、パプリックキーは
そこから公開するからです。（下記参照）</p>
<ol>
<li>発行元(Issuer)のサイトを<a href="https://vci.org/issuers">VCIDirectory</a> に登録申請する。</li>
<li>データの入ったFHIRフォーマット（バンドル）を作る</li>
<li>Public キーの ID の情報をバンドルのヘッダに追加し、それ全体からデータのシグニチャーを生成。</li>
<li>3でできたシグニチャーを後尾に追加して、キャラクターから数字を生成。</li>
<li>そこに&quot;shc:/&quot;　文字をデータを前に追加し、QRコードを作成する。またJSONファイルとして&quot;Varifiable
Credential&quot;のフィールドに追加する。</li>
</ol>
<p>アプリ側は
生成された、QRコード、ファイルを通じてメディカル情報の信憑性、発行者を確認する。
使用例は<a href="https://www.thecommonsproject.org/smart-health-card-verifier">Verifierアプリ</a>を御参照ください。</p>
<p><img src="https://user-images.githubusercontent.com/2448586/191780953-6958b29a-d90f-4447-ba26-83575c393d59.png" alt="SHC_JP"></p>


 SHC(SMART® Health Cards)の生成過程

<h1 id="smart%C2%AE-health-cards-%E3%81%AE%E6%B3%A8%E6%84%8F%E7%82%B9" tabindex="-1">SMART® Health Cards の注意点</h1>
<p>SHCの情報使用のアプリ、ユースケースを作成する際注意する点は
この中でデータのセキュリティーが入っていないのと、個人の証明
が抜けているを認識してください。</p>
<p>これは、一個人がマイナンバーカード、ワクチン接種証明の紙、保険情報を持ちあるくのと
同様です。このシステムの使用の際、またはアプリ作成の際には</p>
<ul>
<li>個人確認を新たに必要とすること</li>
<li>SHCのQRコードの情報を安全に保存すること</li>
</ul>
<p>使用例としては<a href="https://commonhealth.org/">CommonsHealth</a>では取得したQRコードのデータは個人の
アプリ内でエンクリプトし、その上に個人で指定したパスコードで情報が得られます。</p>


 SMART® Health Cards の注意点

<h1 id="smart%C2%AE-health-cards-%E3%81%AE%E7%94%9F%E6%88%90%E6%96%B9%E6%B3%95" tabindex="-1">SMART® Health Cards の生成方法</h1>
<p>SMART® Health Cards(SHC) は　OpenSourceのスタンダードで、誰でもも生成できます。
しかし、この生成元のサインインキーがどこでホストされ、
その証明用のパブリックのSignitureは発行は公式に<a href="https://vci.org/issuers">VCIの機構</a>に確認され、OpenSourceとして<a href="https://github.com/the-commons-project/vci-directory">Github</a>に
発表されます。これにより、のグローバルな信用性、中立性を確率しています。</p>
<p>発行者は毎年、新しいサインインキーを生成し、パブリックキVCI-Directoryに登録した発行者がホストする、サーバーの＜ISSと同じ生成者側がホストするサーバー&gt;/.well-known/jwks.json
に追加するのが推奨されます。つまり、プライベートキーは発行者のみが所持するため、そこで安全性を確保しています。</p>


 SMART® Health Cards の生成方法

<h1 id="smart%C2%AE-health-cards-%E3%81%A8%E3%81%AF" tabindex="-1">SMART® Health Cards とは</h1>
<p>FHIRの規定の実装例は前回上げましたが、それをどの方法を使用して、
データを取得したり、送信したりするのか、Web上ではにはRESTをつかいAPIで対応できますが、
最近はQRCode、ファイルなどを携帯のWalletに入れてワクチン接種の証明,
保険証の証明を行ったりすることもでてきます。</p>
<p>そのメインのデータ形式をSMART Health Cardsといいます。(この後、SHCと略称します。)</p>
<ol>
<li>健康保険機関、医療機関から、SMART® Health Cardといいます。
をQRコードまたは、ファイルで、発行してもらいます。</li>
<li>SMARTHealthCardを取り込めるアプリ、アンドロイドなどら、
<a href="https://play.google.com/store/apps/details?id=org.thecommonsproject.android.phr">CommonHealth　App</a>
iPhoneなら、<a href="https://www.apple.com/ios/health/">アップルヘルス</a>を使用し、スキャンし、自分のデータはWalletで
管理できます。</li>
<li>Walletから、QRコードを見せて、それを医療機関がスキャンすると、情報をスキャンした側に渡すことができます。</li>
<li>SHCの中には、健康保険証、医療機関を証明するための情報がヘッダーに、FHIRのフォーマットを使用した医療データがボディに
搭載されています。これを、本人が持つことにより、情報の送信、受信をコントロールすることができます。</li>
</ol>
<p>実装例は、<a href="https://www.commonhealth.org/smart-health-cards">こちら</a>に記入してあります。</p>


DxHealth

SHCの情報の認証と基準