https://blog.plzhans.com/categories/security/Recent content in Security on plzhans blogHugoko-krSun, 30 Aug 2026 01:18:00 +0000https://blog.plzhans.com/posts/102-age-recipients-team-encryption-guide/Fri, 01 May 2026 22:57:00 +0000https://blog.plzhans.com/posts/102-age-recipients-team-encryption-guide/<p><picture> <source srcset="https://blog.plzhans.com/posts/102-age-recipients-team-encryption-guide/assets/1_38322a0f-7e83-80a2-ba17-e65632a1b3af_hu_88821804df89a8f9.webp" type="image/webp"> <img src="https://blog.plzhans.com/posts/102-age-recipients-team-encryption-guide/assets/1_38322a0f-7e83-80a2-ba17-e65632a1b3af_hu_1c922648875a6db4.png" alt="age로 팀 비밀 파일을 공개키(recipients)로 암호화하고 개인키로 복호화하는 흐름을 나타난 대표 이미지" width="1200" height="670" loading="eager" fetchpriority="high"> </picture></p> <h2 id="개요">개요</h2> <h3 id="age란">age란?</h3> <p>age는 파일을 <strong>공개키(Recipient) 기반으로 간단하게 암호화/복호화</strong>할 수 있는 도구다.</p> <p>결과물은 보통 <code>*.age</code> 파일로 저장하며 개인키는 로컬에만 보관한다.</p> <h3 id="age가-해결하는-문제">age가 해결하는 문제</h3> <ul> <li>팀에서 민감한 설정 파일을 평문으로 공유하지 않고 저장한다</li> <li>recipient(공개키) 목록만 알면 누구나 암호화할 수 있고, 개인키를 가진 사람만 복호화할 수 있다</li> <li>사용 흐름이 단순해서 CI/스크립트에 붙이기 쉽다</li> </ul> <h3 id="gpg와의-차이간략">GPG와의 차이(간략)</h3> <ul> <li><strong>키 배포/검색</strong> <ul> <li>GPG: 키 서버에 공개키를 업로드하고 검색/검증하는 문화가 있다</li> <li>age: 키 서버 모델이 일반적이지 않고, 프로젝트 내 <code>recipients.txt</code> 같은 파일로 recipient를 관리하는 경우가 많다</li> </ul> </li> <li><strong>기능 범위</strong> <ul> <li>GPG: 서명, 웹오브트러스트, 이메일 암호화 등 기능이 넓다</li> <li>age: 파일 암호화에 집중(단순함이 장점)</li> </ul> </li> <li><strong>팀 운영</strong> <ul> <li>age: <code>recipients</code> 파일에 팀원 공개키를 추가/삭제하는 방식이 실무에서 직관적이다</li> </ul> </li> </ul> <blockquote> <p>🔒 개인키 파일(age-key)은 절대 원격 저장소에 올리지 않는다. 필요한 경우 CI Secret 또는 별도 비밀 저장소를 사용한다.</p>