Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Jalankan pemindaian keamanan kode dari IDE Anda

Jalankan pemindaian keamanan kode AWS Security Agent langsung dari IDE Anda menggunakan Kiro atau Claude Code. Integrasi IDE memungkinkan Anda memindai kode sumber lokal Anda untuk kerentanan keamanan, menjalankan pemindaian diferensial hanya pada kode yang diubah, dan melakukan tinjauan model ancaman pada dokumen desain — semuanya tanpa meninggalkan lingkungan pengembangan Anda. Temuan muncul di samping kode Anda dengan panduan remediasi, dan Anda dapat menerapkan perbaikan otomatis langsung dari IDE.

Cara kerja integrasi IDE

Integrasi IDE menggunakan server AWS Security Agent MCP (Model Context Protocol) untuk menghubungkan IDE Anda ke layanan AWS Security Agent:

Server MCP menangani semua orkestrasi — penyediaan ruang agen, pembuatan bucket S3, penyiapan peran IAM, pengemasan kode, dan pemungutan suara pindai — sehingga Anda hanya memerlukan kredensi AWS yang dikonfigurasi secara lokal.

Prasyarat

Sebelum Anda mulai, pastikan Anda memiliki:

Instal server MCP

Kiro

Instal AWS Security Agent Power dari marketplace Kiro. Power menggabungkan konfigurasi server MCP, instruksi kemudi, dan kait siklus hidup untuk saran pemindaian keamanan otomatis.

Atau, konfigurasikan server MCP secara manual di proyek Anda: .kiro/mcp.json

{
  "mcpServers": {
    "security-agent": {
      "command": "uvx",
      "args": ["awslabs.security-agent-mcp-server@latest"],
      "env": {
        "AWS_PROFILE": "default",
        "AWS_REGION": "us-east-1",
        "FASTMCP_LOG_LEVEL": "ERROR"
      }
    }
  }
}

Kode Claude

Instal plugin AWS Security Agent, yang menyediakan keterampilan untuk penyiapan, pemindaian lengkap, pemindaian diff, ulasan model ancaman, dan remediasi.

Konfigurasikan server MCP di proyek Anda: .mcp.json

{
  "mcpServers": {
    "awslabs.security-agent-mcp-server": {
      "command": "uvx",
      "args": ["awslabs.security-agent-mcp-server@latest"],
      "env": {
        "AWS_PROFILE": "default",
        "AWS_REGION": "us-east-1",
        "FASTMCP_LOG_LEVEL": "ERROR"
      }
    }
  }
}

First-time penyiapan

Pada penggunaan pertama, server MCP secara otomatis menyediakan sumber daya AWS yang diperlukan:

Untuk memicu penyiapan secara eksplisit, tanyakan IDE Anda:

Set up the security agent

Penyiapan memverifikasi kredensyal AWS Anda, membuat atau menggunakan kembali Ruang Agen, menyediakan peran IAM dan bucket S3, dan mengonfirmasi kesiapan. Jika Anda sudah memiliki Ruang Agen dari AWS Management Console, penyiapan akan menunjukkannya dan menanyakan mana yang akan digunakan.

Jalankan pemindaian keamanan penuh

Pindai seluruh proyek Anda untuk mencari kerentanan keamanan:

Scan this project for security issues

IDE:

Memindai kemajuan

Pemindaian penuh biasanya memakan waktu sekitar 1 jam tergantung pada ukuran basis kode. IDE memeriksa kemajuan setiap 5 menit dan memberi tahu Anda saat hasilnya siap. Anda dapat meminta status kapan saja:

How's the scan going?

Jalankan pemindaian diferensial

Untuk umpan balik yang lebih cepat selama pengembangan, pindai hanya kode yang berubah sejak git ref:

Scan my changes against main for security issues

Secara default, jika Anda tidak menentukan referensi dasar, pemindaian akan membandingkan perubahan Anda yang tidak berkomitmen. HEAD Anda dapat secara eksplisit menentukan basis yang berbeda:

