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

Sambungkan ke server jarak jauh DevOps Agen

AWS DevOps Agen menyediakan server jarak jauh khusus untuk protokol Model Context Protocol (MCP) dan Agent-to-Agent (A2A). Gunakan server ini untuk menghubungkan IDE, CLI, atau integrasi agen kustom Anda ke Ruang Agen.

Protokol yang didukung

Titik akhir

Server jarak jauh tersedia di URL regional:

https://connect.aidevops.{region}.api.aws

Untuk daftar Wilayah yang tersedia, lihatWilayah yang Didukung.

Autentikasi

Dua metode otentikasi tersedia untuk titik akhir MCP dan A2A:

Buat token akses

Prasyarat

Aktifkan token akses

Buat token

Setelah membuat token, aplikasi web menampilkan contoh konfigurasi yang dapat Anda salin langsung ke klien Anda.

Terhubung dengan Kiro

Untuk pengguna Kiro, kekuatan AWS DevOps Agen khusus tersedia dari IDE atau dari pasar Kiro Powers.

Langkah 1: Pasang daya

Instal kekuatan aws-devops-agent dari pasar Powers.

Langkah 2: Tetapkan variabel lingkungan

Tetapkan variabel lingkungan berikut untuk mengkonfigurasi koneksi:

DEVOPS_AGENT_TOKEN=<your-access-token>
DEVOPS_AGENT_REGION=<your-agent-space-region>

Langkah 3: Setujui variabel di Kiro

Buka Pengaturan > MCP Approved Env Vars dan setujui dan. DEVOPS_AGENT_TOKEN DEVOPS_AGENT_REGION Kiro tidak meneruskan variabel lingkungan ke server MCP sampai mereka disetujui.

Langkah 4: Mulai Ulang Kiro

Mulai ulang Kiro untuk menerapkan perubahan.

Kekuatan Kiro disertakan aws-mcp sebagai fallback, yang menyediakan akses AWS API langsung saat titik akhir server jarak jauh tidak tersedia.

Terhubung dengan Claude Code

Untuk pengguna Claude Code, AWS DevOps Agen tersedia dari plugin aws-agents-for-devsecops Claude, yang membawa kemampuan Agen dan AWS DevOps Agen Keamanan ke Claude. AWS Instal dari plugin Claude atau repositori sumber.

Terhubung dengan klien MCP lainnya

Untuk MCP-compatible klien apa pun, konfigurasikan server dengan:

Konfigurasi ini juga berfungsi dengan Kiro dan Claude Code jika Anda lebih suka mengkonfigurasi koneksi secara manual daripada menggunakan daya atau plugin khusus.

Contoh konfigurasi MCP:

{
  "mcpServers": {
    "aws-devops-agent": {
      "url": "https://connect.aidevops.{region}.api.aws/mcp",
      "headers": {
        "Authorization": "Bearer <your-access-token>"
      }
    }
  }
}

Ganti {region} dengan Wilayah Ruang Agen Anda (misalnya,us-east-1) dan <your-access-token> dengan nilai token.

Gunakan otentikasi SIGv4

Otentikasi SIGv4 menggunakan AWS kredentif Anda alih-alih token akses. Plugin Kiro power dan Claude Code menyertakan dukungan SIGv4 bawaan melaluimcp-proxy-for-aws, yang menandatangani permintaan menggunakan kredenSIAL lokal AWS Anda.

Ketika SIGv4 digunakan

Prasyarat

Contoh konfigurasi

Untuk mengkonfigurasi klien MCP untuk menggunakan SIGv4 alih-alih token akses, jalankan server melalui. mcp-proxy-for-aws Ganti {region} dengan Wilayah Ruang Agen Anda (misalnya,us-east-1):

{
  "mcpServers": {
    "aws-devops-agent": {
      "command": "uvx",
      "timeout": 120000,
      "args": [
        "mcp-proxy-for-aws@latest",
        "https://connect.aidevops.{region}.api.aws/mcp",
        "--service", "aidevops",
        "--region", "{region}"
      ]
    }
  }
}

Proksi menandatangani setiap permintaan dengan AWS kredenSIAL lokal Anda, jadi tidak diperlukan token akses.

Multi-Agent-Space perutean

Dalam mode SIGv4, berikan setiap agent_space_id panggilan alat untuk menentukan Ruang Agen mana yang akan digunakan. Ini memungkinkan untuk merutekan melintasi beberapa Ruang Agen dari satu klien.

Integrasi A2A

Titik akhir A2A mengimplementasikan spesifikasi A2A v1.0 menggunakan pengikatan HTTP+JSON.

Minta header

Lewati header berikut pada permintaan A2A.

Penemuan kartu agen

Ambil kartu agen di:

GET https://connect.aidevops.{region}.api.aws/.well-known/agent-card.json

Operasi yang didukung

Keterampilan

Pertimbangan keamanan

Pelingkupan token

Daftar izin IP

