Seguridad y sus datos
También en: English · Português · Français · Deutsch
Este artículo está escrito para quienes revisan el software antes de que un contact center pueda usarlo: los equipos de seguridad, privacidad y compras. Describe de qué está hecho Arena, dónde viven los datos, quién puede llegar a ellos y cómo eliminarlos. Todo lo que aquí se dice puede verificarse en la plantilla de CloudFormation, que se publica en modo de solo lectura en la ubicación pública de versiones enlazada desde cada entrada de las notas de versión.
La versión corta
- Arena es un stack de CloudFormation que funciona dentro de su propia cuenta de AWS, en la región que usted elija. No existe ningún servicio de Arena fuera de su cuenta que guarde sus datos.
- EKPK, la empresa que hace Arena, no puede acceder a sus datos. El stack no concede a EKPK ningún rol, ninguna clave ni ningún endpoint.
- Lo que sale de su cuenta: un número al día hacia AWS Marketplace para la facturación (el recuento de agentes con actividad puntuada) y, salvo que configure
Telemetry=disabled, una comprobación de versión una vez al día desde la consola del supervisor, que lleva un identificador de instalación anónimo, la versión y la región y, solo si indica un socio de implementación con PartnerCode, ese código y una etiqueta que usted elige. Nada más, y nunca un nombre, un identificador o una puntuación. La tabla completa está más abajo.
- Arena lee eventos de agentes y puntuaciones, nunca grabaciones, transcripciones ni el contenido de las conversaciones con clientes.
- Elimine el stack y todo desaparece.
Arquitectura
El stack crea estos recursos. Cada uno pertenece a su cuenta y se le factura a las tarifas normales de AWS.
| Recurso |
Finalidad |
Notas |
| Flujo de datos de Kinesis |
Recibe los eventos de agentes de Amazon Connect |
Cifrado con una clave de KMS administrada por AWS; retención de 24 horas; un shard por defecto |
| Funciones Lambda |
Ingesta, API, evaluaciones, reglas de evaluación, sentimiento, adherencia, acuses de recibo, días libres, carga histórica, exportación, medición de uso, rachas, resumen, diagnóstico (opcional), despliegue del sitio |
Node.js 22 sobre Graviton; cada una con su propio rol de IAM (ver más abajo) |
| Tabla de DynamoDB |
Todos los datos de Arena, en una sola tabla |
Cifrada en reposo; capacidad bajo demanda; recuperación a un momento dado, 35 días |
| API HTTP (API Gateway) |
La API a la que llaman las páginas |
Todas las rutas exigen un JWT salvo tres que llevan su propia clave: enlaces de wallboard, claves de datos y claves de ingesta (ver Quién puede ver qué); con límite de peticiones; solo TLS |
| Distribución de CloudFront y bucket privado de S3 |
Aloja el panel del agente, la consola, el wallboard y el informe |
El bucket bloquea todo acceso público; CloudFront llega a él mediante una identidad de acceso de origen; solo TLS |
| Grupo de usuarios de Cognito |
Inicio de sesión de agentes y supervisores |
Opcional: puede usar su propio proveedor de identidad |
| Temas de SNS |
Alarmas operativas; resumen opcional por correo |
Las suscripciones se confirman por correo |
| Alarmas y registros de CloudWatch |
Errores de ingesta, retraso del flujo, errores de la API, informe de uso fallido |
Los registros permanecen en su cuenta |
| Programaciones de EventBridge |
Los trabajos horarios y nocturnos |
|
Las funciones Lambda llaman a servicios de AWS en su cuenta y, para Slack o Microsoft Teams, solo a las URL de webhook que introduzcan sus supervisores. Tres caminos salen al exterior, todos recogidos en la tabla de salidas de este artículo: la facturación hacia AWS Marketplace, la comprobación diaria de versión hacia EKPK (se desactiva con Telemetry=disabled) y el reenvío de alarmas a EKPK solo si configura Diagnostics=enabled. En la instalación y en cada actualización, la función de despliegue del sitio descarga el archivo de páginas de la versión desde la ubicación pública de versiones de EKPK.
Qué almacena Arena
Del flujo de eventos de agentes de Connect: ARN del agente, nombre de usuario, nombre y apellido, perfil de enrutamiento (que se muestra como el equipo), cambios de estado y, por cada contacto gestionado, el ID del contacto, la cola, el canal y el tiempo de gestión. Los ID de contacto se conservan 14 días para poder asociar al agente los análisis posteriores.
Si activa las fuentes opcionales: notas de evaluación y el título de la pregunta de fallo automático, de los archivos de evaluación de Contact Lens; la puntuación global de sentimiento del cliente, de los archivos de análisis de Contact Lens; notas de encuesta desde un atributo de contacto; porcentajes de adherencia desde las propias métricas de Connect.
Creado dentro de Arena: puntos, rachas, insignias, retos y sus clasificaciones, solicitudes y aprobaciones de recompensas, notas de kudos escritas por los agentes (140 caracteres), planes de coaching, incluida la nota privada del supervisor, ajustes de notificaciones y las preferencias de cada agente.
Lo que Arena nunca lee: grabaciones de llamadas o de pantalla, transcripciones, texto de chats, nombres de clientes, números de teléfono ni ningún dato de clientes. De los archivos de Contact Lens se leen los campos de puntuación y nada más; los archivos de análisis no se conservan.
Qué sale de su cuenta
| Dato |
A dónde va |
Por qué |
| Recuento de agentes con actividad puntuada, una vez cada noche |
AWS Marketplace Metering Service |
Facturación. Sin identificadores. Se restan primero los 10 primeros agentes de cada día, o los 25 primeros durante la prueba de 30 días. |
| Avisos de kudos, recompensas y retos, y el resumen diario |
Los webhooks de Slack o Teams que usted configuró |
Solo si un supervisor los activó, y solo a la URL que introdujo |
| Resumen diario por correo |
La dirección que introdujo un supervisor, a través de su propio tema de SNS |
Solo si está activado |
Comprobación de versión, una vez al día: un identificador de instalación anónimo (un hash del ID del stack), la versión de Arena y la región de AWS. Si configura PartnerCode en el stack, también ese código y la etiqueta opcional PartnerClientLabel |
El endpoint de telemetría de EKPK, desde la consola del supervisor |
Para que EKPK sepa cuántas instalaciones usan cada versión y la consola pueda avisar cuando existe una más nueva. Telemetry=disabled en el stack la desactiva; la consola lee entonces arenaforconnect.com directamente. Con un código de socio configurado, ese socio ve en su página de flota el identificador, la etiqueta, la versión, la región, la primera y la última comprobación de esta instalación y las alarmas que usted comparta con Diagnostics; nada más. Vacíe PartnerCode para dejar de compartirlo. |
| Cambios de estado de las alarmas: nombre de la alarma, estado, motivo, versión, región, identificador de instalación |
El endpoint de telemetría de EKPK |
Solo con Diagnostics=enabled en el stack (desactivado por defecto), para que soporte vea pronto un stack que falla. Nunca datos de agentes, contactos, equipos o cuentas. |
| Solicitud de borrador de coaching: el motivo del plan y las medias del agente en los últimos 28 días (evaluación, sentimiento, encuesta, adherencia, contactos, tiempo de gestión, suspensos automáticos). Nunca un nombre, un identificador, un equipo ni un contacto |
Amazon Bedrock, llamado desde su propia cuenta de AWS |
Solo con CoachingAssistant=enabled (desactivado por defecto) y solo cuando un supervisor pulsa Redactar con IA. Permanece dentro de AWS bajo su cuenta. El modelo por defecto es un perfil de inferencia global, por lo que AWS puede procesar la solicitud en otra región; configure CoachingModelId con un perfil geográfico para mantenerla en una sola geografía. AWS indica que Bedrock no almacena las solicitudes ni las usa para entrenar modelos. |
| Solicitud de borrador de cuestionario: el texto de política o de producto que un supervisor pega para que se redacten preguntas a partir de él, hasta 6.000 caracteres, enmascarado como el resto del texto libre |
Amazon Bedrock, llamado desde su propia cuenta de AWS |
Solo con CoachingAssistant=enabled y solo cuando un supervisor pulsa Redactar preguntas con IA. Se aplican el mismo modelo y la misma nota sobre regiones que al borrador de coaching. No pegue texto que no enviaría a ese modelo. |
| Pedido de tarjeta regalo: el valor, la moneda, su campaña, su fuente de fondos y una referencia creada a partir del id de la recompensa. Nunca el nombre, el correo, el identificador ni el equipo de un agente |
Tremendous, con su propia clave de API de Tremendous |
Solo con RewardDelivery=tremendous (desactivado por defecto) y solo cuando un supervisor aprueba una recompensa que tiene valor de tarjeta regalo. La clave se lee de un parámetro SecureString en su cuenta. El enlace de canje que devuelve Tremendous se guarda en su tabla y se muestra solo al agente al que pertenece. |
La página de registro que usó al suscribirse funciona en la cuenta de EKPK. Recibe de Marketplace su ID de cuenta de AWS y el identificador de la suscripción, los conserva para que el enlace de lanzamiento siga siendo válido, y nada más. Nunca ve nada de dentro de su stack. El enlace de configuración que le entrega Marketplace abre esa página una sola vez; una copia del enlace encontrada después en un registro o en el historial del navegador no muestra nada.
Quién puede ver qué
- El inicio de sesión es obligatorio en todas las páginas y en todas las rutas de la API, con tres excepciones deliberadas que llevan su propia clave en lugar del token de una persona: los enlaces de wallboard, las claves de datos y las claves de ingesta, descritas más abajo. El inicio de sesión se hace con su grupo de usuarios de Cognito o con su propio proveedor de identidad (OIDC); la API valida el token en cada llamada. Los usuarios solo pueden cambiar su propio correo: los atributos que dicen quién es un agente y a qué equipo pertenece los fijan los administradores y el usuario no puede editarlos.
- Los supervisores (miembros del grupo de supervisores) pueden leer y actuar sobre todos los equipos.
- Los agentes ven la tabla de clasificación, los retos y los kudos de su propio equipo, sus propios puntos y saldo, y la acción acordada de sus propios planes de coaching, nunca la nota privada de un supervisor ni la actividad de otro agente. Un agente puede ocultarse de las clasificaciones y wallboards de sus compañeros; los supervisores lo siguen viendo.
- Las claves de datos (para almacenes de datos y herramientas de BI) leen las filas diarias por agente de todos los equipos, con nombres y ARN, hasta dos años atrás; las claves de ingesta permiten que otra plataforma escriba eventos puntuados para cualquier agente. Ambas las generan los supervisores en el diálogo Datos de la consola, se muestran una sola vez y pueden revocarse en cualquier momento; trátelas como secretos de integración.
- Los wallboards usan una clave de solo lectura que un supervisor genera para un equipo, válida hasta un año (90 días por defecto) y revocable en cualquier momento. Los nombres en los wallboards pueden acortarse a nombre e inicial, o solo a iniciales, con el ajuste
WallboardNames, ya que cualquiera que pase junto a una pantalla puede leerla.
- Los operadores de su cuenta de AWS pueden leer la tabla directamente, como cualquier otro recurso de la cuenta. Use los controles de acceso habituales de su cuenta.
Mínimo privilegio dentro del stack
Cada función tiene su propio rol, limitado a lo que hace. En resumen:
| Función |
Puede |
| Ingesta |
Leer el flujo de Kinesis; leer y escribir la tabla |
| API |
Leer y escribir la tabla; publicar en el tema del resumen; gestionar usuarios en el grupo de usuarios del propio stack (invitar, editar rol y equipo, restablecer contraseña, eliminar); escribir el logotipo de la empresa en el bucket del sitio; invocar un modelo de Amazon Bedrock (solo si el asistente de coaching está activado); leer el único parámetro de Systems Manager que contiene su clave de Tremendous (solo si la entrega de recompensas está activada) |
| Evaluaciones, sentimiento |
Leer el único bucket y prefijo que usted indicó; leer y escribir la tabla |
| Acuses de recibo, reglas de evaluación |
connect:DescribeContactEvaluation (las reglas de evaluación también ListContactEvaluations) en sus instancias; leer y escribir la tabla |
| Días libres |
Leer y escribir la tabla |
| Exportación |
Leer la tabla; escribir en el bucket de exportación |
| Diagnóstico (solo si está activado) |
Leer el tema de alarmas; enviar a EKPK el nombre de la alarma, el estado, el motivo, la versión y la región |
| Conector de Genesys Cloud (solo si está activado) |
Recibir eventos de conversación del bus de eventos que usted indique; leer y escribir la tabla. No llama a nada fuera de su cuenta ni guarda credenciales de Genesys |
| Adherencia, carga histórica |
connect:GetMetricDataV2 (la carga histórica también ListUsers, DescribeUser, DescribeRoutingProfile); leer y escribir la tabla |
| Medición de uso |
aws-marketplace:BatchMeterUsage; leer y escribir la tabla |
| Rachas, resumen |
Leer y escribir la tabla; el resumen también publica en el tema del resumen |
| Despliegue del sitio |
Escribir en el bucket del sitio; invalidar la distribución; fijar las URL de retorno del cliente del grupo de usuarios |
Consulta de la instancia (solo cuando ConnectInstanceArn está definido y ConnectInstanceUrl no) |
connect:DescribeInstance en su instancia, y ds:DescribeDirectories, de solo lectura, del que depende esa llamada, para conocer la dirección de la instancia al crear y actualizar el stack |
Ninguna función tiene permiso para crear recursos, cambiar IAM ni leer nada en Connect más allá de las métricas y los registros de evaluación nombrados arriba.
Protecciones en el navegador
- Marcos. Las páginas solo pueden mostrarse dentro de un marco de su propia instancia de Connect: la dirección indicada en
ConnectInstanceUrl, o la que el stack lee a partir de ConnectInstanceArn. No hay comodín, así que otra instancia de Connect o cualquier otro sitio no puede incrustar sus páginas. La salida FramedBy del stack muestra quién está permitido.
- Llamadas a la API desde otros orígenes. Por defecto no se permite ninguna. Las páginas llegan a la API a través de la propia dirección del sitio, de modo que la API no concede acceso a ningún otro sitio web. Puede permitirse un origen concreto con
AllowedOrigin; no se acepta un comodín.
- Política de seguridad de contenido. Los scripts, los estilos y los datos solo se cargan desde el propio sitio y desde los endpoints de AWS nombrados. HTTPS se impone con HSTS y la detección automática del tipo de contenido está desactivada.
Cifrado
En tránsito: todos los caminos usan TLS, incluidos CloudFront hacia el navegador, el navegador hacia la API y las funciones hacia los servicios de AWS. En reposo: Kinesis (KMS, clave administrada por AWS), DynamoDB (clave propiedad de AWS por defecto), S3 (AES-256), y Cognito y CloudWatch Logs tal como los ofrece AWS. Las URL de webhook de Slack y Teams se guardan completas en la tabla y se devuelven a la consola enmascaradas.
Retención y copias de seguridad
- Registro de puntos por evento: 90 días (
TTL_DAYS); después DynamoDB lo elimina.
- Totales diarios y semanales por agente: se conservan, para que el informe de resultados y las mejores marcas personales tengan historial.
- Filas de acuses de recibo pendientes: 45 días. Marcadores de contacto a agente: 14 días. Marcadores de trabajos: 14 días. Días libres: 120 días.
- Retos, recompensas, planes de coaching (incluida la nota privada del supervisor), presupuestos, catálogo, temas y claves: se conservan hasta que usted los quite, elimine al agente o elimine el stack.
- Recuperación a un momento dado de la tabla: 35 días.
- Kinesis: 24 horas.
- CloudWatch Logs: la retención por defecto de su cuenta.
Eliminar datos
Un agente. Como supervisor, DELETE <ApiUrl>/agents/<ARN del agente>, o con sus credenciales de AWS:
node delete-agent.js <nombre del stack> --agent <ARN del agente> --dry-run
node delete-agent.js <nombre del stack> --agent <ARN del agente>
El script delete-agent.js se publica junto a la plantilla de cada versión: sustituya template.yaml por delete-agent.js en la dirección de su plantilla.
Elimina las filas del agente, sus solicitudes de recompensa, sus planes de coaching y los kudos dirigidos a esa persona, y escribe una línea de auditoría en el registro de la API. Su usuario de Cognito es independiente; elimínelo en la consola de Cognito.
Todo. Elimine el stack de CloudFormation. La tabla, el bucket, el grupo de usuarios, el flujo, las funciones, los registros y las alarmas se van con él. Cancelar la suscripción de Marketplace detiene la facturación; no elimina el stack.
Datos sensibles: PII, PHI y PCI
Arena está construido para que los datos regulados no lleguen a él. Lee eventos de agentes, notas de evaluación, cifras de sentimiento y cifras de encuestas, nunca grabaciones, transcripciones, texto de chats, nombres de clientes, números de teléfono ni datos de pago. No hay ningún camino por el que datos de titulares de tarjetas o contenido clínico entren en el sistema desde Amazon Connect, por lo que Arena queda fuera del alcance de PCI DSS y no contiene PHI procedente del contacto.
Lo que Arena sí contiene son datos personales de su personal: nombres, nombres de usuario, ARN de Connect, puntuaciones, rachas, recompensas y planes de coaching. Según el RGPD y leyes similares, usted es el responsable del tratamiento y el stack en su cuenta es el tratamiento; EKPK nunca los recibe. La eliminación por agente, la retención y la tabla de salidas de este artículo son los controles.
El único lugar donde una persona puede introducir datos sensibles es el texto libre: notas de kudos, motivos de premios puntuales, motivos, notas y acciones de coaching, títulos de retos y nombres enviados por el endpoint de ingesta. Cada uno de esos campos se enmascara antes de guardarse o de enviarse a un canal, con dos niveles que se eligen con el ajuste FreeTextRedaction:
patterns (por defecto): números de tarjeta de pago que superan la comprobación de Luhn, los formatos del número de seguridad social de Estados Unidos y del seguro nacional del Reino Unido, direcciones de correo y cualquier secuencia de nueve o más dígitos, como números de teléfono, de cuenta o de historia clínica. Se enmascaran dejando sus últimos caracteres, de modo que "4111 1111 1111 1111" se guarda como "••••••••••••1111".
comprehend: los patrones y, después, la detección de PII de Amazon Comprehend ejecutada en su propia cuenta, que enmascara nombres, direcciones, fechas de nacimiento, números de banco y de tarjeta y los demás tipos de entidad que Comprehend reconoce, en inglés o en español (FreeTextRedactionLanguage), los dos idiomas que admite su detección de PII. Los centros que trabajan en francés, alemán o portugués tienen el enmascarado por patrones en todos los idiomas, pero no deben esperar detección de nombres. Si la llamada falla, los patrones se siguen aplicando. Comprehend es apto para HIPAA y cuesta una fracción de centavo por nota.
HIPAA. Todos los servicios de AWS que usa el stack (Lambda, DynamoDB, Kinesis, API Gateway, CloudFront, S3, Cognito, SNS, EventBridge, CloudWatch, y Comprehend y Bedrock cuando están activados) son aptos para HIPAA y están cubiertos por su acuerdo de socio comercial (BAA) con AWS. EKPK no trata PHI y no se necesita ningún BAA con EKPK. Los centros que puedan ver PHI en las notas de coaching deberían configurar FreeTextRedaction=comprehend.
PCI DSS. Por diseño, Arena nunca recibe, almacena, procesa ni transmite datos de titulares de tarjetas, y el filtro de patrones enmascara un número de tarjeta que una persona escriba en una nota. Arena no está en su entorno de datos de titulares de tarjetas.
Integridad de las versiones
Cada versión son tres archivos en una ubicación de S3 pública, de solo lectura y con control de versiones: la plantilla de CloudFormation, el archivo de código de Lambda y el archivo de páginas. La plantilla fija el archivo de código a su versión exacta de objeto en S3 y lleva el SHA-256 del archivo de páginas, que el stack comprueba antes de instalar las páginas; por tanto, un objeto sustituido en el bucket no cambia nada para una plantilla ya publicada. Los mismos tres hashes aparecen bajo cada versión en la página de notas de versión, un dominio de confianza distinto del bucket, para que un revisor pueda comparar lo que descargó CloudFormation con lo que publicó EKPK. Los objetos existentes en la ubicación de versiones no pueden eliminarse, solo quedar sustituidos por una versión nueva a la que ninguna plantilla publicada hace referencia.
Operación y supervisión
El stack incluye alarmas para errores de ingesta, para un flujo con cinco minutos de retraso, para errores de la función de la API, para respuestas 5xx de la API y para un informe de uso fallido, todas en un mismo tema de SNS al que puede suscribirse. Cada función escribe registros JSON estructurados. La eliminación de agentes y cada cambio de configuración (mezcla de puntuación, notificaciones, catálogo de recompensas y presupuestos, tema y logotipo, usuarios, claves, alias, premios puntuales) queda registrado con quién lo hizo. Las claves de wallboard, de datos y de ingesta se guardan como hash; el token se muestra una sola vez, cuando se crea. Con Diagnostics=enabled, las mismas notificaciones de alarma se reenvían también a soporte de EKPK, reducidas a nombre de la alarma, estado, motivo, versión y región; por defecto está desactivado.
Actualizaciones
Las versiones se publican como plantillas y archivos de código versionados en una ubicación de S3 pública y de solo lectura. Usted actualiza apuntando el stack a la URL de una plantilla nueva; nada cambia en su cuenta hasta que lo hace. Cada versión tiene sus notas de versión, y este centro de ayuda indica para qué versión está vigente cada artículo.
Responsabilidad compartida
EKPK es responsable del código del stack y de publicar las correcciones. Usted es responsable de la cuenta de AWS donde funciona el stack: quién puede iniciar sesión, quién tiene credenciales de la cuenta, cuándo actualizar y los ajustes que elija, como el correo de alarmas, la forma de mostrar los nombres y las fuentes de datos. AWS es responsable de los servicios subyacentes, según el modelo de responsabilidad compartida de AWS.
Preguntas
Las preguntas de seguridad y los informes de vulnerabilidades van a [email protected]. Respondemos en un día hábil.
Vigente para la versión 0.38.0. Las notas de versión (en inglés) indican qué ha cambiado desde entonces. El resto del centro de ayuda está en inglés.