<?xml version="1.0" encoding="utf-8" standalone="yes" ?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
  <channel>
    <title>Technical-Selection on Rindrics Mumbles</title>
    <link>https://rindrics.com/tags/technical-selection/</link>
    <description>Technical-Selection</description>    
    <generator>Hugo -- gohugo.io</generator>
    <language>en</language>
    <lastBuildDate>Wed, 23 Sep 2026 00:00:00 +0900</lastBuildDate>
    <atom:link href="https://rindrics.com/tags/technical-selection/index.xml" rel="self" type="application/rss+xml" />
    
    <item>
      <title>冪等性キー生成に関する技術選定: ハッシュアルゴリズム</title>
      <link>https://rindrics.com/posts/tech-selection-idempotency-key-hash-algorithm/</link>
      <pubDate>Wed, 23 Sep 2026 00:00:00 +0900</pubDate>
      
      <guid>https://rindrics.com/posts/tech-selection-idempotency-key-hash-algorithm/</guid>
      <description>&lt;p&gt;冪等性キーの生成に利用するハッシュアルゴリズムとしてBLAKE3を選定した。&lt;/p&gt;
&lt;h2 id=&#34;はじめに&#34;&gt;はじめに&lt;/h2&gt;
&lt;p&gt;資源評価に利用するデータの永続化を担うdata-registryの開発をすすめている。








&lt;div class=&#34;card&#34;&gt;
  &lt;a href=&#34;https://rindrics.com/tags/data-registry/&#34; target=&#34;_blank&#34; rel=&#34;noopener noreferrer&#34; class=&#34;card-link&#34;&gt;
    &lt;div class=&#34;card-content&#34;&gt;
      &lt;h4 class=&#34;card-title&#34;&gt;Tag &amp;#34;data-registry&amp;#34; | rindrics.com&lt;/h4&gt;
      
      &lt;span class=&#34;card-url&#34;&gt;https://rindrics.com/tags/data-registry/&lt;/span&gt;
    &lt;/div&gt;
  &lt;/a&gt;
