Kontrol keamanan dan akses

Harness memberi Anda primitif keamanan yang sama seperti yang lainnya AgentCore, terhubung dengan konfigurasi.

Model tanggung jawab bersama

Harness dibangun di atas AgentCore Runtime. Batas keamanannya sama: otentikasi IAM atau JWT dikombinasikan dengan isolasi microVM. Harness tidak menambahkan lapisan keamanan antara penelepon dan microVM.

Untuk model tanggung jawab bersama AgentCore Runtime penuh, lihat Praktik terbaik keamanan untuk AgentCore Runtime.

Batas kepercayaan dan validasi masukan

Semua InvokeHarness dan InvokeAgentRuntimeCommand masukan dipercaya. Setiap prinsipal yang melewati gerbang autentikasi dan otorisasi IAM atau JWT memiliki akses ke sesi microVM penuh, termasuk alat dan kemampuan yang dikonfigurasi pada harness. Harness tidak membersihkan input, memfilter blok konten, atau menegakkan batasan perilaku.

Jika Anda mengekspos harness kepada pengguna akhir yang tidak sepenuhnya Anda percayai (karyawan, konsumen eksternal, atau integrasi pihak ketiga), validasi dan sanitasi pesan di lapisan aplikasi Anda sebelum meneruskannya. InvokeHarness Ini termasuk menghapus jenis blok konten atau bidang konfigurasi model yang tidak ingin Anda kirimkan. Ini adalah pola yang sama dengan layanan apa pun yang menerima muatan dari penelepon resmi, seperti Lambda, Amazon API Gateway, dan Amazon SQS.

Parameter konfigurasi model

modelBidang dalam InvokeHarness menerima konfigurasi additionalParams Bedrock, OpenAI, dan LitellM. Parameter ini diteruskan ke penyedia model yang mendasarinya tidak berubah. Harness tidak memvalidasi, memfilter, atau membatasi parameter ini.

Penelepon yang dapat mengatur additionalParams dapat:

Jika aplikasi Anda mengekspos InvokeHarness kapabilitas ke penelepon yang tidak sepenuhnya Anda percayai, pertimbangkan untuk menerapkan validasi input di lapisan aplikasi Anda. Contohnya termasuk:

Keterampilan dan instruksi

Keterampilan adalah bundel penurunan harga dan skrip yang diambil harness dari Amazon S3 atau Git pada waktu pemanggilan dan disuntikkan ke dalam konteks agen. Harness memperlakukan semua konten keterampilan sebagai masukan tepercaya. Itu tidak memvalidasi, membersihkan, atau memeriksa konten atau sumber keterampilan sebelum memberikannya kepada agen.

Anda bertanggung jawab untuk:

Keterampilan dapat diganti per panggilan. InvokeHarness Jika aplikasi Anda meneruskan input yang disediakan pemanggil keInvokeHarness, pemanggil dapat menyediakan sumber keterampilan mereka sendiri yang berisi instruksi atau skrip arbitrer. Contoh mitigasi meliputi:

Observabilitas dan korelasi jejak

Harness secara otomatis menyebarkan pengidentifikasi korelasi ke AgentCore primitif hilir (Gateway, Memory, Code Interpreter, Browser) untuk mengaktifkan tampilan jejak terpadu di. CloudWatch Pengidentifikasi ini hanya digunakan untuk observabilitas - mereka tidak pernah digunakan untuk otorisasi atau keputusan akses data.

Konfigurasi jaringan

Secara default, sesi harness berjalan di jaringan publik. Untuk mengakses sumber daya pribadi (database, API internal, subnet pribadi), gunakan harness di VPC Anda.

Untuk panduan konfigurasi jaringan tambahan, lihat Mengkonfigurasi AgentCore Runtime dan alat bawaan konfigurasi VPC. Untuk konektivitas API masuk via PrivateLink, lihat Titik akhir antarmuka VPC.

OAuth masuk

Mengharuskan penelepon untuk menunjukkan JWT valid yang dikeluarkan oleh penyedia identitas yang dikonfigurasi sebelum mereka dapat memanggil harness. AgentCore Identitas menghubungkan identitas pengguna akhir melalui agen, sehingga alat hilir dapat memanggil API dengan kredensyal pengguna tercakup, bukan akun layanan bersama.

Pelajari lebih lanjut: AgentCore Identitas · otorisasi JWT masuk · kredensyal keluar

Kebijakan gateway

Ketika alat disajikan melalui AgentCore Gateway, Cedar-based kebijakan gerbang setiap panggilan: siapa yang dapat memanggil alat mana, dalam kondisi apa, dengan argumen mana.

