日本語

署名付きコミット

Aikido は以下の対象で署名付きコミットをサポートしています GitHub, GitLab, Bitbucket Cloud と Bitbucket Data Center コード変更の真正性を確保するためです。GitHub では設定不要ですが、GitLab と Bitbucket のユーザーは、Aikido が提供する特定の SSH キーを自分のアカウントに追加する必要があります。

なぜ署名付きコミットを使うのか？

署名付きコミットは暗号学的な保証の層を提供し、コード変更が Aikido に由来し、改ざんされていないことを証明します。これは次のために重要です:

  • 本人確認： そのコミットが実際に認可されたサービスによって作成されたことを保証します。
  • 信頼とセキュリティ： 悪意ある攻撃者が信頼された貢献者になりすます「コミットのなりすまし」を防ぎます。
  • 監査対応： 次のようなセキュリティコンプライアンスフレームワークへの対応に役立ちます SOC2, ISO 27001、および HIPAA.

セットアップ

GitHub

設定は不要です。 GitHub は Aikido 連携経由で作成されたコミットを自動的に認識し、署名します。これらは次の表示で 「Verified」 バッジとして即座にコミット履歴に表示されます。

GitLab

GitLab で署名付きコミットを有効にするには、 Personal Access Token (PAT) による認証を使用する必要があります。この機能は OAuth では利用できません。

ユーザーに関する重要な注意： GitLab は署名付きコミットを 実ユーザーアカウントのみサポートしており、サービスアカウントは対象外です。Aikido で使用する PAT は実ユーザーのものでなければなりません。

設定手順：

  1. 設定に移動： Aikido で AutoFix 設定 ページ に移動し、 承認 （初回設定時）または Personal Access Token を管理 （トークンがすでに設定されている場合）をクリックします。
  2. PAT を設定： GitLab のユーザー設定で生成した Personal Access Token を Aikido に入力します。
  3. SSH キーを生成： クリックします SSH キーを生成 を Aikido 内で実行し、独自の署名キーを作成します。
  4. GitLab に追加：
    • Aikido が提供する公開鍵をコピーします。
    • GitLab で ユーザーアイコン を右上でクリックし、 > プロフィールを編集 > SSH Keys > 新しいキーを追加
    • キーを貼り付け、 使用タイプ が 「Authentication & Signing」.
  5. 検証： Aikido に戻り、 SSH キーを検証 をクリックして、接続が有効であることを確認します。

これで Verified バッジが Aikido のコミットに表示されます：

Aikido は各アカウントごとに固有の SSH キーを作成します。この SSH キーは、 SSH キーを削除 をクリックして新しいキーを作成することで再生成できます。

Bitbucket Cloud

Bitbucket Cloud での署名付きコミットには Workspace Access Token を使用した AutoFix。SSH キーは実在のユーザーのものである必要があり、コミットのメールアドレスはそのユーザーのワークスペース内で検証済みのメールアドレスでなければなりません。

  1. 設定に移動： Aikido で Workspace Access Token を更新 ページ を開き AutoFix タブを選択します。
  2. コミットのメールアドレスを設定: Aikido で、SSH キーの所有者となる Bitbucket ユーザーのメールアドレスを入力します。
  3. SSH キーを生成： 次の Advanced セクションで、 SSH キーを生成.
  1. Bitbucket に追加: Aikido が提供する公開鍵をコピーします。Bitbucket で、 設定 右上のアイコンをクリックし > 個人用 Bitbucket 設定を選択し、次に セキュリティ > SSH キー > キーを追加 に移動して、キーを貼り付けます。

これで Verified Aikido からのコミットに表示されるバッジ。

Bitbucket Data Center

  1. AutoFix 設定に移動: Aikido で AutoFix 設定 ページ に移動し、 Personal Access Token を管理 Bitbucket Data Center 用です。
  2. コミットのメールアドレスを設定: Aikido で、SSH キーの所有者となる Bitbucket ユーザーのメールアドレスを入力します。
  3. SSH キーを生成： 次の Advanced モーダルのセクションで、クリックします SSH キーを生成.
  1. Bitbucket に追加: Aikido が提供する公開鍵をコピーします。Bitbucket Data Center では、 プロフィール > アカウントを管理 > SSH キー > キーを追加 に移動して、キーを貼り付けます。