&lt;/div&gt;
&lt;/p&gt;
&lt;p&gt;&lt;a href=&#34;../designing-idempotency-by-usecase/&#34;&gt;前回の記事&lt;/a&gt;では、冪等性キーをサーバー側で生成する意思決定をした。
本記事では、その冪等性キー生成に用いるハッシュアルゴリズムを選ぶ。&lt;/p&gt;
&lt;h2 id=&#34;背景&#34;&gt;背景&lt;/h2&gt;
&lt;p&gt;通常、ハッシュアルゴリズム選定における比較観点は下記の通りだ:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;衝突耐性&lt;/li&gt;
&lt;li&gt;計算コスト&lt;/li&gt;
&lt;li&gt;標準性&lt;/li&gt;
&lt;li&gt;相互運用性&lt;/li&gt;
&lt;li&gt;出力サイズ&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;ただしこれらの観点の重みは均等ではなく、特にdata-registryの冪等性キー生成においては何よりも衝突確率の低さを重視する必要がある。&lt;/p&gt;
&lt;div class=&#34;info&#34;&gt;
&lt;strong&gt;「衝突確率の低さ」とは&lt;/strong&gt;
&lt;p&gt;攻撃による衝突ではなく、単なる確率的な衝突が起こる程度を指している。理由としては、本ケースではセキュリティ目的で利用するわけではないので、「攻撃への耐性」という観点は必要ないため。&lt;/p&gt;
&lt;/div&gt;
&lt;p&gt;これは、冪等処理において、ハッシュ衝突が起きた場合に下記の流れでデータ喪失が生じるためだ:&lt;/p&gt;
&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;&#34;&gt;&lt;code class=&#34;language-fallback&#34; data-lang=&#34;fallback&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;先行リクエストA: hash(何らかのデータ) → hash=H
&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;  → Revision &amp;#34;newRev&amp;#34; が作成される → 返却
&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;後続リクエストB: hash(何らかの別のデータ) → hash=H (衝突)
&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;  → ルックアップで &amp;#34;newRev&amp;#34; を発見 → 返却
&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;  → クライアントは成功を受け取るが、登録依頼したデータは登録されていない（データ喪失）
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;このたび選定対象とした候補アルゴリズムは下記の三つ&lt;sup id=&#34;fnref:1&#34;&gt;&lt;a href=&#34;#fn:1&#34; class=&#34;footnote-ref&#34; role=&#34;doc-noteref&#34;&gt;1&lt;/a&gt;&lt;/sup&gt;:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;SHA-256&lt;/li&gt;
&lt;li&gt;SHA-512&lt;/li&gt;
&lt;li&gt;BLAKE3&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;上記のうち、まず衝突確率の低さが想定リクエスト数に照らして必要十分なものを選び、続いてその他の選定観点を比較して採用アルゴリズムを決める。&lt;/p&gt;
&lt;h2 id=&#34;衝突確率に着目した一次選定&#34;&gt;衝突確率に着目した一次選定&lt;/h2&gt;
&lt;p&gt;ということで、まずアルゴリズムの衝突確率がdata-registryの想定リクエスト数に照らして高すぎないかを調べてみる。
SHA-256とBLAKE3はともに出力長が256ビットで衝突確率は同じなので、まず出力長256ビットにおける衝突ペア数の期待値が想定リクエスト数のもとで1未満に収まるかを調べることで候補を絞る。
256ビットで足りなければSHA512の衝突確率の概算に進み、一方で256ビットで充分であればSHA256とBLAKE3の比較に進むということ。&lt;/p&gt;
&lt;p&gt;衝突確率は要は&lt;a href=&#34;https://en.wikipedia.org/wiki/Birthday_problem&#34;&gt;誕生日問題&lt;/a&gt;として考えることができるので、\(k\)個のリクエストから得られるハッシュ値について、衝突するペア数の期待値\(E[C]\)は、ハッシュ出力を\(b\)ビットとすると次式で近似できる。&lt;/p&gt;
$$
E[C] \approx \frac{k^2}{2^{b+1}}
$$&lt;p&gt;衝突が十分まれな範囲では、1組以上の衝突が発生する確率も次式で近似できる。&lt;/p&gt;
$$
P(\text{1組以上が衝突}) \approx \frac{k^2}{2^{b+1}}
$$&lt;p&gt;したがって、いま考える256ビットのハッシュでは、&lt;/p&gt;
$$
E[C] \approx \frac{k^2}{2^{257}}
$$&lt;p&gt;となる。&lt;/p&gt;
&lt;p&gt;選定にあたっては、衝突するペア数の期待値が1となるリクエスト数を求め、それが想定リクエスト数に対して余裕があるかを確認する。&lt;/p&gt;
&lt;p&gt;256ビットの場合、&lt;/p&gt;
$$
\frac{k^2}{2^{257}} = 1
$$&lt;p&gt;より、&lt;/p&gt;
$$
k \approx 2^{128.5} \approx 4.8 \times 10^{38}
$$&lt;p&gt;となる。&lt;/p&gt;
&lt;h3 id=&#34;利用程度に関するパラメータ&#34;&gt;利用程度に関するパラメータ&lt;/h3&gt;
&lt;p&gt;想定リクエスト数の算出に必要なパラメータを、オーダー規模で見積もる。
見積もりは悲観値で出したいので、オーダー単位で&lt;strong&gt;切り上げ&lt;/strong&gt;た値を利用する。&lt;/p&gt;
&lt;h4 id=&#34;ユーザー数&#34;&gt;ユーザー数&lt;/h4&gt;
&lt;p&gt;水産研究・教育機構の&lt;a href=&#34;https://www.fra.go.jp/shigen/fisheries_resources/index.html&#34;&gt;「水産資源に関する情報」ページ&lt;/a&gt;を見ると、本記事の執筆時点（2026年9月）において &lt;code&gt;沿岸沖合資源（192魚種）&lt;/code&gt; という記述がある（こんな多かったっけ&amp;hellip;？）。
192魚種それぞれの主担当者は、ほぼ確実に延べ人数つまり兼務があると見てよいと思うが、ここでは悲観見積もりとして一応192人の主担当者がいることにする。&lt;/p&gt;
&lt;p&gt;また資源評価プラットフォームに機能を充実させた場合、評価案査読者や、認証済みの（物好きな）一般利用者からの利用も考えられる。
合計ユーザー数をオーダー規模で見積もるにあたり、これらの利用者が808人を超えるようだと1000人のオーダーとなるが、まずそんなことはないだろう。&lt;/p&gt;
&lt;p&gt;ということで、ユーザー数は多くても数百人のオーダーに収まると考えられ、見積もり用に切り上げオーダーとしては &lt;code&gt;1000人&lt;/code&gt; を用いる。&lt;/p&gt;
&lt;h4 id=&#34;運用期間&#34;&gt;運用期間&lt;/h4&gt;
&lt;p&gt;資源評価事業は将来的にも継続するだろう。
10年未満ということはないはず。
しかし1000年はいくらなんでもやりすぎだろう。その頃にはもっと良い技術があるはず。&lt;/p&gt;
&lt;p&gt;ということでオーダーとしては &lt;code&gt;100年&lt;/code&gt;。&lt;/p&gt;
&lt;h4 id=&#34;ユーザーあたり並列計算数&#34;&gt;ユーザーあたり並列計算数&lt;/h4&gt;
&lt;p&gt;資源評価プラットフォームがいい感じに構築できるとしたら、パラメータセットの組み合わせが異なる複数シナリオをバックグラウンドで並列計算できるようにしたい。
並列計算機能が実現した場合、ユーザーごとに並列計算ジョブを持つことになる。
各ジョブに書き込み系の処理をさせるかどうかは設計次第ではあるが、ここでは悲観見積もりということでユーザーあたりの並列計算数も考慮しておく。&lt;/p&gt;
&lt;p&gt;実用的な視点に立つとは、並列計算の単位としては、名前をつけられるようなレベルの大きいシナリオだけでなく、パラメータの探索などでも利用する局面があるだろう。
そう考えると、10のオーダーの並列計算はあまり嬉しくないだろうと思う。百数十とか、数百の並列計算ができると、探索的検討がスムーズにできるはず。&lt;/p&gt;
&lt;p&gt;ということで、数百を切り上げるとオーダーとしては &lt;code&gt;1000&lt;/code&gt;。&lt;/p&gt;
&lt;h4 id=&#34;バースト利用期間&#34;&gt;バースト利用期間&lt;/h4&gt;
&lt;p&gt;悲観的に見積もるため、ここではバースト利用が資源評価の準備期間中にわたって続くと仮定する。&lt;/p&gt;
&lt;p&gt;なお事業の性質上、資源評価プラットフォームは年間通して平均的に利用されることはない。
data-registryが冪等性キーを生成する想定リクエスト数に関しては、利用はほぼ評価期間に限られるだろう。
このことから、定常利用はバーストに対して無視できる程度と思われる。&lt;/p&gt;
&lt;p&gt;ということで、バースト利用が3ヶ月間続くとし、オーダー単位で切り上げて &lt;code&gt;100日&lt;/code&gt;。&lt;/p&gt;
&lt;h4 id=&#34;リクエスト数の見積もり&#34;&gt;リクエスト数の見積もり&lt;/h4&gt;
&lt;p&gt;上記から、data-registryの冪等性キー生成リクエスト数の悲観見積もりのパラメータは下記のようになった:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;ユーザー数: 1000人&lt;/li&gt;
&lt;li&gt;運用期間: 100年&lt;/li&gt;
&lt;li&gt;ユーザーあたり並列計算数: 1000&lt;/li&gt;
&lt;li&gt;バースト利用期間: 100日&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;このパラメータもとでは、衝突ペア数の期待値を1未満に保つうえで、1ユーザーが発行できる年間のリクエスト数は&lt;/p&gt;
$$
\frac{4.8 \times 10^{38}}{1000 \times 100 \times 1000 \times 100} = 4.8 \times 10^{28}
$$&lt;p&gt;となる。&lt;/p&gt;
&lt;p&gt;実際には、ユーザー数も運用期間もここまでにはならないと思われるので、並列計算数もまだ増やす余地がある。
以上から、アルゴリズムのアウトプット長は256ビットで充分と思われたため、SHA512は選択肢から外す。&lt;/p&gt;
&lt;p&gt;ということで、以下では、SHA256とBLAKE3を、残る3観点について比較する:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;input checked=&#34;&#34; disabled=&#34;&#34; type=&#34;checkbox&#34;&gt; &lt;del&gt;衝突耐性&lt;/del&gt; 衝突確率の低さ&lt;/li&gt;
&lt;li&gt;&lt;input disabled=&#34;&#34; type=&#34;checkbox&#34;&gt; 計算コスト&lt;/li&gt;
&lt;li&gt;&lt;input disabled=&#34;&#34; type=&#34;checkbox&#34;&gt; 標準性&lt;/li&gt;
&lt;li&gt;&lt;input disabled=&#34;&#34; type=&#34;checkbox&#34;&gt; 相互運用性&lt;/li&gt;
&lt;li&gt;&lt;input checked=&#34;&#34; disabled=&#34;&#34; type=&#34;checkbox&#34;&gt; &lt;del&gt;出力サイズ&lt;/del&gt;
&lt;ul&gt;
&lt;li&gt;ともに256ビットのためスキップ&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&#34;その他の観点での比較&#34;&gt;その他の観点での比較&lt;/h2&gt;
&lt;h3 id=&#34;sha256&#34;&gt;SHA256&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;計算コスト: &lt;a href=&#34;https://www.researchgate.net/figure/Comparison-of-Photo-File-Hashing-Speed-SHA-256-vs-BLAKE3_tbl3_400072664&#34;&gt;こちらのベンチマーク結果&lt;/a&gt;によると、5 MBの写真ファイルのハッシュ化の所要時間が139.10 msということで、処理速度は35.9 MB/sとする&lt;/li&gt;
&lt;li&gt;標準性: 米国国立標準技術研究所（NIST）により&lt;a href=&#34;https://nvlpubs.nist.gov/nistpubs/FIPS/NIST.FIPS.180-4.pdf&#34;&gt;仕様化されて&lt;/a&gt;おり充分&lt;/li&gt;
&lt;li&gt;相互運用性: 実質上の業界標準なので充分&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&#34;blake3&#34;&gt;BLAKE3&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;計算コスト: &lt;a href=&#34;https://www.researchgate.net/figure/Comparison-of-Photo-File-Hashing-Speed-SHA-256-vs-BLAKE3_tbl3_400072664&#34;&gt;こちらのベンチマーク結果&lt;/a&gt;によると、5 MBの写真ファイルのハッシュ化の所要時間が38.00 msということで、処理速度は131.6 MB/sとする&lt;/li&gt;
&lt;li&gt;標準性: &lt;a href=&#34;https://datatracker.ietf.org/doc/draft-aumasson-blake3/00/&#34;&gt;RFC準拠の仕様&lt;/a&gt;が公開されており充分&lt;/li&gt;
&lt;li&gt;相互運用性: 主要言語に対応しており、Clojureでも&lt;a href=&#34;https://downloads.bouncycastle.org/java/docs/bcprov-jdk18on-javadoc/org/bouncycastle/crypto/digests/Blake3Digest.html#&#34;&gt;Javaライブラリ&lt;/a&gt;をJava interop経由で利用可能なので充分&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;比較観点をまとめると下記のようになる:&lt;/p&gt;
&lt;table&gt;
  &lt;thead&gt;
      &lt;tr&gt;
          &lt;th style=&#34;text-align: right&#34;&gt;Algorithm&lt;/th&gt;
          &lt;th style=&#34;text-align: center&#34;&gt;処理速度&lt;/th&gt;
          &lt;th style=&#34;text-align: center&#34;&gt;標準性&lt;/th&gt;
          &lt;th style=&#34;text-align: center&#34;&gt;相互運用性&lt;/th&gt;
      &lt;/tr&gt;
  &lt;/thead&gt;
  &lt;tbody&gt;
      &lt;tr&gt;
          &lt;td style=&#34;text-align: right&#34;&gt;SHA-256&lt;/td&gt;
          &lt;td style=&#34;text-align: center&#34;&gt;35.9 MB/s&lt;/td&gt;
          &lt;td style=&#34;text-align: center&#34;&gt;✓&lt;/td&gt;
          &lt;td style=&#34;text-align: center&#34;&gt;✓&lt;/td&gt;
      &lt;/tr&gt;
      &lt;tr&gt;
          &lt;td style=&#34;text-align: right&#34;&gt;🥇 BLAKE3&lt;/td&gt;
          &lt;td style=&#34;text-align: center&#34;&gt;131.6 MB/s&lt;/td&gt;
          &lt;td style=&#34;text-align: center&#34;&gt;✓&lt;/td&gt;
          &lt;td style=&#34;text-align: center&#34;&gt;✓&lt;/td&gt;
      &lt;/tr&gt;
  &lt;/tbody&gt;