Pelajari lebih lanjut: AgentCore Kebijakan · pola umum

Kebijakan peran eksekusi

Harness mengasumsikan peran eksekusi IAM yang Anda berikan. Kebijakan kepercayaan peran harus memungkinkan kepala AgentCore layanan untuk menganggapnya:

{
  "Version": "2012-10-17",
  "Statement": [{
    "Effect": "Allow",
    "Principal": {"Service": "bedrock-agentcore.amazonaws.com"},
    "Action": "sts:AssumeRole"
  }]
}

Izin IAM yang diperlukan untuk penelepon

Harness API memerlukan izin pada sumber daya harness dan sumber daya AgentCore Runtime dan Memori opsional yang mendasarinya. AgentCore Tabel berikut mencantumkan tindakan yang diperlukan untuk setiap API:

Sebagian besar tindakan menggunakan harness ARN sebagai ruang lingkup sumber daya:. arn:aws:bedrock-agentcore:<region>:<accountId>:harness/<id> Tindakan titik akhir juga menggunakan titik akhir harness ARN:. arn:aws:bedrock-agentcore:<region>:<accountId>:harness/<id>/harness-endpoint/<endpointName>

TheGetHarnessEndpoint,UpdateHarnessEndpoint, dan DeleteHarnessEndpoint action membutuhkan ARN harness dan ARN endpoint. CreateHarnessEndpointhanya membutuhkan harness ARN. Titik akhir belum ada, jadi tidak diperlukan ARN titik akhir. Saat Anda memanggil titik akhir khusus, InvokeHarness dan InvokeAgentRuntimeCommand memerlukan ARN harness dan ARN titik akhir.

Contoh kebijakan peran eksekusi

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "BedrockModelInvocation",
      "Effect": "Allow",
      "Action": [
        "bedrock:InvokeModel",
        "bedrock:InvokeModelWithResponseStream"
      ],
      "Resource": [
        "arn:aws:bedrock:*::foundation-model/*",
        "arn:aws:bedrock:<region>:<accountId>:*"
      ]
    },
    {
      "Sid": "EcrPublicTokenAccess",
      "Effect": "Allow",
      "Action": [
        "ecr-public:GetAuthorizationToken"
      ],
      "Resource": "*"
    },
    {
      "Sid": "StsForEcrPublicPull",
      "Effect": "Allow",
      "Action": [
        "sts:GetServiceBearerToken"
      ],
      "Resource": "*"
    },
    {
      "Sid": "XRayTracingAccess",
      "Effect": "Allow",
      "Action": [
        "xray:PutTraceSegments",
        "xray:PutTelemetryRecords",
        "xray:GetSamplingRules",
        "xray:GetSamplingTargets"
      ],
      "Resource": "*"
    },
    {
      "Sid": "CloudWatchLogsGroup",
      "Effect": "Allow",
      "Action": [
        "logs:CreateLogGroup",
        "logs:DescribeLogStreams"
      ],
      "Resource": "arn:aws:logs:<region>:<accountId>:log-group:/aws/bedrock-agentcore/runtimes/*"
    },
    {
      "Sid": "CloudWatchLogsDescribeGroups",
      "Effect": "Allow",
      "Action": [
        "logs:DescribeLogGroups"
      ],
      "Resource": "arn:aws:logs:<region>:<accountId>:log-group:*"
    },
    {
      "Sid": "CloudWatchLogsStream",
      "Effect": "Allow",
      "Action": [
        "logs:CreateLogStream",
        "logs:PutLogEvents"
      ],
      "Resource": "arn:aws:logs:<region>:<accountId>:log-group:/aws/bedrock-agentcore/runtimes/*:log-stream:*"
    },
    {
      "Sid": "CloudWatchMetricsPublish",
      "Effect": "Allow",
      "Resource": "*",
      "Action": "cloudwatch:PutMetricData",
      "Condition": {
        "StringEquals": {
          "cloudwatch:namespace": "bedrock-agentcore"
        }
      }
    },
    {
      "Sid": "AgentCoreWorkloadIdentity",
      "Effect": "Allow",
      "Action": [
        "bedrock-agentcore:GetWorkloadAccessToken",
        "bedrock-agentcore:GetWorkloadAccessTokenForJWT"
      ],
      "Resource": [
        "arn:aws:bedrock-agentcore:<region>:<accountId>:workload-identity-directory/default",
        "arn:aws:bedrock-agentcore:<region>:<accountId>:workload-identity-directory/default/workload-identity/harness_<agentName>-*"
      ]
    },
    {
      "Sid": "AgentCoreBrowserDefault",
      "Effect": "Allow",
      "Action": [
        "bedrock-agentcore:StartBrowserSession",
        "bedrock-agentcore:StopBrowserSession",
        "bedrock-agentcore:GetBrowserSession",
        "bedrock-agentcore:ListBrowserSessions",
        "bedrock-agentcore:UpdateBrowserStream",
        "bedrock-agentcore:ConnectBrowserAutomationStream",
        "bedrock-agentcore:ConnectBrowserLiveViewStream"
      ],
      "Resource": "arn:aws:bedrock-agentcore:<region>:aws:browser/*"
    },
    {
      "Sid": "AgentCoreCodeInterpreterDefault",
      "Effect": "Allow",
      "Action": [
        "bedrock-agentcore:StartCodeInterpreterSession",
        "bedrock-agentcore:StopCodeInterpreterSession",
        "bedrock-agentcore:GetCodeInterpreterSession",
        "bedrock-agentcore:ListCodeInterpreterSessions",
        "bedrock-agentcore:InvokeCodeInterpreter"
      ],
      "Resource": "arn:aws:bedrock-agentcore:<region>:aws:code-interpreter/*"
    }
  ]
}