Diff scan my uncommitted changes

Pemindaian diferensial mengunggah konteks repositori lengkap dan patch git diff, lalu menjalankan analisis yang hanya berfokus pada baris yang diubah. Hasil biasanya tiba dalam 5-15 menit.

Untuk informasi selengkapnya tentang API pemindaian diff S3, lihat. Jalankan pemindaian kode diferensial dengan S3

Jalankan tinjauan model ancaman

Menganalisis dokumen desain untuk perubahan postur keamanan menggunakan metodologi STRIDE:

Run a threat model review on my spec

IDE mengidentifikasi design.md file Anda requirements.md dan (biasanya di bawah.kiro/specs/), mengunggahnya bersama kode sumber Anda, dan menjalankan analisis model ancaman. Hasil mengidentifikasi:

Tinjau temuan

Ketika pemindaian selesai, temuan muncul di IDE Anda dikelompokkan berdasarkan tingkat keparahan:

🟣 CRITICAL: SQL Injection in user-service.ts
   File: src/api/user-service.ts:45
   User input flows directly into SQL query without parameterization

🔴 HIGH: Hardcoded credentials in config.ts
   File: src/config/database.ts:12
   Database password stored in source code

Laporan terperinci juga ditulis .security-agent/findings-{scan_id}.md dengan informasi lengkap untuk setiap temuan termasuk jenis risiko, skor kepercayaan, lokasi kode, dan kode remediasi.

Untuk melihat temuan dari pemindaian sebelumnya:

Show my security findings

Terapkan perbaikan otomatis

Setelah meninjau temuan, terapkan remediasi otomatis:

Fix the security findings

IDE bekerja melalui temuan top-down berdasarkan tingkat keparahan (Kritis → Tinggi → Sedang → Rendah), menerapkan perbaikan kode menggunakan panduan remediasi dari setiap temuan. Setelah semua perbaikan diterapkan, secara otomatis menjalankan pemindaian diff verifikasi untuk mengonfirmasi masalah diselesaikan.

Anda juga dapat memperbaiki temuan individu:

Fix the SQL injection in user-service.ts

Saran pemindaian otomatis (Kiro)

Saat menggunakan Kiro Power, AWS Security Agent dapat secara otomatis menyarankan pemindaian diff setelah Anda melakukan perubahan kode yang sensitif terhadap keamanan. Power memasang hook yang mengevaluasi setiap giliran pengkodean yang telah selesai dan menyarankan pemindaian saat perubahan memengaruhi:

Anda dapat memilih keluar dari saran otomatis kapan saja dengan menghapus. .kiro/hooks/security-diff-scan-suggester.kiro.hook

Jenis pemindaian yang tersedia

Variabel-variabel lingkungan

Pemecahan masalah

“Tidak dikonfigurasi. Jalankan pengaturan terlebih dahulu.”

Anda .security-agent/config.json hilang atau Ruang Agen tidak ada lagi. Minta IDE untuk menjalankan penyiapan:

Set up the security agent

Pemindaian gagal dengan AccessDenied

Pastikan kredensyal AWS Anda memiliki izin IAM yang diperlukan yang tercantum di bagian Prasyarat. Izin hilang yang paling umum adalah iam:CreateRole (hanya diperlukan untuk pengaturan pertama kali).

Waktu pemindaian habis atau terlalu lama

Perbedaan kosong - tidak ada perubahan untuk memindai

Jika Anda menjalankan pemindaian diff tanpa perubahan yang tidak dilakukan, server MCP melaporkan “Tidak ada perubahan vs HEAD” dan tidak memulai pemindaian. Komit atau tahapkan perubahan Anda terlebih dahulu, atau tentukan referensi dasar yang berbeda.

Kuota dan batas

Langkah selanjutnya

Setelah menjalankan pemindaian keamanan IDE pertama Anda: