From 732cb26eb5c98cfabfe2122f88ce6d3db265cc36 Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Sun, 8 Nov 2026 15:07:06 +0900 Subject: [PATCH] =?UTF-8?q?fix(release):=20SIGNING=5FKEY=EC=97=90=20?= =?UTF-8?q?=EC=A7=80=EB=AC=B8=EC=9D=B4=20=EB=93=A4=EC=96=B4=EA=B0=84=20?= =?UTF-8?q?=EA=B2=BD=EC=9A=B0=EB=A5=BC=20=EC=9D=B4=EB=A6=84=20=EB=8C=80?= =?UTF-8?q?=EA=B3=A0=20=EB=84=A3=EB=8A=94=20=EB=B2=95=EC=9D=84=20=EC=A0=81?= =?UTF-8?q?=EB=8A=94=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit signing-check(run 10)로 v1.0.0 서명 실패의 원인을 찾았다. SIGNING_KEY secret은 40글자 한 줄이었고 BEGIN·END 줄이 없었다. base64로 읽으면 30바이트, 첫 패킷 tag 55(0x37)였다. 16진수 40글자 지문 `92…`를 base64로 읽으면 첫 바이트가 0xF7, 곧 tag 0x37이다. 비밀 키 대신 키 지문이 들어갔다. - check-signing-key.sh: 값이 16진수 8·16·40글자(키 ID·지문)면 그렇다고 말한다. 릴리스 키 지문과 같으면 그것도 말한다(공개 정보만 비교한다). - release.md 1절: SIGNING_KEY에 넣을 것(export 파일 전체, 줄바꿈 그대로), 넣는 곳, signing-check로 확인하는 법. 3절: 비밀 값을 바꾼 뒤 첫 태그 전에 signing-check. 5절: 서명 실패 행. 아무것도 게시되지 않았으면 태그를 고친 커밋으로 옮겨 같은 버전을 쓴다는 규칙(총괄 결정과 같게). 검증: 지문 40글자를 넣은 경우 rc=1과 「key ID or fingerprint (the release key's fingerprint)」. 앞 커밋의 시험 다섯은 그대로 통과한다. --- docs/work/release.md | 16 ++++++++++++++-- scripts/release/check-signing-key.sh | 10 +++++++++- 2 files changed, 23 insertions(+), 3 deletions(-) diff --git a/docs/work/release.md b/docs/work/release.md index 1f25dd0..ab041cc 100644 --- a/docs/work/release.md +++ b/docs/work/release.md @@ -27,6 +27,17 @@ main 병합 ──> 소유자가 태그 vX.Y.Z push ──> .gitea/workflows/rel - 서명 키: RSA 4096, 지문 `92646CEAFE816CF8B9C249F0A1C936D7F791F8AB`, 2028-11-07 만료. 공개 키는 README 「서명」이다. - 첫 태그는 `v1.0.0`이다(3절). +**`SIGNING_KEY`에 넣는 것**은 키 지문이나 키 ID(16진수 40·16·8글자)가 아니라 비밀 키 파일 전체다. + +```bash +gpg --armor --export-secret-keys 92646CEAFE816CF8B9C249F0A1C936D7F791F8AB > signing-key.asc +``` + +1. `signing-key.asc`를 열어 첫 줄 `-----BEGIN PGP PRIVATE KEY BLOCK-----`부터 끝 줄 `-----END PGP PRIVATE KEY BLOCK-----`까지 줄바꿈 그대로 복사한다. RSA 4096 키면 100줄 남짓이다. +2. Gitea → 그 repo(grpc-library, messaging-library 둘 다) → 설정 → Actions → Secrets → `SIGNING_KEY`를 고쳐 붙여 넣는다. +3. Actions → `signing-check` → Run workflow(main). 로그에 `PROBLEM` 줄이 없고 `gpg import: ok, secret key fingerprint 92646CEA…F791F8AB`, `signing with SIGNING_PASSWORD: ok`가 나오면 된다. 이 workflow는 값을 출력하지 않는다(`scripts/release/check-signing-key.sh`). +4. `signing-key.asc`를 지운다(`shred -u signing-key.asc`). + ## 2. 버전 규칙 - SemVer, repo 하나에 버전 하나. 모든 모듈이 같은 버전으로 나간다. 태그는 `vMAJOR.MINOR.PATCH`이고 접미사(`-rc.1` 등)는 없다. 다른 모양의 태그는 `ca.java-conventions`가 빌드 전에 거부한다. @@ -39,7 +50,7 @@ main 병합 ──> 소유자가 태그 vX.Y.Z push ──> .gitea/workflows/rel 1. main이 초록인지 본다(main.yml 마지막 실행). 2. `CHANGELOG.md`에 그 버전 절을 쓰고 PR로 병합한다. -3. 올리기 전까지를 desktop에서 미리 돌려 본다(비밀 값 없이, 4절). +3. 올리기 전까지를 desktop에서 미리 돌려 본다(비밀 값 없이, 4절). 비밀 값을 넣거나 바꾼 뒤 첫 태그라면 `signing-check` workflow도 한 번 돌린다(1절). 4. 태그를 단다. ```bash @@ -65,7 +76,8 @@ scripts/verify.sh release --on desktop | 어디서 | 뜻 | 할 일 | | --- | --- | --- | -| 1~4단계 | 아무것도 올라가지 않았다 | 고쳐서 main에 병합하고 같은 태그 이름을 새 커밋에 다시 달지 않는다. 다음 PATCH 태그를 쓴다 | +| 1~4단계, 서명 | 아무것도 올라가지 않았다 | 고쳐서 main에 병합한다. 그 버전의 파일이 Packages에 하나도 없으면(`maven-metadata.xml`에 없음) 태그를 지우고 고친 main 커밋에 같은 태그를 다시 단다. 하나라도 올라갔으면 다음 PATCH를 쓴다 | +| 서명 직전 `verifySigningKey`, 또는 `Could not read PGP secret key` | 서명 비밀 값이 키로 읽히지 않는다 | `signing-check` workflow의 `PROBLEM` 줄이 원인이다(지문을 넣음, 줄바꿈 잃음, BEGIN·END 줄 빠짐, base64 손상, 다른 키, 틀린 암호). 1절대로 다시 넣는다 | | 5단계 중간 | 일부 모듈만 올라갔을 수 있다 | 그 버전은 버린다(지우지 않는다). 원인을 고치고 다음 PATCH를 낸다. `CHANGELOG.md`에 버린 버전을 적는다 | | 6단계 | 올라갔지만 익명으로 안 읽힌다 | owner 공개 설정을 확인한다. 템플릿 이미지 빌드가 토큰 없이 읽는다는 전제(설계 8.3절 R1)가 깨진 것이다 | diff --git a/scripts/release/check-signing-key.sh b/scripts/release/check-signing-key.sh index 03988d7..6fef35d 100755 --- a/scripts/release/check-signing-key.sh +++ b/scripts/release/check-signing-key.sh @@ -24,7 +24,7 @@ if [ -z "${SIGNING_KEY:-}" ]; then fi [ -n "${SIGNING_PASSWORD:-}" ] || echo "check-signing-key: SIGNING_PASSWORD is empty (only right for a key without a passphrase)" -python3 - <<'PY' || fail=1 +EXPECTED_FINGERPRINT=$expected python3 - <<'PY' || fail=1 import base64, os, re, sys key = os.environ["SIGNING_KEY"] @@ -39,6 +39,14 @@ print(f"shape: {len(key)} characters, {key.count(chr(10)) + 1} lines," f" leading whitespace {'yes' if key[:1].isspace() else 'no'}," f" trailing whitespace {'yes' if key[-1:].isspace() else 'no'}") +stripped = key.strip() +if re.fullmatch(r"(0x)?[0-9A-Fa-f]{8}|(0x)?[0-9A-Fa-f]{16}|[0-9A-Fa-f]{40}", stripped): + expected = os.environ.get("EXPECTED_FINGERPRINT", "") + same = " (the release key's fingerprint)" if expected and stripped.upper() == expected.upper() else "" + print(f"PROBLEM: SIGNING_KEY holds a {len(stripped)}-hex-digit key ID or fingerprint{same}, not the key." + " Put in the output of `gpg --armor --export-secret-keys ` instead, BEGIN to END lines.") + sys.exit(1) + lines = key.replace("\r\n", "\n").replace("\r", "\n").split("\n") while lines and lines[-1].strip() == "": lines.pop()