AgentCore CLI menciptakan peran dengan izin ini secara otomatis saat Anda membuat proyek harness. Kebijakan di atas adalah untuk kasus di mana Anda membuat peran sendiri.

Untuk beban kerja produksi, lingkup Resource nilai hingga ke ARN spesifik yang dibutuhkan harness Anda daripada menggunakan. "*"

Izin tambahan untuk fitur opsional

Di bawah ini adalah contoh kebijakan yang dapat Anda tambahkan ke peran eksekusi berdasarkan fitur yang digunakan harness Anda. Ikuti prinsip hak istimewa paling sedikit - berikan agen harness Anda hanya alat dan kredensyal khusus yang dibutuhkan untuk inferensi. Lihat Referensi placeholder definisi placeholder.

Akses ECR pribadi (gambar wadah khusus)

Tambahkan kebijakan ini saat harness Anda menggunakan gambar ECR pribadi untuk wadah kustom.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "ECRImageAccess",
      "Effect": "Allow",
      "Action": [
        "ecr:GetDownloadUrlForLayer",
        "ecr:BatchGetImage"
      ],
      "Resource": "arn:aws:ecr:<ecrRegion>:<ecrAccountId>:repository/<ecrRepoName>"
    },
    {
      "Sid": "ECRTokenAccess",
      "Effect": "Allow",
      "Action": "ecr:GetAuthorizationToken",
      "Resource": "*"
    }
  ]
}

AgentCore Memori

Tambahkan kebijakan ini saat harness Anda menggunakan instance memori milik pelanggan.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AgentCoreMemory",
      "Effect": "Allow",
      "Action": [
        "bedrock-agentcore:CreateEvent",
        "bedrock-agentcore:DeleteEvent",
        "bedrock-agentcore:GetEvent",
        "bedrock-agentcore:ListEvents",
        "bedrock-agentcore:RetrieveMemoryRecords"
      ],
      "Resource": "arn:aws:bedrock-agentcore:<region>:<accountId>:memory/<memoryId>"
    }
  ]
}

AgentCore Browser (kustom)

Tambahkan kebijakan ini saat harness Anda menggunakan sumber daya browser khusus milik pelanggan.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AgentCoreBrowserCustom",
      "Effect": "Allow",
      "Action": [
        "bedrock-agentcore:StartBrowserSession",
        "bedrock-agentcore:StopBrowserSession",
        "bedrock-agentcore:GetBrowserSession",
        "bedrock-agentcore:ListBrowserSessions",
        "bedrock-agentcore:UpdateBrowserStream",
        "bedrock-agentcore:ConnectBrowserAutomationStream",
        "bedrock-agentcore:ConnectBrowserLiveViewStream"
      ],
      "Resource": "arn:aws:bedrock-agentcore:<region>:<accountId>:browser-custom/<browserCustomId>"
    }
  ]
}

AgentCore Kode Interpreter (kustom)

Tambahkan kebijakan ini saat harness Anda menggunakan penerjemah kode kustom milik pelanggan.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AgentCoreCodeInterpreterCustom",
      "Effect": "Allow",
      "Action": [
        "bedrock-agentcore:StartCodeInterpreterSession",
        "bedrock-agentcore:StopCodeInterpreterSession",
        "bedrock-agentcore:GetCodeInterpreterSession",
        "bedrock-agentcore:ListCodeInterpreterSessions",
        "bedrock-agentcore:InvokeCodeInterpreter"
      ],
      "Resource": "arn:aws:bedrock-agentcore:<region>:<accountId>:code-interpreter-custom/<codeInterpreterCustomId>"
    }
  ]
}

