Kanji
・Ingeniero Cloud / Freelance ・Nacido en 1993 ・De Ehime / Residente en Shibuya, Tokio ・5 años de experiencia en AWS Detalles del perfil
Índice
bedrock:GuardrailIdentifier
Cuando comencé a diseñar herramientas internas de IA empresarial y sistemas multi-agente en Amazon Bedrock, mi prioridad principal era la seguridad y el cumplimiento normativo.
El manejo de documentos corporativos e información de clientes exige controles estrictos: enmascarar información de identificación personal (PII como números de identificación fiscal, tarjetas de crédito y teléfonos), bloquear menciones a competidores y neutralizar ataques de inyección de prompts (jailbreaks). Amazon Bedrock ofrece una excelente función administrada llamada “Amazon Bedrock Guardrails”, que permite definir políticas de filtrado avanzadas desde la consola o mediante IaC.
Configuré nuestro guardrail corporativo, documenté los parámetros estándar en nuestra wiki interna y pedí a todos los equipos de ingeniería: “Asegúrense de incluir siempre este Guardrail ID y su versión en cada llamada de inferencia a Bedrock” .
Pocas semanas después, al auditar eventos de AWS CloudTrail y registros de CloudWatch, descubrí algo alarmante.
Varios scripts automatizados en Python y un entorno de ejecución de agentes de IA de código abierto (integrado mediante servidores MCP) desplegados por equipos internos estaban invocando modelos fundacionales (Claude 3.5 Sonnet / Llama 3) miles de veces directamente sin especificar ningún identificador de guardrail .
# Código de invocación sin protección detectado en nuestro entorno import boto3 bedrock = boto3.client('bedrock-runtime', region_name='us-east-1') # El desarrollador omitió guardrailIdentifier, ¡pero la llamada tuvo éxito porque IAM permitía InvokeModel! response = bedrock.invoke_model( modelId='anthropic.claude-3-5-sonnet-20241022-v2:0', body=b'{"prompt": "...", "max_tokens": 1000}' )
La causa raíz era evidente: los desarrolladores olvidaban pasar el parámetro en wrappers de boto3 o LangChain, o las librerías de agentes de terceros carecían de soporte nativo para los argumentos de Bedrock Guardrails.
Confiar en la “buena voluntad” del código cliente conduce inevitablemente a errores humanos, Shadow AI y posibles evasiones. Los guardrails no deben sugerirse en la capa cliente; deben imponerse obligatoriamente en la frontera de control de acceso de IAM.
AWS resuelve este desafío arquitectónico mediante IAM Policy-Based Enforcement for Amazon Bedrock Guardrails .
▲ Arquitectura general: El motor de evaluación de políticas IAM exige la configuración de Guardrail en cada solicitud de inferencia, bloqueando al instante las llamadas desprotegidas
El pilar de esta arquitectura es la clave de condición de IAM para Amazon Bedrock: bedrock:GuardrailIdentifier .
Históricamente, las políticas IAM para acciones de inferencia ( bedrock:InvokeModel , bedrock:InvokeModelWithResponseStream , bedrock:Converse , bedrock:ConverseStream ) solo determinaban si un rol tenía permiso para invocar un modelo.
bedrock:InvokeModel
bedrock:InvokeModelWithResponseStream
bedrock:Converse
bedrock:ConverseStream
Con bedrock:GuardrailIdentifier , usted puede exigir que toda solicitud de inferencia incluya un ARN de Guardrail específico (incluyendo su versión), o de lo contrario la llamada es rechazada en la capa IAM .
PutEnforcedGuardrailConfiguration
La ventaja financiera y operativa es decisiva: las solicitudes sin guardrail se cancelan en el motor IAM con un 403 Forbidden antes de llegar al modelo fundacional , generando cero cargos por tokens de inferencia.
A continuación se muestra la configuración exacta implementada en nuestros entornos.
El patrón más robusto combina una declaración Allow para la invocación del modelo con una declaración Deny explícita cuando falta el guardrail corporativo:
Allow
Deny
{ "Version": "2012-10-17", "Statement": [ { "Sid": "AllowBedrockInvocation", "Effect": "Allow", "Action": [ "bedrock:InvokeModel", "bedrock:InvokeModelWithResponseStream", "bedrock:Converse", "bedrock:ConverseStream" ], "Resource": "arn:aws:bedrock:us-east-1::foundation-model/*" }, { "Sid": "AllowGuardrailApplication", "Effect": "Allow", "Action": "bedrock:ApplyGuardrail", "Resource": "arn:aws:bedrock:us-east-1:111122223333:guardrail/abc123def456" }, { "Sid": "EnforceMandatoryCorporateGuardrail", "Effect": "Deny", "Action": [ "bedrock:InvokeModel", "bedrock:InvokeModelWithResponseStream", "bedrock:Converse", "bedrock:ConverseStream" ], "Resource": "arn:aws:bedrock:us-east-1::foundation-model/*", "Condition": { "StringNotEquals": { "bedrock:GuardrailIdentifier": "arn:aws:bedrock:us-east-1:111122223333:guardrail/abc123def456:1" } } } ] }
bedrock:ApplyGuardrail
InvokeModel
:1
:2
:DRAFT
StringNotEquals
guardrailIdentifier
En entornos multi-cuenta, al utilizar comodines ( * ) en patrones de ARN dentro de una SCP, utilice siempre ArnNotLike (o StringNotLike ) sin combinarlo con "Null": {"bedrock:GuardrailIdentifier": "true"} en el mismo bloque:
*
ArnNotLike
StringNotLike
"Null": {"bedrock:GuardrailIdentifier": "true"}
{ "Version": "2012-10-17", "Statement": [ { "Sid": "EnforceGuardrailAcrossAllAccounts", "Effect": "Deny", "Action": [ "bedrock:InvokeModel", "bedrock:InvokeModelWithResponseStream", "bedrock:Converse", "bedrock:ConverseStream" ], "Resource": "arn:aws:bedrock:*::foundation-model/*", "Condition": { "ArnNotLike": { "bedrock:GuardrailIdentifier": "arn:aws:bedrock:*:*:guardrail/corp-standard-*:*" } } } ] }
Además de la validación fail-closed con bedrock:GuardrailIdentifier , AWS ofrece Amazon Bedrock Policies en AWS Organizations y la API PutEnforcedGuardrailConfiguration ( aws bedrock put-enforced-guardrail-configuration ) , que adjuntan automáticamente guardrails base incluso cuando el cliente omite el parámetro.
aws bedrock put-enforced-guardrail-configuration
A continuación se muestran los registros reales capturados mediante AWS CLI y boto3.
▲ Configuración del Guardrail corporativo con filtros de enmascaramiento PII y política IAM obligatoria
# Invocando Claude 3.5 Sonnet sin parámetro de guardrail aws bedrock-runtime invoke-model --model-id "anthropic.claude-3-5-sonnet-20241022-v2:0" --body '{"anthropic_version":"bedrock-2023-05-31","max_tokens":200,"messages":[{"role":"user","content":"Explica nuestras guías internas de despliegue"}]}' --cli-binary-format raw-in-base64-out response.json
Salida (Registro de error):
An error occurred (AccessDeniedException) when calling the InvokeModel operation: User: arn:aws:iam::111122223333:user/test-developer is not authorized to perform: bedrock:InvokeModel on resource: arn:aws:bedrock:us-east-1::foundation-model/anthropic.claude-3-5-sonnet-20241022-v2:0 with an explicit deny in a service control policy or identity-based policy
# Invocando con Guardrail ID válido y Versión 1 aws bedrock-runtime invoke-model --model-id "anthropic.claude-3-5-sonnet-20241022-v2:0" --guardrail-identifier "abc123def456" --guardrail-version "1" --body '{"anthropic_version":"bedrock-2023-05-31","max_tokens":200,"messages":[{"role":"user","content":"El teléfono del cliente John Doe es 090-1234-5678. Redacta una nota de contacto."}]}' --cli-binary-format raw-in-base64-out response.json cat response.json | jq .
▲ Registros de verificación CLI: Las llamadas sin guardrail son bloqueadas por IAM, mientras que las llamadas protegidas enmascaran entidades PII con éxito
Salida (Respuesta exitosa):
{ "content": [ { "text": "Nota interna creada. [Nota de Contacto] Cliente: John Doe Contacto: [PHONE_NUMBER] ...", "type": "text" } ], "amazon-bedrock-guardrailAction": "INTERVENED", "amazon-bedrock-guardrailIntervention": { "sensitiveInformationPolicy": { "piiEntities": [ { "type": "PHONE", "action": "ANONYMIZED" } ] } } }
La penalización de latencia es mínima —entre 43 y 57 ms —, prácticamente imperceptible tanto en interfaces conversacionales como en bucles de agentes autónomos.
["...:1", "...:2"]
Imponer Amazon Bedrock Guardrails en la frontera IAM con bedrock:GuardrailIdentifier traslada los principios clásicos de defensa en profundidad a la IA generativa, erradicando de raíz el riesgo de invocaciones desprotegidas.
Real-time AI quant analysis of corporate earnings reports.
Entrene habilidades sociales con llamadas simuladas realistas, retroalimentación en 5 ejes, academia interactiva y fotos de perfil con IA.
Fotografíe recibos para un desglose instantáneo con IA. Conexión directa con LINE para liquidar gastos compartidos sin fricción.
Personajes de IA (Adivina, Mayordomo, Barman) moderan dinámicas y retos en tiempo real para animar cualquier reunión.
人工甘味料や添加物のNG除外と有効成分あたりの実質単価比較データベース。