https://blog.plzhans.com/ja/categories/security/Recent content in Security on plzhans blogHugojaSun, 30 Aug 2026 01:18:00 +0000https://blog.plzhans.com/ja/posts/102-age-recipients-team-encryption-guide/Fri, 01 May 2026 22:57:00 +0000https://blog.plzhans.com/ja/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: 署名、Web of Trust、メール暗号化など機能が幅広いです</li> <li>age: ファイル暗号化に特化しています（シンプルさが利点）</li> </ul> </li> <li><strong>チーム運用</strong> <ul> <li>age: <code>recipients</code> ファイルにチームメンバーの公開鍵を追加・削除する方式が実務で直感的です</li> </ul> </li> </ul> <blockquote> <p>:lock: 秘密鍵ファイル（age-key）は絶対にリモートリポジトリにアップロードしないでください。必要な場合は CI Secret または別のシークレットストアを使用します。</p> </blockquote> <hr> <h2 id="インストール">インストール</h2> <h3 id="macos">macOS</h3> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="ln">1</span><span class="cl"><span class="c1"># Homebrew</span> </span></span><span class="line"><span class="ln">2</span><span class="cl">brew install age </span></span></code></pre></div><h3 id="linux">Linux</h3> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="ln"> 1</span><span class="cl"><span class="c1"># RHEL/CentOS/Amazon Linux</span> </span></span><span class="line"><span class="ln"> 2</span><span class="cl">sudo yum install age </span></span><span class="line"><span class="ln"> 3</span><span class="cl"> </span></span><span class="line"><span class="ln"> 4</span><span class="cl"><span class="c1"># Debian/Ubuntu</span> </span></span><span class="line"><span class="ln"> 5</span><span class="cl"><span class="c1"># sudo apt install age</span> </span></span><span class="line"><span class="ln"> 6</span><span class="cl"> </span></span><span class="line"><span class="ln"> 7</span><span class="cl"><span class="c1"># Fedora</span> </span></span><span class="line"><span class="ln"> 8</span><span class="cl"><span class="c1"># sudo dnf install age</span> </span></span><span class="line"><span class="ln"> 9</span><span class="cl"> </span></span><span class="line"><span class="ln">10</span><span class="cl"><span class="c1"># Arch</span> </span></span><span class="line"><span class="ln">11</span><span class="cl"><span class="c1"># sudo pacman -S age</span> </span></span></code></pre></div><h3 id="windows">Windows</h3> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="ln">1</span><span class="cl">winget install FiloSottile.age </span></span><span class="line"><span class="ln">2</span><span class="cl"><span class="c1"># Chocolatey: choco install age</span> </span></span></code></pre></div><hr> <h2 id="基本的な使い方の流れ">基本的な使い方の流れ</h2> <h2 id="1-鍵の生成秘密鍵ファイルの作成">1) 鍵の生成（秘密鍵ファイルの作成）</h2> <p>できるだけユーザーディレクトリの配下に作成します。</p>