From f88f180ab6ed7bea7346f21e1c3feb291d7cc8e4 Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Sun, 8 Nov 2026 15:22:32 +0900 Subject: [PATCH] =?UTF-8?q?fix(release):=20SIGNING=5FPASSWORD=EC=97=90=20?= =?UTF-8?q?=ED=82=A4=20=EB=B8=94=EB=A1=9D=EC=9D=B4=20=EB=93=A4=EC=96=B4?= =?UTF-8?q?=EA=B0=84=20=EA=B2=BD=EC=9A=B0=EB=A5=BC=20=EC=9D=B4=EB=A6=84=20?= =?UTF-8?q?=EB=8C=84=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit signing-check(run 15)가 남은 실패의 원인을 보였다. SIGNING_PASSWORD는 3,473글자에 줄바꿈 56개였다. 앞 run에서 base64를 푼 armored 키(3,474글자, 58줄)와 같은 모양이다. Gradle 서명기는 「checksum mismatch at in checksum of 20 bytes」, 곧 틀린 비밀번호로 실패했다. 비밀번호 칸에 키가 들어갔다. 진단이 이 경우를 바로 말한다. 비밀번호에 「-----BEGIN PGP」가 있거나 1,000글자를 넘으면, 그것이 비밀번호가 아니라는 PROBLEM 줄을 낸다(값은 출력하지 않는다). release.md 1절에 SIGNING_PASSWORD는 키를 만들 때 정한 암호 한 줄이라고 적었다. 검증: 로컬 gpg로 armored 키를 비밀번호로 준 경우 PROBLEM 줄과 rc=1(아래 signing-check 실행). --- docs/work/release.md | 4 ++-- scripts/release/check-signing-key.sh | 3 +++ 2 files changed, 5 insertions(+), 2 deletions(-) diff --git a/docs/work/release.md b/docs/work/release.md index 2f33f64..0692ef1 100644 --- a/docs/work/release.md +++ b/docs/work/release.md @@ -21,7 +21,7 @@ main 병합 ──> 소유자가 태그 vX.Y.Z push ──> .gitea/workflows/rel | --- | --- | --- | | `PACKAGE_TOKEN` | Gitea 개인 토큰. 권한은 `package` 읽기·쓰기만(repository·user 권한 없음). Gitea job 토큰(`GITEA_TOKEN`)은 패키지를 올릴 수 없어서 사람 토큰이 필요하다 | Gitea 웹 → 설정 → 애플리케이션에서 새로 만들어 secret을 덮어쓰고 옛 토큰을 지운다 | | `SIGNING_KEY` | 서명용 PGP 비밀 키(ASCII armor 전체). 두 라이브러리(grpc, messaging)가 같은 키를 쓴다 | 새 키 쌍을 만들고 README 「서명」의 공개 키와 지문을 같은 PR에서 바꾼다. 만료(2028-11-07) 전에 한다 | -| `SIGNING_PASSWORD` | 그 키의 암호 | 키와 함께 | +| `SIGNING_PASSWORD` | 그 키를 만들 때 정한 암호 한 줄. 키 파일이나 그 base64가 아니다 | 키와 함께 | - 이름: 설계(design-docs `repo-structure/05-library-repos.md` 7절)는 `PACKAGES_TOKEN`이라고 적었지만, 등록된 이름 `PACKAGE_TOKEN`에 workflow와 빌드를 맞췄다. 소유자에게 다시 등록을 부탁하지 않는다. - 서명 키: RSA 4096, 지문 `92646CEAFE816CF8B9C249F0A1C936D7F791F8AB`, 2028-11-07 만료. 공개 키는 README 「서명」이다. @@ -77,7 +77,7 @@ scripts/verify.sh release --on desktop | 어디서 | 뜻 | 할 일 | | --- | --- | --- | | 1~4단계, 서명 | 아무것도 올라가지 않았다 | 고쳐서 main에 병합한다. 그 버전의 파일이 Packages에 하나도 없으면(`maven-metadata.xml`에 없음) 태그를 지우고 고친 main 커밋에 같은 태그를 다시 단다. 하나라도 올라갔으면 다음 PATCH를 쓴다 | -| 서명 직전 `verifySigningKey`, 또는 `Could not read PGP secret key` | 서명 비밀 값이 키로 읽히지 않는다 | `signing-check` workflow의 `PROBLEM` 줄이 원인이다(지문을 넣음, 줄바꿈 잃음, BEGIN·END 줄 빠짐, base64 손상, 다른 키, 틀린 암호). 1절대로 다시 넣는다 | +| 서명 직전 `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 ea66519..3b79946 100755 --- a/scripts/release/check-signing-key.sh +++ b/scripts/release/check-signing-key.sh @@ -31,6 +31,9 @@ p = os.environ.get("SIGNING_PASSWORD", "") print(f"password shape: {len(p)} characters, line breaks {p.count(chr(10))}, CR {p.count(chr(13))}," f" leading whitespace {'yes' if p[:1].isspace() else 'no'}, trailing whitespace {'yes' if p[-1:].isspace() else 'no'}," f" non-ASCII characters {sum(1 for c in p if ord(c) > 127)}") +if "-----BEGIN PGP" in p or len(p) > 1000: + print("PROBLEM: SIGNING_PASSWORD holds a PGP key block (or something as long), not the passphrase." + " Put in only the passphrase chosen when the key was made.") PY home=$(mktemp -d)