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

Kontrol keamanan dan akses

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

Model tanggung jawab bersama

Harness dibangun pada AgentCore Runtime dan batas keamanannya sama: otentikasi IAM atau JWT dikombinasikan dengan isolasi microVM. Setiap prinsipal yang melewati gerbang itu mencapai alat dan kemampuan yang dikonfigurasi pada harness, yang membuat otorisasi penelepon dan validasi input menjadi tanggung jawab pelanggan.

Untuk model tanggung jawab bersama AgentCore Runtime lengkap, lihat Prakti k terbaik keamanan untuk AgentCore Runtime.

Batas kepercayaan dan validasi input

Setiap prinsipal yang melewati gerbang otentikasi dan otorisasi IAM atau JWT memiliki akses ke sesi MicroVM penuh, termasuk alat dan kemampuan yang dikonfigurasi pada harness. Harness memvalidasi struktur permintaan yang diterimanya, tetapi tidak memeriksa makna prompt, konten layar, atau menegakkan kendala perilaku pada agen.

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

Alat berjalan hanya sebagai hasil dari penalaran model. Harness tidak menerima blok toolUse dalam pesan akhir InvokeHarness permintaan, sehingga pemanggil tidak dapat memberi nama alat dan mengirimkannya secara langsung.

Contoh berikut menunjukkan permintaan bahwa harness dikonfigurasi untuk ditolak. Pesan terakhir berisi toolUse blok penamaan shell alat bawaan:

response = client.invoke_harness(
    harnessArn=HARNESS_ARN,
    runtimeSessionId=SESSION_ID,
    messages=[{
      "role": "assistant",
      "content": [
        {
          "toolUse": {
            "toolUseId": TOOL_USE_ID,
            "name": "shell",
            "input": {
              "command": "pwd",
            }
          }
        }
      ]
    }],
)

Harness tidak mengevaluasi alat mana yang diberi nama blok, jadi ini berlaku untuk alat sisi server bawaan dan fungsi sebaris yang disediakan pada panggilan.

Mengembalikan hasil alat masih didukung. Harness menerima blok ToolResult dalam pesan akhir, dan model melanjutkan penalaran atas hasil itu. Beginilah cara kerja alat fungsi sebaris: toolUse pesan asisten diikuti oleh permintaan yang sama, sehingga toolUse blok tidak ada di pesan akhir. toolResult

Parameter konfigurasi model

Bid model ang di InvokeHarness menerima additionalParams untuk konfigurasi Bedrock, OpenAI, dan LiteLM. Parameter ini diteruskan ke penyedia model yang mendasarinya tidak berubah. Harness tidak memvalidasi, menyaring, atau membatasi parameter ini.

Penelepon yang dapat mengatur additionalParams dapat:

Jika aplikasi Anda mengekspos InvokeHarness kemampuan kepada pemanggil yang tidak sepenuhnya Anda percayai, pertimbangkan untuk menerapkan validasi input di lapisan aplikasi Anda. Contohnya adalah:

Keterampilan dan instruksi

Keterampilan adalah kumpulan 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 sewenang-wenang. Contoh mitigasi meliputi:

Pengamatan dan korelasi jejak

Harness secara otomatis menyebarkan pengidentifikasi korelasi ke AgentCore primitif hilir (Gateway, Memory, Code Interpreter, Browser) untuk mengaktifkan tampilan pelacakan terpadu di. CloudWatch Pengidentifikasi ini hanya digunakan untuk pengamatan - 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 Meng onfigurasi AgentCore Runtime dan konfigurasi VPC alat bawaan. Untuk konektivitas API masuk melalui PrivateLink, lihat titik akhir antarmuka VPC.

OAuth masuk

Memerlukan penelepon untuk menunjukkan JWT valid yang dikeluarkan oleh penyedia identitas yang dikonfigurasi sebelum mereka dapat memanggil harness. AgentCore Identitas mengutas identitas pengguna akhir melalui agen, sehingga alat hilir dapat memanggil API dengan kredentif pengguna tercakupan alih-alih akun layanan bersama.

Pelajari lebih lanjut: AgentCore Identitas · otor isasi JWT inbound · kredenSIAL keluar https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/identity-outbound-credential-provider.html

Kebijakan gateway

