日本語

GitLab Free: MRスキャンのセットアップ

Aikidoの問題についてMRスキャン結果とコメントを公開します。パイプラインコードは不要です。

このセットアップは、 GitLab Free Service Accounts が利用できず、代わりに専用ユーザーを使用するプラン向けです。

もしご利用中のプランが GitLab Premium、GitLab Ultimate、または GitLab Server、次のものを使用します サービスアカウント ユーザーベースのセットアップの代わりに。

GitLab MR スキャンを設定する

  1. 専用の GitLab ユーザーを作成する

    次のような専用ユーザーを作成します AikidoSecurity[YourCompany]。Aikido 専用で使用してください。

    見分けやすくするために、 Aikido のロゴ をプロフィール画像に使用します。

  2. 個人アクセストークンを作成する

    新しいユーザーとしてログインします。

    次へ移動します: 設定 → 個人アクセストークン.

    新しいトークンを追加:

    • 名前: 例 Aikido Scans
    • 有効期限: ローテーションポリシーに合った有効期限を設定します
    • スコープ: api
  3. トークンを保存

    今すぐトークンをコピーしてください。GitLab では再表示されません。

    ステップ 6 で Aikido に貼り付けます。

  4. Aikido ユーザーをグループに招待する

    自分の GitLab アカウントで再度ログインします。

    次へ移動します: グループ.

    有効にしたい各グループで、そのグループを開きます。

    次へ移動します: 管理 → メンバー → メンバーを招待.

    専用の Aikido ユーザーを招待します。

    少なくとも メンテナー の権限を付与します。

  5. 連携を有効にする

    Aikido で、次を開きます: 連携 ページ。次に、 GitLab CI 以下の MR 品質ゲート.

  6. 個人アクセストークンを貼り付ける

    ステップ 3 で作成したトークンを貼り付けます。

    クリックします トークンを更新.

    Aikido はグループへのアクセスと必要な権限を検証します。

  7. 最初のリポジトリを設定する

    認証後、Aikido は次を開きます: GitLab MR チェック ページ上で使用します。

    まずは 1つのリポジトリ を最初に設定します。全体に展開する前に、すべてが正しく動作することを確認してください。

  8. 新しい MR で確認する

    設定したリポジトリで新しいマージリクエスト(MR)を開きます。

    その後、チェックが次の場所で実行されていることを確認します パイプライン タブを選択します。

    コメントは専用ユーザーとして表示されるはずです。たとえば、 @AikidoSecurity[YourCompany].

  9. スキャンの成功を必須にする

    スキャンが成功するまでマージをブロックしたい場合は、 マージチェック GitLab で。

    GitLab で次へ移動します [リポジトリ] → 設定 → マージリクエスト。チェックを有効にします パイプラインは成功する必要があります.

  10. すべてのリポジトリで有効にする

    結果に満足したら、 GitLab MR チェック ページに戻り、残りのリポジトリでチェックを有効にします。

  11. 新しいリポジトリのデフォルトを設定する

    右上で、次を開きます: アクション and select 新しいリポジトリのデフォルトを設定 また、今後追加されるリポジトリに対して自動設定を有効にします。

    UI の手順ガイドが必要ですか?こちらをご覧ください 新しいリポジトリに対するデフォルトのPR/MRゲーティング設定.

MR コメントから直接問題を無視する

Aikido が検出結果に対してインラインの MR コメントを投稿した場合、コメントに次のように返信することで GitLab から直接その問題を無視できます:

@AikidoSecurity[YourCompany] ignore: [無視する理由を入力]

例:

@AikidoSecurity[YourCompany] ignore: このシークレットはテスト専用で使用されます。

置き換えてください @AikidoSecurity[YourCompany] ステップ 1 で作成した専用の GitLab ユーザーのユーザー名を使用します。

これは、Aikido プラットフォームで手動で問題を無視するのと同じ操作です:

  • 問題は Aikido で無視済みとしてマークされます。
  • 無視理由が保存されます。
  • すべてのブロッキングな問題が解決または無視されると、MR ゲーティングは緑になります。

この返信は、あなたがその 課題を無視可能 権限です。その権限がない場合、Aikido は無視が許可されていないと応答し、指摘は未解決のまま残ります。