&lt;/table&gt;
&lt;p&gt;その他、CPU負荷やメモリ効率についてもBLAKE3の優位性が報告されていた（&lt;a href=&#34;https://arxiv.org/html/2407.08284v1&#34;&gt;ref&lt;/a&gt;）。&lt;/p&gt;
&lt;p&gt;以上から、標準性・相互運用性は両アルゴリズムともに良好なため、計算コストの低さを重視してBLAKE3を採用する。&lt;/p&gt;
&lt;h2 id=&#34;所感&#34;&gt;所感&lt;/h2&gt;
&lt;p&gt;今回のケースでは、採用技術のスペックが非機能要件を大幅に上回っていたために、些細なことを大げさにやった感があるかもしれない。
しかしこれをやらないと、「キャパ的に3日と保たないシステムを作ってました」みたいな事態にもなりかねない。
仰々しくはあるが、やはり必要なのだ。&lt;/p&gt;
&lt;p&gt;次の記事では、冪等性キーを安定して生成するために必要なJSONシリアライズについて考える予定。&lt;/p&gt;
&lt;div class=&#34;footnotes&#34; role=&#34;doc-endnotes&#34;&gt;
&lt;hr&gt;
&lt;ol&gt;
&lt;li id=&#34;fn:1&#34;&gt;
&lt;p&gt;セキュリティ目的での利用ではないが、MD5とSHA-1については候補から除外した。理由としては、両者の衝突耐性が破られているため採用が減り、コミュニティ内でライブラリや情報の更新が途絶える懸念を回避するため&amp;#160;&lt;a href=&#34;#fnref:1&#34; class=&#34;footnote-backref&#34; role=&#34;doc-backlink&#34;&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;
&lt;/li&gt;
&lt;/ol&gt;
&lt;/div&gt;</description>
    </item>
    
  </channel>
</rss>