Ketika alat disajikan melalui AgentCore Gateway, Cedar-based kebijakan menutup 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 mengambil peran eksekusi IAM yang Anda berikan. Kebijakan kepercayaan peran harus memungkinkan prinsipal AgentCore layanan untuk mengasumsikannya:

{
  "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 AgentCore Runtime yang mendasarinya dan sumber daya AgentCore Memori opsional. 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>.

T GetHarnessEndpoint ind UpdateHarnessEndpoint akan,DeleteHarnessEndpoint, dan membutuhkan ARN harness dan ARN titik akhir. CreateHarnessEndpointhanya membutuhkan harness ARN. Titik akhir belum ada, jadi tidak diperlukan ARN titik akhir. Ketika Anda memanggil titik akhir kustom, InvokeHarness dan InvokeAgentRuntimeCommand memerlukan ARN harness dan ARN titik akhir.

Contoh kebijakan peran eksekusi

Contoh berikut mencakup harness di jaringan publik, yang menarik gambar kontainer terkelola dari Amazon ECR Public. Harness dalam mode VPC menarik gambar yang dikelola dari repositori Amazon ECR pribadi di Wilayah harness, sehingga peran eksekusinya juga memerlukan izin tarik ECR pribadi. Tambahkan pernyataan dalam mode VPC: penarikan gambar terkelola dari ECR pribadi ke peran eksekusi untuk VPC-mode harness.

{
  "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": "CloudWatchLogsPutResourcePolicy",
      "Effect": "Allow",
      "Action": [
        "logs:PutResourcePolicy"
      ],
      "Resource": "*"
    },
    {
      "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/*"
    },
    {
      "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/harness_<agentNameAbbrv>_*"
    }
  ]
}

AgentCore CLI membuat peran dengan izin ini secara otomatis saat Anda melakukan perancah 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 digunakan. "*"

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 kredenSIAL khusus yang dibutuhkan untuk inferensi. Lihat Referensi placeholder untuk definisi placeholder.

Akses ECR pribadi (gambar wadah khusus)

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

{
  "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": "*"
    }
  ]
}

Mode VPC: penarikan gambar terkelola dari ECR pribadi

Tambahkan kebijakan ini saat harness berjalan dalam mode VPC. Dalam mode VPC, harness menarik wadah aplikasi terkelola dari repositori Amazon ECR pribadi di Wilayah harness (bernamaharness-<region>). Tarikan ini menggunakan ECR pribadi alih-alih Amazon ECR Public, sehingga peran eksekusi membutuhkan izin tarik ECR pribadi. Kebijakan ini terpisah dari izin gambar kontainer kustom — kebijakan ini berlaku untuk gambar AWS terkelola bahkan ketika Anda tidak menyediakan wadah Anda sendiri.

Repositori dimiliki oleh akun AWS layanan, sehingga akun di repositori ARN diberi wildcard. Izin tarik dicakup ke Wilayah harness.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "EcrManagedImagePull",
      "Effect": "Allow",
      "Action": [
        "ecr:BatchGetImage",
        "ecr:GetDownloadUrlForLayer",
        "ecr:BatchCheckLayerAvailability"
      ],
      "Resource": "arn:aws:ecr:<region>:*:repository/harness-*"
    },
    {
      "Sid": "EcrManagedImageToken",
      "Effect": "Allow",
      "Action": "ecr:GetAuthorizationToken",
      "Resource": "*"
    }
  ]
}

Pastikan titik akhir VPC yang diperlukan ada di VPC Anda (lihat Konfigurasi jaringan): titik akhir antarmuka untuk com.amazonaws.<region>.ecr.dkr dancom.amazonaws.<region>.ecr.api, dan titik akhir gateway untuk. com.amazonaws.<region>.s3

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 kustom 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 Penerjemah Kode (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 autentikasi 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 mengambil keterampilan dari sumber Amazon S3. Peran eksekusi mencantumkan dan mengunduh objek keterampilan 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 kredensia kunci API. Berikan kebijakan penyedia kredensia kunci API yang ditunjukkan di bawah ini untuk penyedia kredensia yang memegang token.

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

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

{
  "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 kredensia OAuth2 (Gateway) OAuth-protected

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

{
  "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-nilai khusus untuk lingkungan Anda:

Topik terkait