AgentCore Gerbang

Tambahkan kebijakan ini saat harness Anda menggunakan gateway yang dikonfigurasi dengan otentikasi masuk SiGv4.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AgentCoreGatewayAccess",
      "Effect": "Allow",
      "Action": "bedrock-agentcore:InvokeGateway",
      "Resource": "arn:aws:bedrock-agentcore:<region>:<accountId>:gateway/<gatewayId>"
    }
  ]
}

Sumber keterampilan di Amazon S3 dan Git

Tambahkan kebijakan ini saat harness Anda mengambil skill dari sumber Amazon S3. Peran eksekusi mencantumkan dan mengunduh objek skill di bawah awalan bucket.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AgentCoreSkillS3Access",
      "Effect": "Allow",
      "Action": [
        "s3:GetObject",
        "s3:ListBucket"
      ],
      "Resource": [
        "arn:aws:s3:::<skillBucket>",
        "arn:aws:s3:::<skillBucket>/*"
      ]
    }
  ]
}

Untuk mengambil keterampilan dari repositori Git pribadi, harness membaca token akses pribadi dari penyedia kredensi kunci API. Berikan kebijakan penyedia kredensyal kunci API yang ditunjukkan di bawah ini untuk penyedia kredensi yang memegang token.

Penyedia kredensi kunci API (referensi ARN header OpenAI, Gemini, LitellM, atau MCP)

Tambahkan kebijakan ini saat harness Anda menggunakan penyedia kredensi kunci API untuk penyedia model seperti OpenAI, Gemini, atau LiteLM.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AgentCoreApiKeyTokenVaultDefault",
      "Effect": "Allow",
      "Action": "bedrock-agentcore:GetResourceApiKey",
      "Resource": [
        "arn:aws:bedrock-agentcore:<region>:<accountId>:token-vault/default",
        "arn:aws:bedrock-agentcore:<region>:<accountId>:workload-identity-directory/default",
        "arn:aws:bedrock-agentcore:<region>:<accountId>:workload-identity-directory/default/workload-identity/harness_<agentName>-*"
      ]
    },
    {
      "Sid": "AgentCoreApiKeyTokenVaultPerKey",
      "Effect": "Allow",
      "Action": "bedrock-agentcore:GetResourceApiKey",
      "Resource": "arn:aws:bedrock-agentcore:<region>:<accountId>:token-vault/default/apikeycredentialprovider/<apiKeyName>"
    },
    {
      "Sid": "AgentCoreApiKeySecret",
      "Effect": "Allow",
      "Action": "secretsmanager:GetSecretValue",
      "Resource": "arn:aws:secretsmanager:<region>:<accountId>:secret:bedrock-agentcore-identity!default/apikey/<apiKeyName>-*"
    }
  ]
}

Penyedia kredensi OAuth2 (Gateway) OAuth-protected

Tambahkan kebijakan ini saat harness Anda menggunakan penyedia kredensi OAuth2 untuk alat gateway. OAuth-protected

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AgentCoreOAuth2TokenVaultDefault",
      "Effect": "Allow",
      "Action": "bedrock-agentcore:GetResourceOauth2Token",
      "Resource": [
        "arn:aws:bedrock-agentcore:<region>:<accountId>:token-vault/default",
        "arn:aws:bedrock-agentcore:<region>:<accountId>:workload-identity-directory/default",
        "arn:aws:bedrock-agentcore:<region>:<accountId>:workload-identity-directory/default/workload-identity/harness_<agentName>-*"
      ]
    },
    {
      "Sid": "AgentCoreOAuth2TokenVaultPerProvider",
      "Effect": "Allow",
      "Action": "bedrock-agentcore:GetResourceOauth2Token",
      "Resource": "arn:aws:bedrock-agentcore:<region>:<accountId>:token-vault/default/oauth2credentialprovider/<oauthProviderName>"
    },
    {
      "Sid": "AgentCoreOAuth2Secret",
      "Effect": "Allow",
      "Action": "secretsmanager:GetSecretValue",
      "Resource": "arn:aws:secretsmanager:<region>:<accountId>:secret:bedrock-agentcore-identity!default/oauth2/<oauthProviderName>-*"
    }
  ]
}

Referensi placeholder

Ganti placeholder berikut dalam kebijakan di atas dengan nilai khusus untuk lingkungan Anda:

Topik terkait