Las Restricciones de Tenant están disponibles para miembros de planes Enterprise y organizaciones Console.
Las Restricciones de Tenant permiten a los administradores de TI en planes Enterprise aplicar control de acceso a nivel de red para Claude. Las Restricciones de Tenant también se aplican a artefactos, incluidos Claude Docs. Esta función garantiza que los usuarios en redes corporativas solo puedan acceder a cuentas organizacionales aprobadas, evitando el uso no autorizado de cuentas personales.
Cómo funciona
Cuando está habilitado, tu proxy de red inyecta un encabezado HTTP en las solicitudes a Claude. Anthropic valida este encabezado y bloquea el acceso de cualquier organización que no esté en la lista permitida.
Métodos de autenticación compatibles:
Acceso web (claude.ai)
Acceso de escritorio / Aplicación
Autenticación con clave API
Autenticación con token OAuth
Formato de encabezado
anthropic-allowed-org-ids: <org-uuid-1>,<org-uuid-2>,...
Lista delimitada por comas de UUID de organizaciones
Sin espacios entre valores
Ejemplo:
anthropic-allowed-org-ids: 550e8400-e29b-41d4-a716-446655440000,6ba7b810-
9dad-11d1-80b4-00c04fd430c8
Dividir listas permitidas grandes en varios encabezados
Si tu lista permitida es demasiado larga para una sola línea de encabezado en tu plataforma proxy, divídela en encabezados de continuación numerados. Añade ;n=K al encabezado base para declarar el número total de líneas de encabezado, luego agrega los UUID restantes en los encabezados anthropic-allowed-org-ids1 a través de anthropic-allowed-org-ids{K-1}.
anthropic-allowed-org-ids: <org-uuid>,<org-uuid>,...;n=K
anthropic-allowed-org-ids1: <org-uuid>,<org-uuid>,...
...
anthropic-allowed-org-ids{K-1}: <org-uuid>,<org-uuid>,...
Máximo de 10 líneas de encabezado (
K≤ 10)Máximo de 500 UUID de organizaciones en total en todas las líneas
Tu proxy debe enviar cada espacio declarado. Si estableces
;n=3, los tres encabezados deben estar presentes en la solicitud.Configura tu proxy para sobrescribir estos encabezados en cada solicitud en lugar de agregarlos solo si están ausentes.
Pasos de configuración
1. Encuentra tu UUID de organización
Los miembros de planes Enterprise pueden encontrar esto en dos lugares diferentes:
Navega a Configuración > Cuenta y encuentra ID de Organización.
Navega a Configuración de organización > Organización y desplázate hacia abajo hasta el final de la página para localizar ID de Organización.
Los miembros de organizaciones Console pueden encontrar esto en Configuración > Organización.
2. Configura tu proxy de red
Configura tu proxy para inyectar el encabezado para el tráfico de Claude:
Rule: Claude Tenant Restriction
Application: claude.ai, api.anthropic.com, claude.com, anthropic.com
Action: Inject Header
Header Name: anthropic-allowed-org-ids
Header Value:
TLS Inspection: Required
3. Prueba tu configuración
Desde la red restringida, prueba con la clave API de tu organización:
curl https://api.anthropic.com/v1/messages \
-H "x-api-key: $CLAUDE_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{"model":"claude-sonnet-4-6","max_tokens":1024,"messages":
[{"role":"user","content":"Hello"}]}'
Respuestas de error
Acceso bloqueado
Cuando la organización de un usuario no está en la lista permitida, recibe un error 403:
{
"type": "error",
"error": {
"type": "permission_error",
"message": "Access restricted by network policy. Contact IT Administrator.",
"error_code": "tenant_restriction_violation"
}
}
Errores de configuración de encabezado
Si tu proxy envía los encabezados incorrectamente, las solicitudes fallan con un estado 400 y uno de estos mensajes:
Múltiples encabezados
anthropic-allowed-org-ids: Un nombre de encabezado apareció más de una vez en la misma solicitud. Configura tu proxy para sobrescribir cada encabezado en lugar de agregar un duplicado.Encabezados
anthropic-allowed-org-idsmal formados: El valor;n=Kes inválido, falta una ranura de continuación declarada o hay una extra, o la lista permitida total excede 500 UUID.
Plataformas proxy compatibles
Cato Networks (política de Restricción de Tenant)
Cloudflare Zero Trust / Gateway (política HTTP, agregar encabezados de solicitud personalizados)
Island (inyección de encabezado en Island Enterprise Browser, Island Extension y Secure Web Gateway)
Netskope (reglas de Inserción de Encabezado)
Palo Alto Prisma Access (Gestión de Aplicaciones SaaS)
Zscaler ZIA (políticas de Control de Aplicaciones en la Nube)
Proxies HTTPS genéricos con capacidad de inyección de encabezado
Casos de uso
Escenario | Valor de Encabezado |
Organización Única |
|
Múltiples Organizaciones (Socios) |
|
Beneficios de seguridad
Prevención de Pérdida de Datos: Bloquea el uso de cuentas personales desde redes corporativas.
Cumplimiento: Aplicar políticas de residencia de datos y acceso.
Control de TI en la Sombra: Prevenir el uso no autorizado de Claude.
Registro de Auditoría: Visibilidad completa de los intentos de acceso.
Compatibilidad hacia atrás
Sin impacto en redes sin restricciones de tenant configuradas.
La autenticación estándar continúa para redes no administradas.
La autenticación con clave API existente permanece sin cambios.
