feat(release): one-command desktop release with Ed25519-signed update metadata
The installer is unsigned, so latest.yml is now signed with an Ed25519 key and the app verifies the downloaded installer against it before installing. npm run release -- patch|minor bumps, gates, tags, builds, signs, publishes, re-verifies the public feed and pushes; --resume continues after a failure. The retired GitLab registry publisher is removed.
This commit is contained in:
parent
f5ae4c8c04
commit
fd9c97b7cc
21 changed files with 986 additions and 144 deletions
|
|
@ -8,7 +8,8 @@ import { app, dialog } from 'electron'
|
|||
import { getLogger } from './LoggerService'
|
||||
import { configGet } from './ConfigService'
|
||||
import { getMainWindow } from '../windows/WindowManager'
|
||||
import { UPDATE_FEED_URL, UPDATE_POLICY_URL } from '../update-feed'
|
||||
import { UPDATE_FEED_URL, UPDATE_POLICY_URL, versionedManifestUrl } from '../update-feed'
|
||||
import { verifyDownloadedUpdate } from '../update-signature'
|
||||
import { DEFAULT_UPDATE_POLICY, parseUpdatePolicy, type UpdatePolicy } from '../update-policy'
|
||||
import { PORTABLE_INSTALL_MARKER, detectInstallKind, type InstallProbe } from '../install-kind'
|
||||
import type {
|
||||
|
|
@ -24,6 +25,41 @@ const logger = getLogger('UpdateService')
|
|||
|
||||
/** 원격 정책 fetch 타임아웃 */
|
||||
const POLICY_FETCH_TIMEOUT_MS = 8_000
|
||||
/** 서명된 latest.yml fetch 타임아웃 */
|
||||
const MANIFEST_FETCH_TIMEOUT_MS = 15_000
|
||||
|
||||
async function fetchText(url: string): Promise<string> {
|
||||
const response = await fetch(url, { cache: 'no-store', signal: AbortSignal.timeout(MANIFEST_FETCH_TIMEOUT_MS) })
|
||||
if (!response.ok) throw new Error(`HTTP ${response.status} ${url}`)
|
||||
return response.text()
|
||||
}
|
||||
|
||||
/**
|
||||
* NsisUpdater 는 받은 파일을 넘기기 전에 `verifySignature(path)` 를 부르고, 문자열을 돌려받으면
|
||||
* 파일을 지우고 ERR_UPDATER_INVALID_SIGNATURE 로 실패한다. 무서명 앱에선 이 단계가 아무것도 안 하므로
|
||||
* 우리 Ed25519 검증으로 바꿔 끼운다. 라이브러리가 이 지점을 없애면 업데이트를 받지 않는다(fail-closed).
|
||||
*/
|
||||
function installManifestVerifier(
|
||||
updater: import('electron-updater').AppUpdater,
|
||||
offeredVersion: () => string | null,
|
||||
): boolean {
|
||||
const target = updater as unknown as { verifySignature?: (path: string) => Promise<string | null> }
|
||||
if (typeof target.verifySignature !== 'function') return false
|
||||
target.verifySignature = async (installerPath: string): Promise<string | null> => {
|
||||
const version = offeredVersion()
|
||||
if (!version) return '받으려던 버전을 알 수 없음'
|
||||
const rejection = await verifyDownloadedUpdate({
|
||||
version,
|
||||
installerPath,
|
||||
fetchText,
|
||||
manifestUrl: versionedManifestUrl(version),
|
||||
})
|
||||
if (rejection) logger.error(`업데이트 v${version} 설치 거부 — ${rejection}`)
|
||||
else logger.info(`업데이트 v${version} 서명 확인 완료`)
|
||||
return rejection
|
||||
}
|
||||
return true
|
||||
}
|
||||
|
||||
/** 실행 중인 설치본의 형태를 파일 시스템에서 읽는다 (판단은 detectInstallKind). */
|
||||
function probeInstall(): InstallProbe {
|
||||
|
|
@ -74,6 +110,13 @@ export function createElectronUpdater(handlers: UpdaterEventHandlers): UpdaterPo
|
|||
return null
|
||||
}
|
||||
|
||||
let offeredVersion: string | null = null
|
||||
// macOS 는 Squirrel.Mac 이 앱 코드 서명을 직접 요구하므로 이 검증은 Windows(NSIS) 전용이다.
|
||||
if (process.platform === 'win32' && !installManifestVerifier(updater, () => offeredVersion)) {
|
||||
logger.error('electron-updater 에 설치 파일 검증 지점(verifySignature)이 없음 — 자동 업데이트 비활성')
|
||||
return null
|
||||
}
|
||||
|
||||
updater.setFeedURL({ provider: 'generic', url: UPDATE_FEED_URL })
|
||||
// 사용자 인가를 위해 자동 다운로드는 비활성화 (동의 시 downloadUpdate 호출)
|
||||
updater.autoDownload = false
|
||||
|
|
@ -87,7 +130,10 @@ export function createElectronUpdater(handlers: UpdaterEventHandlers): UpdaterPo
|
|||
}
|
||||
|
||||
updater.on('checking-for-update', () => handlers.onChecking())
|
||||
updater.on('update-available', (info) => handlers.onAvailable(info))
|
||||
updater.on('update-available', (info) => {
|
||||
offeredVersion = info.version
|
||||
handlers.onAvailable(info)
|
||||
})
|
||||
updater.on('update-not-available', (info) => handlers.onNotAvailable(info.version))
|
||||
updater.on('download-progress', (progress) =>
|
||||
handlers.onProgress({
|
||||
|
|
|
|||
|
|
@ -24,11 +24,13 @@ export const RUNTIME_FEED_URL = UPDATE_FEED_URL.replace(/\/latest$/, '/runtime-l
|
|||
/** 런타임 인덱스 파일명 (feed 루트) — RuntimeProvisioner 가 `${RUNTIME_FEED_URL}/${RUNTIME_INDEX_FILENAME}` 으로 읽는다 */
|
||||
export const RUNTIME_INDEX_FILENAME = 'runtime.json'
|
||||
|
||||
// GitLab Generic Registry legacy mirror. 2026-08 이전 설치본(0.2.1-alpha)은
|
||||
// 이 feed를 폴링하므로, 새 설치자가 Forgejo feed를 내장할 때까지 publisher가
|
||||
// 함께 게시한다. 마이그레이션 완료 후 제거 가능. 런타임은 참조하지 않는다.
|
||||
export const LEGACY_UPDATE_FEED_URL =
|
||||
'https://gitlab.twentyoz.kr:8443/api/v4/projects/1172/packages/generic/d3ro-voice/latest'
|
||||
/**
|
||||
* 버전별(불변) 경로의 latest.yml. 서명 검증은 `latest`(가변) 대신 이 경로를 본다 —
|
||||
* 받는 사이에 새 버전이 게시돼 latest.yml 이 바뀌어도 검증 대상이 흔들리지 않는다.
|
||||
*/
|
||||
export function versionedManifestUrl(version: string): string {
|
||||
return `${UPDATE_FEED_URL.replace(/\/latest$/, '')}/${encodeURIComponent(version)}/latest.yml`
|
||||
}
|
||||
|
||||
/** 업데이트 채널. `latest`=stable, `beta`, `alpha` 순으로 불안정. */
|
||||
export type UpdateChannel = 'latest' | 'beta' | 'alpha'
|
||||
|
|
|
|||
91
apps/desktop/src/main/update-signature.ts
Normal file
91
apps/desktop/src/main/update-signature.ts
Normal file
|
|
@ -0,0 +1,91 @@
|
|||
// src/main/update-signature.ts
|
||||
// 받은 업데이트 설치 파일이 우리가 게시한 것인지 확인한다.
|
||||
//
|
||||
// 설치본에 Authenticode 서명이 없어 electron-updater 는 자체 서명 검증을 건너뛴다. 그러면 피드
|
||||
// (Forgejo 패키지)가 털렸을 때 아무 설치 파일이나 배포된다. 그래서 게시 스크립트가 latest.yml 을
|
||||
// 오프라인 Ed25519 키로 서명하고(latest.yml.sig), 앱은:
|
||||
// 1. 버전별(불변) 경로의 latest.yml + .sig 를 받아 내장 공개키로 서명을 확인하고
|
||||
// 2. 그 latest.yml 의 version · sha512 가 받은 설치 파일과 같은지 본다.
|
||||
// 하나라도 어긋나면 설치를 거부한다(fail-closed). 게시 쪽: scripts/ci/lib/update-manifest-signature.mjs
|
||||
|
||||
import { createHash, createPublicKey, verify } from 'node:crypto'
|
||||
import { createReadStream } from 'node:fs'
|
||||
|
||||
/** release/desktop-update-public.pem 사본 — verify-release-metadata 가 둘이 같은지 검사한다 */
|
||||
export const UPDATE_SIGNING_PUBLIC_KEY = `-----BEGIN PUBLIC KEY-----
|
||||
MCowBQYDK2VwAyEAlvJTkVr7CSi9ZbBL2JOub7Sw4CAc1WOJpLEjDs/V/8o=
|
||||
-----END PUBLIC KEY-----
|
||||
`
|
||||
|
||||
export const UPDATE_SIGNATURE_SUFFIX = '.sig'
|
||||
|
||||
const ED25519_SIGNATURE_BYTES = 64
|
||||
|
||||
export interface SignedManifestInput {
|
||||
manifest: string
|
||||
signature: string
|
||||
publicKeyPem?: string
|
||||
}
|
||||
|
||||
/** 서명이 맞으면 latest.yml 의 version/sha512 를, 아니면 null 을 돌려준다 */
|
||||
export function readSignedManifest({
|
||||
manifest,
|
||||
signature,
|
||||
publicKeyPem = UPDATE_SIGNING_PUBLIC_KEY,
|
||||
}: SignedManifestInput): { version: string; sha512: string } | null {
|
||||
const signatureBytes = Buffer.from(signature.trim(), 'base64')
|
||||
if (signatureBytes.length !== ED25519_SIGNATURE_BYTES) return null
|
||||
let valid = false
|
||||
try {
|
||||
valid = verify(null, Buffer.from(manifest, 'utf8'), createPublicKey(publicKeyPem), signatureBytes)
|
||||
} catch {
|
||||
return null
|
||||
}
|
||||
if (!valid) return null
|
||||
// 서명된 내용이라 신뢰할 수 있다 — 최상위 키만 읽으면 된다(files[] 아래 들여쓴 줄은 제외).
|
||||
const version = manifest.match(/^version:\s*['"]?([^'"\s]+)['"]?\s*$/m)?.[1]
|
||||
const sha512 = manifest.match(/^sha512:\s*['"]?([^'"\s]+)['"]?\s*$/m)?.[1]
|
||||
return version && sha512 ? { version, sha512 } : null
|
||||
}
|
||||
|
||||
export function sha512Base64OfFile(path: string): Promise<string> {
|
||||
return new Promise((resolve, reject) => {
|
||||
const hash = createHash('sha512')
|
||||
createReadStream(path)
|
||||
.on('data', (chunk) => hash.update(chunk))
|
||||
.on('end', () => resolve(hash.digest('base64')))
|
||||
.on('error', reject)
|
||||
})
|
||||
}
|
||||
|
||||
export interface VerifyDownloadInput {
|
||||
/** 사용자에게 제안했던(받으려던) 버전 */
|
||||
version: string
|
||||
installerPath: string
|
||||
fetchText(url: string): Promise<string>
|
||||
manifestUrl: string
|
||||
publicKeyPem?: string
|
||||
hashFile?: (path: string) => Promise<string>
|
||||
}
|
||||
|
||||
/** 통과하면 null, 거부하면 사유 문자열 (electron-updater verifySignature 계약과 같다) */
|
||||
export async function verifyDownloadedUpdate(input: VerifyDownloadInput): Promise<string | null> {
|
||||
let manifest: string
|
||||
let signature: string
|
||||
try {
|
||||
;[manifest, signature] = await Promise.all([
|
||||
input.fetchText(input.manifestUrl),
|
||||
input.fetchText(`${input.manifestUrl}${UPDATE_SIGNATURE_SUFFIX}`),
|
||||
])
|
||||
} catch (err) {
|
||||
return `서명된 업데이트 메타데이터를 받지 못함: ${err instanceof Error ? err.message : String(err)}`
|
||||
}
|
||||
const signed = readSignedManifest({ manifest, signature, publicKeyPem: input.publicKeyPem })
|
||||
if (!signed) return 'latest.yml 서명이 유효하지 않음'
|
||||
if (signed.version !== input.version) {
|
||||
return `서명된 버전(${signed.version})이 받은 버전(${input.version})과 다름`
|
||||
}
|
||||
const actual = await (input.hashFile ?? sha512Base64OfFile)(input.installerPath)
|
||||
if (actual !== signed.sha512) return '설치 파일 sha512 가 서명된 latest.yml 과 다름'
|
||||
return null
|
||||
}
|
||||
Loading…
Add table
Add a link
Reference in a new issue