Saat membuat token akses, Anda dapat secara opsional menentukan daftar izin IP. Saat dikonfigurasi, token hanya dapat digunakan dari alamat IP atau rentang CIDR yang ditentukan. Permintaan dari IP lain ditolak dengan kesalahan akses ditolak.

Rotasi dan pencabutan token

Menanggapi token yang dikompromikan

Jika Anda mencurigai token telah dikompromikan, ikuti langkah-langkah berikut:

Mencabut token secara terprogram

Anda juga dapat mencabut token secara terprogram menggunakan. awscurl Perintah berikut menggunakan otentikasi SIGv4. Ganti Region (us-east-1) dengan Region tempat Ruang Agen Anda dibuat.

Langkah 1: Daftarkan Ruang Agen Anda

aws aidevops list-agent-spaces --region us-east-1

Langkah 2: Daftar token akses untuk Ruang Agen

awscurl --service aidevops --region us-east-1 \
  -H "Accept: application/json" \
  "https://cp.aidevops.us-east-1.api.aws/v1/agentspaces/{agentSpaceId}/access-tokens"

Langkah 3: Cabut token

awscurl --service aidevops --region us-east-1 -X POST \
  -H "Accept: application/json" \
  "https://cp.aidevops.us-east-1.api.aws/v1/agentspaces/{agentSpaceId}/access-tokens/{accessTokenId}/revoke"

Ganti {agentSpaceId} dan {accessTokenId} dengan nilai-nilai dari tanggapan sebelumnya.

Ketertelusuran

AWS DevOps Agen merekam aktivitas server jarak jauh di AWS CloudTrail. Gunakan catatan ini untuk melacak siapa yang memanggil server jarak jauh dan apa yang dilakukan agen sebagai hasilnya. AWS DevOps Agen mengirimkan CloudTrail acara ke AWS akun yang menampung Ruang Agen.

Akses acara otentikasi token

Setiap kali AWS DevOps Agen mengotentikasi token akses untuk titik akhir MCP atau A2A, ia memancarkan peristiwa AuthenticateAccessToken ke. CloudTrail AWS DevOps Agen mencatat otentikasi yang berhasil dan gagal. Gunakan catatan ini untuk mengaudit penggunaan yang sah dan mendeteksi upaya yang ditolak. Contohnya termasuk token kedaluwarsa atau dicabut, dan permintaan yang diblokir oleh daftar izin IP.

Acara ini memiliki karakteristik sebagai berikut:

Acara ini mencakup bidang-bidang utama berikut:

Acara aksi hilir

Saat Anda menggunakan token akses, AWS DevOps Agen mengambil peran atas nama Anda untuk melakukan tindakan. AWS DevOps Agen mencatat AssumeRole panggilan ini CloudTrail dengan tag sesi yang mengidentifikasi token dan pemanggil:

Setiap tindakan yang dilakukan agen atas nama Anda memiliki panggilan AWS API hilir terkait yang CloudTrail dicatat. Nama sesi peran menggunakan formattoken_{spaceId}_{timestamp}_{tokenName}. Nama sesi ini cocok dengan roleSessionName dalam AuthenticateAccessToken acara. Gunakan untuk melacak dari otentikasi ke tindakan spesifik yang mengikutinya.

Pemanggilan SigV4

Pemanggilan yang menggunakan otentikasi AWS SIGv4 alih-alih token akses tidak menghasilkan peristiwa. AuthenticateAccessToken AWS DevOps Agen mengaitkan permintaan SIGv4 ke AWS identitas Identitas dan Manajemen Akses (IAM) Anda. Anda dapat melacak tindakan yang dilakukan agen melalui panggilan AWS API hilir yang mereka picu.

Batasan kebijakan titik akhir VPC

Titik akhir server jarak jauh tidak mendukung kebijakan titik akhir VPC. Panggilan menggunakan token akses atau otentikasi SIGv4 tidak dapat dibatasi oleh kebijakan titik akhir VPC.

Menonaktifkan token akses

Fitur token akses dinonaktifkan secara default. Untuk menonaktifkannya setelah mengaktifkan:

Menonaktifkan segera memblokir semua akses berbasis token. Token yang ada tidak dihapus tetapi tidak dapat digunakan sampai fitur diaktifkan kembali.

Untuk mencegah pengguna di organisasi Anda mengaktifkan token akses, buat Kebijakan Kontrol Layanan (SCP) yang menolak tindakan API token akses dan UpdateAgentSpace tindakan (yang mengontrol sakelar token akses):

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "DenyAccessTokenOperations",
      "Effect": "Deny",
      "Action": [
        "aidevops:UpdateAgentSpace",
        "aidevops:CreateAccessToken",
        "aidevops:GetAccessToken",
        "aidevops:ListAccessTokens",
        "aidevops:RotateAccessToken",
        "aidevops:RevokeAccessToken"
      ],
      "Resource": "*"
    }
  ]
}

Pemecahan masalah