bluelamp 6.6.32 → 6.6.33
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md
CHANGED
|
@@ -18,14 +18,14 @@ bluelamp42 # slot #42
|
|
|
18
18
|
|
|
19
19
|
## 配布物が難読化されていることについて
|
|
20
20
|
|
|
21
|
-
npm で配布している `bluelamp` の `dist/`
|
|
21
|
+
npm で配布している `bluelamp` の `dist/` は、**意図的に難読化してあります**。中身がそのまま読めないのはビルドの設計であって、隠しごとではありません。以下にその理由を記します。
|
|
22
22
|
|
|
23
23
|
### なぜ難読化しているのか
|
|
24
24
|
|
|
25
25
|
- **認証とトークンの取り扱いを守るため。** この CLI は利用者の資格情報とアクセストークンを端末上で扱います。その取り回しを読める形のまま配ると、なりすましやトークンの窃取を試みる側に手順を渡すことになります。
|
|
26
26
|
- **当社の知的資産を守るため。** BlueLamp の価値は積み上げてきた設計そのものにあり、配布物はその一部を含みます。
|
|
27
27
|
|
|
28
|
-
難読化が掛かるのは配布物 (`dist/`) だけです。**ソースは非公開です。**
|
|
28
|
+
難読化が掛かるのは配布物 (`dist/`) だけです。**ソースは非公開です。** 配布物への署名 (正規ビルドであることを第三者の立場で確かめる仕組み) は準備中です (下の「正規のビルドであることの確かめ方」)。ビルドの段取りそのものは下の「ビルド出力」の節のとおりです。
|
|
29
29
|
|
|
30
30
|
### 利用者にとって何が変わらないのか
|
|
31
31
|
|
|
@@ -36,38 +36,7 @@ npm で配布している `bluelamp` の `dist/` は、**意図的に難読化
|
|
|
36
36
|
|
|
37
37
|
### 正規のビルドであることの確かめ方
|
|
38
38
|
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
🔑 **下の手順 1・2 で参照するのは npm registry と公開 Rekor だけで、当社のサーバーは一切登場しません。** 当社を信用しなくても確かめられる、というのがこの手順の要点です。必要なのは `curl` / `openssl` / `node` だけで、**cosign のインストールは要りません**。
|
|
42
|
-
|
|
43
|
-
**1. registry が配っている tarball を取得し、ハッシュを出す**
|
|
44
|
-
|
|
45
|
-
```bash
|
|
46
|
-
V=<インストールした版> # npm ls -g bluelamp で確認できます
|
|
47
|
-
curl -sSL "https://registry.npmjs.org/bluelamp/-/bluelamp-$V.tgz" -o "bluelamp-$V.tgz"
|
|
48
|
-
shasum -a 256 "bluelamp-$V.tgz"
|
|
49
|
-
```
|
|
50
|
-
|
|
51
|
-
**2. そのハッシュで公開透明性ログ (Rekor) を引く**
|
|
52
|
-
|
|
53
|
-
```bash
|
|
54
|
-
SHA=<手順 1 で出た 64 桁>
|
|
55
|
-
curl -s -X POST -H 'Content-Type: application/json' \
|
|
56
|
-
-d "{\"hash\":\"sha256:$SHA\"}" \
|
|
57
|
-
https://rekor.sigstore.dev/api/v1/index/retrieve
|
|
58
|
-
```
|
|
59
|
-
|
|
60
|
-
エントリが返れば、その tarball が当社の GitHub Actions によって署名され、公開ログに記録されていることを意味します。
|
|
61
|
-
|
|
62
|
-
**3. さらに厳密に確かめる場合** — 証明書チェーンと署名者の固定まで検証するスクリプトをパッケージに同梱しています。グローバルインストールなら次の 1 行で実行できます (依存は上と同じ `curl` / `openssl` / `node` だけです)。
|
|
63
|
-
|
|
64
|
-
```bash
|
|
65
|
-
"$(npm root -g)/bluelamp/verify-release.sh" "$V"
|
|
66
|
-
```
|
|
67
|
-
|
|
68
|
-
⚠️ **信頼の起点は手順 1・2** — ご自身の手で公開ログを引き、目で読む記録 — の側にあります。検証を代行するスクリプトを配布物に同梱しても、それは信頼の起点にはなりません (改ざんされた tarball は、改ざんされた検証器を同梱することもできるためです)。
|
|
69
|
-
|
|
70
|
-
📌 署名が付くのは、この README を同梱した版以降のリリースです。それより前の版では手順 2 でエントリが返りませんが、改ざんを意味するものではありません。
|
|
39
|
+
**準備中です。** 公開している tarball への署名 (公開の透明性ログへの記録) は、まだ行っていません。そのため、現時点ではどの版も透明性ログを引いても記録は返りません。これは改ざんを意味するものではありません。
|
|
71
40
|
|
|
72
41
|
### ウイルス対策ソフトが反応した場合
|
|
73
42
|
|