分散して運用する¶
複数の arkhe を並べて、1 つの体系を分担する構成。分けてよいのは名前空間であって、 1 つの名前空間の権威ではない。 同じ名前を 2 か所が採番できる形にした時点で、この基盤が 守っている唯一の約束——一度配った名前が別のものを指さない——が壊れる。
公開できないデータに識別子を付ける構成も、ここに含まれる。 閉じた環境に置いた arkhe と、 外から見える上位の arkhe をどう組むか——クローズド PID とオープン PID は、その 実装のかたちを台帳とコマンドの形で書いてある。
arkhe は台帳をまたいだ調整をしない。合意も、レプリケーションによる多重書き込みも 持たない。分散は「排他的に切り分けた名前空間」だけで作る。 これは実装の手抜きでは なく、分散合意で採番の一意性を守る設計よりも、切り分けのほうが壊れ方が浅いからである ——切り分けは設定の誤りが見えるが、合意の失敗は静かに二重採番になる。
四つの形¶
先に全体を見ておく。 詳しくは下で 1 つずつ扱う。
flowchart LR
subgraph P0["分けない"]
z1["arkhe"] --> z2[("台帳")]
end
subgraph PA["A. NAAN 単位"]
a1["arkhe<br/><small>99999</small>"] <--> a2["arkhe<br/><small>12345</small>"]
end
subgraph PB["B. shoulder 単位"]
b1["上位<br/><small>99999</small>"] --> b2["下位<br/><small>/s7</small>"]
b1 --> b3["下位<br/><small>/s8</small>"]
end
subgraph PC["C. 閉域"]
c1["上位<br/><small>割当だけ</small>"] -.-> c2["閉じた arkhe<br/><small>外から届かない</small>"]
end
縦に並ぶ(B・C)か、横に並ぶ(A)か。 縦は NAAN を 1 つに保てるが上位が単一障害点になり、 横は互いに独立だが識別子の見た目が拠点で変わる。C は縦のうち、下位に届かない場合である。
分ける理由から決める¶
| 分けたい理由 | 取る構成 |
|---|---|
| 解決の読み負荷が重い | 分けない。 resolver を増やして読み取りレプリカに向ける |
| 障害を分けたい/運用主体が別 | A. NAAN 単位。台帳が完全に独立する |
| 識別子の見た目を揃えたい/NAAN を増やせない | B. shoulder 単位 |
| ネットワークが閉じている(機微なデータ) | C. 閉域の arkhe を下に置く |
| 相手と関係を持たない | D. 何も繋がない。未知 NAAN は n2t に任せる |
flowchart TD
Q1{"分けたいのは<br/>読み負荷だけか"} -->|はい| N["分けない<br/><small>resolver を増やす</small>"]
Q1 -->|いいえ| Q2{"下位に外から<br/>届くか"}
Q2 -->|届かない| C["C. 閉域の arkhe"]
Q2 -->|届く| Q3{"NAAN を<br/>増やせるか"}
Q3 -->|増やせない| B["B. shoulder 単位"]
Q3 -->|増やせる| Q4{"相手の場所を<br/>台帳で持つか"}
Q4 -->|持つ| A["A. NAAN 単位"]
Q4 -->|持たない| D["D. 繋がない<br/><small>n2t に任せる</small>"]
最初に確かめるのは「分けないで済むか」である。 台帳が 1 つなら、一覧も監査も
?info も 1 か所で答えられる。分けた瞬間に、それらは分かれたまま戻らない。
flowchart LR
U[誰でも] --> R1["resolver ×n<br/><small>ARKHE_RESOLVER=1</small>"]
O[組織] --> M1["minter<br/><small>ARKHE_RESOLVER=0</small>"]
M1 --> DB[(台帳)]
R1 --> RO[(レプリカ)]
DB -.-> RO
読み負荷はデプロイの範囲で片づく。以下は運用の主体を分けたいときの話。
A. NAAN 単位で分ける¶
拠点ごとに NAAN を持ち、それぞれが自分の NAAN に権威を持つ。互いは
is_authoritative=false の NAAN として登録し合う。
flowchart TD
U[誰でも] --> A["arkhe A<br/><small>99999 に権威</small>"]
U --> B["arkhe B<br/><small>12345 に権威</small>"]
A -->|"ark:12345/… を 302"| B
B -->|"ark:99999/… を 302"| A
A -.->|"未知 NAAN"| N[n2t.net]
# A 側。B の NAAN を「権威は持たないが行き先は知っている」として登録する
arkhe naan add 12345 "拠点 B" --no-authoritative --redirect https://ark.b.example.ac.jp
利点。 台帳も権限も障害も完全に分かれる。相手が落ちても自分の NAAN は答え続ける (相手の NAAN は 302 の先が死ぬだけで、こちらの解決は成立している)。
代償。
- NAAN の取得が要る。 これは arkhe の外の手続きで、はじめて立ち上げるときにある。
- 識別子の見た目が拠点で変わる。 そして承継は NAAN を跨げない ——組織が拠点 A から B へ移っても、既存の ARK は A の NAAN のまま A が解決し続ける。 拠点をまたぐ組織の移動は、承継ではなく離脱と受け入れになる。
- 相手の登録は手で保つ。 相手のリゾルバの URL が変わったら、こちらの台帳を直す人が要る。 登録しない選択(D)もあり、そのときは n2t が引き受ける。
B. shoulder 単位で分ける(NAAN は 1 つ)¶
NAAN は上位が 1 つ保有し、shoulder を切り出して下位の arkhe に渡す。 委譲の構造を 組織ではなく別の arkheに対して行う、というだけのことである (委譲の構造)。
flowchart TD
U[誰でも] --> T["上位 arkhe<br/><small>99999 に権威</small>"]
T -->|"/s7… を 302(shoulder.redirect)"| S1["下位 arkhe B<br/><small>99999/s7 を採番</small>"]
T -->|"/s8… を 302"| S2["下位 arkhe C<br/><small>99999/s8 を採番</small>"]
O[拠点 B の組織] -->|採番| S1
O -.->|"上位に投げた場合<br/>307 で行き先を返す"| T
上位の台帳:
arkhe shoulder add 99999 /s7 --note "拠点 B へ委譲"
# → 99999/s7 を切り出しました(id 3) ← 次の 2 行が取る id
arkhe shoulder status <id> delegated --minter https://ark.b.example.ac.jp
arkhe shoulder redirect <id> '303 https://ark.b.example.ac.jp/ark:$id'
shoulder add も onboard も、作った id を表示する。arkhe shoulder list でも引ける
——shoulder のコマンドが取るのは id であって /s7 という文字列ではない。同じ文字列は
複数の NAAN の下に在りうるからである。
下位の台帳:
採番と解決は、別のホップの数になる。
sequenceDiagram
participant O as 拠点 B の組織
participant T as 上位 arkhe
participant S as 下位 arkhe B
O->>T: POST /api/mint (shoulder=/s7)
T-->>O: 307 + 行き先(minter)
Note over T: 代理では呼ばない
O->>S: POST /api/mint
S-->>O: 201 ark:99999/s7gbpqxm3kx
Note over S: 名前を作るのは下位の台帳だけ
sequenceDiagram
participant U as 外の利用者
participant T as 上位 arkhe
participant S as 下位 arkhe B
U->>T: GET /ark:99999/s7gbpqxm3kx
T-->>U: 302 https://ark.b…/ark:…
U->>S: GET /ark:99999/s7gbpqxm3kx
S-->>U: 302 対象の URL
Note over T,S: 上位が落ちると、下位が生きていても外から届かない
採番はプロキシしない。 上位に来た採番要求は 307 と行き先だけを返す
(ShoulderDelegated)。代理で呼ぶと、応答が失われたときにどちらの台帳にも
持ち主のいない ARK が残りうる。NR を宣言する体系でそれは取り返しがつかない。
上位を通る解決が、どこで落ちるか¶
上位のリゾルバはこの順で判断する。順序が結論を決めるので、 委譲を組む前に見ておく価値がある。
flowchart TD
R["ark:99999/s7gbpqxm3kx が<br/>上位に届く"] --> E{"上位の台帳に<br/>完全一致"}
E -->|ある| A1["上位が答える<br/><small>② 委譲前に採った名前</small>"]
E -->|ない| P{"祖先が<br/>ある"}
P -->|ある| A2["祖先から記述・転送"]
P -->|ない| CD{"検査桁が<br/>合う"}
CD -->|合わない| F1["404<br/><small>① 委譲先が検査桁を<br/>作らないとここ</small>"]
CD -->|合う| SR{"shoulder に<br/>redirect"}
SR -->|ある| G["302 で下位へ<br/><small>③ ホップが 1 つ増える</small>"]
SR -->|ない| F2["404<br/><small>自 NAAN の未知名</small>"]
- 完全一致 — 上位の台帳にその名前があれば、上位が答える
- 祖先 passthrough
is_authoritativeなら検査桁の検証。合わなければ404- shoulder の
redirectがあれば302で下位へ - 無ければ
404(自 NAAN の未知名は「無い」と言える)
ここから 3 つ出てくる。
① 委譲先も検査桁を作らなければならない。 3 が 4 より先にあるので、下位が
NOID+検査桁でない名前を採ると、上位経由の解決だけが 404 になる(下位に直接来た
要求は通る——いちばん見つけにくい壊れ方である)。arkhe 同士なら採番規則が同じなので
自動的に満たす。他実装に委譲するときだけ問題になり、そのときの選択肢は
「相手に検査桁を作らせる」か「上位の NAAN の is_authoritative を落とす」の 2 つ。
後者は NAAN 全体の属性なので、その NAAN について「無い」と言う力を全部失う
——shoulder ごとには落とせない。
② 途中から委譲すると、名前が 2 か所に分かれる。 1 が 4 より先なので、委譲前に 上位で採った名前は上位が答え、それ以降の名前は下位へ流れる。解決は正しく続くが、 一覧と監査はその日を境に割れる。分けるのは未来の名前だけで、既に配った名前は 移せない。
③ ホップは増える。 上位が落ちれば、下位が生きていても外からは解決できない。 深さは 2 までにする。A→B→A のような循環はループになり、arkhe は検知しない。
委譲先が落ちたとき¶
委譲は行き先を書いておく仕組みなので、その行き先が落ちても上位は気づかないし、 落ちた先へ 302 を出し続ける。利用者から見れば壊れた識別子である。
そのときは転送だけを止める。
arkhe hold add shoulder <id> --days 1 --reason "委譲先のリゾルバが落ちている"
arkhe hold release shoulder <id> # 直ったら外す(期限が来れば自動でも戻る)
保留中、上位は 302 を出さず 200 と理由を返す。識別子は生きている——
?info も ?? も答え続けるので、永続性の宣言を引っ込めることにはならない。
期限は必須で、切れれば時計だけで元に戻る(壊さないもの)。
止めている名前空間は /.well-known/ark の held に出る(JSON 表現。Accept:
application/json を付けて求める)。下位から見て、上位が
止めたことを機械的に確かめられる——連絡が付かないときに効く。
何が上位に残り、何が下位に移るか¶
NAAN・na_policy(?? の答え) |
上位。 永続性の宣言は NAAN の保有者の約束である |
| 名前空間の割当(どの shoulder を誰に) | 上位。 排他はここでしか作れない |
| 個々の ARK・行き先・記述 | 下位。 上位は知らない |
| 主体と資格情報 | 各台帳。 到達範囲は登録の属性なので共有されない |
| 監査 | 各台帳。 全体を辿るには集める |
主体が共有されないのは意図的である。到達範囲を台帳の外から持ち込めるようにすると、 「リクエストで広がらない」が成立しなくなる。共通の認可サーバを 置けば身元は共有できるが、届く範囲は各台帳への登録で決まる。
C. 閉域の arkhe を下に置く¶
下位の arkhe が閉じた環境にあり、外から届かない構成。上位が把握するのは名前空間の 割当と、外に見せてよい行き先だけで、中の名前も対象も知らない。
flowchart TD
P[外の利用者] --> T["上位 arkhe<br/><small>99999 に権威</small>"]
T -->|"303 → 公開の説明ページ"| X["「この名前空間は閉じている」"]
subgraph 閉域
I[中の利用者] --> C["arkhe(minter+resolver)"]
C --> D[(閉じた台帳)]
end
T -.->|"名前空間の割当だけ<br/>(人が設定する)"| C
閉域では、行き先そのものが機密になりうる。 ここが他のパターンと違う。
- 上位の
redirectに内部 URL を書かない。302で内部ホスト名を返すと、 到達できない相手にもホスト名は届く。303 https://…/closed-namespaceのように 公開の説明ページへ向ける(shoulder.redirectは先頭にステータスコードを書ける)。 minterは空にする。/.well-known/arkも、採番要求に返す307も、 「ここを叩けば採番できる」と機械可読で言う契約である。そこに閉域の minter URL を 書けば構成が漏れるうえ外の誰にも使えず、人向けの説明ページを書けば契約が嘘になる ——クライアントはそこへPOSTしにいく。委譲に行き先は要らない。委譲とは 「この台帳では採番しない」と刻むことで、採番要求には403 ARKHE-1309が返る。 指し示す価値のあるページがあるならaboutに置く——本文に載り、Locationには 決して入らない。- 上位からの
307委譲は成立しない。 外の利用者が閉域の minter に到達できないため。 閉域の利用者は閉域の arkhe を直接叩く。上位の shoulder をdelegatedにする意味は、 上位でその名前空間が採番されないことを台帳と制約で保証する点にある。
上位が「その識別子は存在する」と言えるか¶
言えるのは、上位で採番した場合だけである。arkhe には外で採番された名前を取り込む
口が無い——/api/mint は名前を生成し(呼び出し側は名前を選べない)、/api/register は
既存 base の修飾子を足すためのものだから。したがって選択肢は 2 つ。
C-1. 上位で先に採り、閉域に払い出す。 上位で ark:mint して url を空のままにする。
上位は名前と記述を持ち、行き先は持たない——リゾルバは転送ではなく記述を返す(D6)。
対象に到達できなくても記述は答えられるという形は、tombstone や FAIR A2 と同じで、
制限公開そのものを表現できる。閉域側は台帳を持たず、払い出された名前と中の対象の
対応だけを持つ。
- 外に出る情報は、運用者が明示的に選んで上位に入れた記述だけになる。
- 閉域から上位への自動同期を作らないこと。作れば、いつか機微な行き先が上位の
?infoに出る。出ない仕組みではなく、出す道が無い状態を保つほうが強い。
C-2. 上位は名前を知らない。 shoulder ごと委譲し、外からは「その名前空間は閉じている」 以上のことは分からない。上位が持つのは割当の事実だけで、いちばん漏れない。 代わりに、実在する名前と一度も採られていない名前が同じ答えになる——上位はそれを 区別できないので、どれかが存在するとは言えない。
ただし打ち間違いは捕まる。検査桁は shoulder を見る前に検証されるので、綴りの
壊れた文字列は説明ページではなく 404 ARKHE-1403 になる。well-formed な名前どうしは
見分けがつかず、壊れた名前には壊れていると言う、ということである。
外から同じ識別子を引いたとき、返るものが違う。
flowchart LR
U["外の利用者<br/>ark:99999/s7gbpqxm3kx"] --> C1["C-1<br/><small>上位が名前と記述を持つ</small><br/>200 記述を返す"]
U --> C2["C-2<br/><small>上位は名前を知らない</small><br/>303 説明ページ"]
C1 --> R1["存在は言える<br/>行き先は無い<br/><small>=制限公開そのもの</small>"]
C2 --> R2["存在が漏れない<br/><small>実在も未採番も同じ答え。<br/>誤記は 404</small>"]
境界を越えるものも違う。C-1 で上へ渡るのは、運用者が手で入れた記述だけである。
flowchart TB
subgraph OUT["公開側"]
T["上位 arkhe"]
end
subgraph IN["閉域"]
S["arkhe/対応表"]
D[("対象そのもの")]
S --- D
end
T -->|"① 名前空間の割当(人が設定する)"| S
S -->|"② 記述だけ(C-1。人が選んで上位に入れる)"| T
D -.->|"越えない"| T
機微さが「対象」にあるなら C-1、「名前が存在すること」にもあるなら C-2。 迷ったら C-2 から始める——後から C-1 に寄せることはできるが、一度外に出した記述は 取り消せない。
クローズド PID とオープン PID¶
同じ NAAN の中に、公開の識別子と閉じた識別子を並べて置く。 分けるのは shoulder であって、
識別子の形は分けない——ark:99999/… のままにしておくことが、この構成の目的そのものである。
なぜ形を分けないのか¶
機微なデータは、いつか公開になる。禁止期間が明け、匿名化が済み、論文が出る。そのときに 識別子が変わる設計だと、閉じていた間に配った参照が全部死ぬ——申請書にも、審査の記録にも、 共同研究者との連絡にも、その識別子は既に書かれている。
形が同じなら、公開は行き先の付け替え 1 回で済む。ARK が「永続性は文字列の性質ではなく サービスの問題」と言っているのは、まさにこの操作ができることを指している。
flowchart TD
N["NAAN 99999<br/><small>na_policy(?? の答え)はここ</small>"]
N --> SO["shoulder /s7<br/><small>オープン PID</small>"]
N --> SC["shoulder /c7<br/><small>クローズド PID</small>"]
SO --> AO["ark:99999/s7gbpqxm3kx<br/><small>url = 公開の対象</small>"]
SC --> AC["ark:99999/c76m0jmznv4<br/><small>url = 空/申請窓口</small>"]
AC -->|"公開になったら url だけ付け替える"| AC2["ark:99999/c76m0jmznv4<br/><small>url = 公開の対象</small>"]
右下の 2 つは同じ識別子である。 行も、名前も、shoulder も変わっていない。変わったのは
行き先だけで、それは ArkChange に before/after が残る——NR を宣言したまま公開に移せる
のは、変えたのが名前ではないからである。
外から何が見えるか(3 段)¶
| 段 | 公開側の台帳が持つもの | 外から ark:… を引くと |
使いどころ |
|---|---|---|---|
| 見せない | 名前を持たない(C-2) | 303 説明ページ |
存在すること自体が機微 |
| 記述だけ | 名前と記述、url は空 |
200 記述を返す(D6) |
目録は公開、実体は非公開 |
| 窓口つき | 名前と記述、url = 申請ページ |
302 申請ページ |
申請すれば使える |
現場でいちばん多いのは 3 段目である。DOI で「データは申請制」と書かれた着地先と同じ形で、
arkhe では url を申請フォームに向けるだけで作れる——新しい機能を要さない。
2 段目(url が空)が成立するのは、リゾルバが転送先の無い ARK に対して記述を返す(D6)
から。これは tombstone と同じ経路で、「対象に到達できなくても記述は参照できる」という
FAIR A2 の形そのものである。制限公開は、この基盤にとって例外ではなく既定の一部にあたる。
段は上げられるが、下げても戻らない¶
stateDiagram-v2
state "閉じている" as closed
state "窓口つき" as door
state "公開" as open
state "tombstone" as dead
[*] --> closed: 採番(url は空)
closed --> door: url = 申請ページ
closed --> open: url = 対象
door --> open: url = 対象
open --> dead: 対象が失われた
note right of open
名前は一度も変わらない。
変わるのは url だけ。
end note
url を戻せば到達性は落とせるが、一度公開した記述と行き先は取り消せない。だから
閉じている側から始める——記述は後から足せるが、消せない。
公開前の ARK と、閉域のリゾルバ¶
上の 3 段は行き先の話で、名前そのものは最初から解決した。これとは別に、 採番はしたが、まだグローバルに出していないという状態がある (公開前)。下書きの登録に先に番号を 振っておき、公開をやめたら取り下げる——そのための状態で、公開前のあいだだけ削除できる。
解決するかどうかは、ARK の状態だけでは決まらない。 どのリゾルバが答えているかで決まる。
| 公開前の ARK | 公開した ARK | |
|---|---|---|
閉域のリゾルバ(ARKHE_RESOLVE_UNPUBLISHED=1) |
解決する | 解決する |
| 公開のリゾルバ(既定) | 404(未登録の名前と同じ) |
解決する |
閉じた網の中で採番した ARK を、その網のリゾルバが解決できないなら配る意味が無い
——形を分けないという、この構成の目的そのものが成り立たなくなる。
一方で ?info と ?? は認証を要さない公開の口なので、公開の面でこれを開けると、
まだ公開していない対象の存在・題名・行き先がそのまま出る。同じ 1 つの判断を、
置き場所で分ける。
# 閉域のリゾルバ(届く範囲そのものが閉じていること)
ARKHE_RESOLVER=1 ARKHE_RESOLVE_UNPUBLISHED=1 uvicorn arkhe.app:create_app --factory
公開に移すときは POST /api/publish。名前は動かない——変わるのは「外に出したか」
だけで、行き先の付け替えと同じく識別子そのものは一度も変わらない。公開した
あとは、消すなら先に公開を取り下げる(または purge で一手に)。
閉域で解決していた ARK を取り下げると、その網の中では引けなくなる。 それでも
その名前が別のものを指すことは絶対にない——取り下げた名前は二度と採られないので、
残っている参照は 404 になるだけである。NR が守るのはそこで、取り下げてよいかは
「閉域の中で誰に配ったか」を知っている運用側が決める。
実装イメージ¶
A. 公開側で採番し、名前を閉域に払い出す(C-1)。閉域から外向きの通信が要らず、 公開側が「その識別子は存在する」と言える。
# 台帳を組む(公開側の arkhe)
arkhe naan add 99999 "あなたの組織" --policy "NP | NR, OP, CC | 2026 | https://…/policy"
arkhe onboard 99999 "例示大学" --shoulder /s7 # オープン PID
arkhe shoulder add 99999 /c7 --manager 1 --note "クローズド PID(閉域の対象)"
# 採番する。url を入れない——リゾルバは転送ではなく記述を返す
curl -X POST https://ark.example.ac.jp/api/mint \
-H 'Authorization: Bearer …' -H 'Content-Type: application/json' \
-d '{"shoulder": "/c7",
"what_title": "(外に出してよい範囲の題)",
"commitment": "制限公開。利用には申請が要る",
"url": ""}'
# → ark:99999/c76m0jmznv4
# 申請窓口を付ける(3 段目に上げる)
curl -X PUT …/api/update -d '{"ark": "ark:99999/c76m0jmznv4",
"url": "https://apply.example.ac.jp/dataset/…"}'
# 禁止期間が明けたら、実体へ向け替える。**識別子は変わらない**
curl -X PUT …/api/update -d '{"ark": "ark:99999/c76m0jmznv4",
"url": "https://repo.example.ac.jp/records/123"}'
閉域側は台帳を持たず、払い出された名前と中の対象の対応だけを持つ。
B. 閉域で採番する(C-2)。閉域に arkhe を建て、公開側は /c7 を delegated に
する。閉域は自律し、名前を渡すまで公開側は何も知らない——そして渡せるようになった。
POST /api/import が、外で採番された ARK を公開台帳に引き取る(1 本ずつでも、委譲した
shoulder ごとまとめてでも)。C-2 から C-1 へ、識別子を変えずに移れるということで、
閉じている間に配った名前が公開後もそのまま効く。
# 公開側: この名前空間では自分は採番しない、と台帳に刻む
arkhe shoulder status <id> delegated --about https://ark.example.ac.jp/closed-namespace
# (--minter ではなく --about。閉域の minter は外の誰にも叩けない)
arkhe shoulder redirect <id> '303 https://ark.example.ac.jp/closed-namespace'
# (内部ホスト名を書かない。/.well-known/ark に載る)
# 閉域側: 同じ NAAN・同じ shoulder を、権威を持つ側として持つ
arkhe naan add 99999 "(上位と同じ NAAN)"
arkhe onboard 99999 "閉域の組織" --shoulder /c7
名前を引き取る¶
# 1 本ずつ
curl -X POST …/api/import -H "Authorization: Bearer $KEY" \
-d '{"ark": "ark:99999/c7962c644f8", "title": "(閉域から出してよいものだけ)"}'
# 委譲した shoulder ごとまとめて——**全部入るか、1 件も入らないか**
curl -X POST …/api/import/bulk -H "Authorization: Bearer $KEY" \
-d '{"data": [{"ark": "ark:99999/c7962c644f8"}, {"ark": "ark:99999/c7bk6pmvhq7"}]}'
取り込みは採番ではなく、scope も別(ark:import)。採番は「番号をもらう」操作、
取り込みは「この番号だと言い張る」操作である。検査は 3 つ、どれも緩めない——shoulder が
委譲されていること、名前がその内側にあること、検査桁が合うこと。外から来た名前を
信じる手立ては最後の 1 つしかない。さらに、その NAAN の権威をこの台帳が持っている
ことも要る。取り次いでいるだけの名前空間の名前を引き受けるのは、その保管者を名乗ること
だからである。
到達範囲はほかと同じ規則で、上位の権威が下位を覆う。システム管理者はどこへでも、 NAAN 管理者はその NAAN の下ならどこへでも、組織は自分の shoulder にだけ取り込める。
取り込んだあとの公開は、C-1 と同じ「行き先を 1 回書き換えるだけ」。名前は動かない。
arkhe がやらないこと¶
アクセス制御はしない。 クローズド PID が「閉じている」のは行き先が閉じているからで あって、arkhe が誰かを拒んでいるからではない。判定は対象側(リポジトリ)の仕事である。 ここに持ち込むと識別子基盤が認可基盤になり、識別子は誰でも解決できるべきという前提と 正面から衝突する——解決に認証を要さない設計は、そのために選んである。
記述に何を書くかは運用が決める。 ?info は認証を要さない公開の口なので、ERC の
who / what / when をそのまま入れると、題名から中身が推測できることがある。
閉じた対象ほど、記述は短くする。
??(永続性宣言)は NAAN 単位である。 クローズドとオープンで別の約束を掲げることは
できない。組織ごとの水準は arkhe manager commitment で言い分けられるが、それは NAAN の
宣言を狭める方向にしか働かない。
D. 何も繋がない¶
他所の NAAN を登録しない。未知の NAAN は ARKHE_GLOBAL_RESOLVER(既定 https://n2t.net)へ
302 で取り次ぐ。相手との関係を持たずに済むのが利点で、相手のリゾルバが移っても
こちらに作業が発生しない。
代わりに、未知 NAAN の ?info は答えられない(404 を返す)。持っていない台帳の
記述を作り出すわけにはいかないため。
分散しても壊してはならないもの¶
これは方針ではなく、分けた数だけ人が守ることになる規則である。台帳が 1 つなら コードが守っていたものが、分けた瞬間に運用の側に移る。
flowchart TD
X["arkhe X<br/><small>99999/s7 を採番</small>"] --> N["ark:99999/s7gbpqxm3kx"]
Y["arkhe Y<br/><small>99999/s7 も採番</small>"] --> N
N --> Z["✗ 同じ名前が 2 つの対象を指す<br/><small>NR の下では取り返しがつかない</small>"]
これを防ぐ仕掛けは、分けた先には無い。 1 つの台帳なら「採番が更新に化けない」は コードが守っていたが、台帳が 2 つになると、同じ shoulder を渡さないという運用だけが 残る。
| 1 つの shoulder を採番する台帳は 1 つだけ | 二重採番は同じ名前が別のものを指す最短経路。上位は委譲した shoulder を delegated にして、自分では採らない |
| 1 つの NAAN に権威を持つ台帳は 1 つだけ | 「無い」と言えるのは 1 か所。2 か所が is_authoritative だと、片方が 404 と言い、もう片方が答える |
| 委譲は取り消せない | retired に落とせても、下位が既に作った名前は消えない。解除が意味するのは新規採番の停止だけ |
| 下位の台帳も上位の責任範囲 | 下位が失われれば、その名前は上位からも解決できない。バックアップは拠点ごとに要り、全体の可用性は最弱の拠点で決まる |
| 循環を作らない | ループは検知しない。深さ 2 まで |
| 監査は集めないと辿れない | 各台帳は自分の操作しか記録しない |
いま無いもの¶
この構成を組むときに、無いと分かっていたほうがよいもの。 隠して驚かせるより、 先に書く。
- 台帳をまたぐ一覧・監査・quota。
/.well-known/arkが公開するのは名前空間の割当までで、 個々の ARK は含まない。 - 委譲先の健全性の監視。 上位は下位が生きているかを知らない。委譲した shoulder の redirect 先を外形監視するのは運用の仕事になる。
組む前のチェックリスト¶
- [ ] 分けない構成で足りないことを確かめた(読み負荷ならレプリカで済む)
- [ ] 分けた単位が排他である(同じ shoulder を 2 か所が採らない)
- [ ]
is_authoritativeを立てている台帳が、その NAAN について1 つだけ - [ ] 委譲先が検査桁つきの名前を作る(arkhe 同士なら自動的に満たす)
- [ ] 上位から下位への
redirectが深さ 2 以内で、循環していない - [ ]
/.well-known/arkに出したくない URL が載っていない(閉域なら特に) - [ ] 各拠点でバックアップと復元を試した——失った台帳は誰にも作り直せない
- [ ] 監査を集める手立てを決めた(少なくとも、どこに何が残るかを書いた)