Segurança e os seus dados
Também em: English · Español · Français · Deutsch
Este artigo foi escrito para quem avalia um software antes que um contact center possa usá-lo: as equipes de segurança, privacidade e compras. Ele descreve do que o Arena é feito, onde os dados ficam, quem pode chegar a eles e como removê-los. Tudo o que está aqui pode ser verificado no template do CloudFormation, publicado em modo somente leitura no local público de versões, com link em cada entrada das notas de versão.
A versão curta
- O Arena é uma stack do CloudFormation que roda dentro da sua própria conta AWS, na região que você escolher. Não existe nenhum serviço do Arena fora da sua conta guardando os seus dados.
- A EKPK, empresa que faz o Arena, não consegue acessar os seus dados. A stack não concede à EKPK nenhuma role, nenhuma chave e nenhum endpoint.
- O que sai da sua conta: um número por dia para o AWS Marketplace, para a cobrança (a contagem de agentes com atividade pontuada), e, a menos que você defina
Telemetry=disabled, uma verificação de versão uma vez por dia a partir do console do supervisor, com um identificador de instalação anônimo, a versão e a região e, somente se você indicar um parceiro de implementação com PartnerCode, esse código e um rótulo que você escolhe. Nada mais, e nunca um nome, um identificador ou uma pontuação. A tabela completa está mais abaixo.
- O Arena lê eventos de agentes e pontuações, nunca gravações, transcrições ou o conteúdo das conversas com clientes.
- Exclua a stack e tudo desaparece.
Arquitetura
A stack cria estes recursos. Cada um pertence à sua conta e é cobrado dela nas tarifas normais da AWS.
| Recurso |
Finalidade |
Observações |
| Fluxo de dados do Kinesis |
Recebe os eventos de agentes do Amazon Connect |
Criptografado com uma chave do KMS gerenciada pela AWS; retenção de 24 horas; um shard por padrão |
| Funções Lambda |
Ingestão, API, avaliações, regras de avaliação, sentimento, aderência, confirmações de ciência, folgas, carga histórica, exportação, medição de uso, sequências, resumo, diagnóstico (opcional), implantação do site |
Node.js 22 em Graviton; cada uma com a sua própria role do IAM (veja abaixo) |
| Tabela do DynamoDB |
Todos os dados do Arena, em uma única tabela |
Criptografada em repouso; capacidade sob demanda; recuperação para um ponto no tempo, 35 dias |
| API HTTP (API Gateway) |
A API que as páginas chamam |
Toda rota exige um JWT, exceto três que levam a própria chave: links de wallboard, chaves de dados e chaves de ingestão (veja Quem pode ver o quê); com limite de requisições; somente TLS |
| Distribuição do CloudFront e bucket privado do S3 |
Hospeda o painel do agente, o console, o wallboard e o relatório |
O bucket bloqueia todo acesso público; o CloudFront chega a ele por uma identidade de acesso de origem; somente TLS |
| Grupo de usuários do Cognito |
Login de agentes e supervisores |
Opcional: você pode usar o seu próprio provedor de identidade |
| Tópicos do SNS |
Alarmes operacionais; resumo opcional por e-mail |
As assinaturas são confirmadas por e-mail |
| Alarmes e logs do CloudWatch |
Erros de ingestão, atraso do fluxo, erros da API, relatório de uso com falha |
Os logs ficam na sua conta |
| Agendamentos do EventBridge |
Os trabalhos de hora em hora e noturnos |
|
As funções Lambda chamam serviços da AWS na sua conta e, para Slack ou Microsoft Teams, apenas as URLs de webhook que os seus supervisores informarem. Três caminhos saem para fora, todos listados na tabela de saídas deste artigo: a cobrança para o AWS Marketplace, a verificação diária de versão para a EKPK (desligada com Telemetry=disabled) e o encaminhamento de alarmes para a EKPK somente se você definir Diagnostics=enabled. Na instalação e a cada atualização, a função de implantação do site baixa o arquivo de páginas da versão a partir do local público de versões da EKPK.
O que o Arena armazena
Do fluxo de eventos de agentes do Connect: ARN do agente, nome de usuário, nome e sobrenome, perfil de roteamento (mostrado como a equipe), mudanças de estado e, para cada contato atendido, o ID do contato, a fila, o canal e o tempo de atendimento. Os IDs de contato são mantidos por 14 dias para que análises posteriores possam ser associadas ao agente.
Se você ativar as fontes opcionais: notas de avaliação e o título da pergunta de reprovação automática, dos arquivos de avaliação do Contact Lens; a pontuação geral de sentimento do cliente, dos arquivos de análise do Contact Lens; notas de pesquisa a partir de um atributo de contato; percentuais de aderência a partir das métricas do próprio Connect.
Criado dentro do Arena: pontos, sequências, medalhas, desafios e suas classificações, pedidos e aprovações de recompensas, notas de kudos escritas pelos agentes (140 caracteres), planos de coaching, incluindo a nota privada do supervisor, configurações de notificações e as preferências de cada agente.
O que o Arena nunca lê: gravações de chamadas ou de tela, transcrições, texto de chats, nomes de clientes, números de telefone ou qualquer dado de clientes. Dos arquivos do Contact Lens são lidos os campos de pontuação e nada mais; os arquivos de análise não são guardados.
O que sai da sua conta
| Dado |
Para onde vai |
Por quê |
| Contagem de agentes com atividade pontuada, uma vez por noite |
AWS Marketplace Metering Service |
Cobrança. Sem identificadores. Os primeiros 10 agentes por dia são subtraídos antes, ou os primeiros 25 durante o teste de 30 dias. |
| Avisos de kudos, recompensas e desafios, e o resumo diário |
Os webhooks do Slack ou do Teams que você configurou |
Somente se um supervisor os ativou, e somente para a URL que ele informou |
| Resumo diário por e-mail |
O endereço que um supervisor informou, pelo seu próprio tópico do SNS |
Somente se estiver ativado |
Verificação de versão, uma vez por dia: um identificador de instalação anônimo (um hash do ID da stack), a versão do Arena e a região da AWS. Se você definir PartnerCode na stack, também esse código e o rótulo opcional PartnerClientLabel |
O endpoint de telemetria da EKPK, a partir do console do supervisor |
Para que a EKPK saiba quantas instalações rodam cada versão e o console possa avisar quando existe uma mais nova. Telemetry=disabled na stack desliga; o console passa a ler arenaforconnect.com diretamente. Com um código de parceiro definido, esse parceiro vê na página de frota dele o identificador, o rótulo, a versão, a região, a primeira e a última verificação desta instalação e os alarmes que você compartilhar com Diagnostics; nada mais. Esvazie PartnerCode para deixar de compartilhar. |
| Mudanças de estado dos alarmes: nome do alarme, estado, motivo, versão, região, identificador de instalação |
O endpoint de telemetria da EKPK |
Somente com Diagnostics=enabled na stack (desligado por padrão), para que o suporte veja cedo uma stack com falha. Nunca dados de agentes, contatos, equipes ou contas. |
| Solicitação de rascunho de coaching: o motivo do plano e as médias do agente nos últimos 28 dias (avaliação, sentimento, pesquisa, aderência, contatos, tempo de atendimento, reprovações automáticas). Nunca um nome, um identificador, uma equipe ou um contato |
Amazon Bedrock, chamado a partir da sua própria conta da AWS |
Somente com CoachingAssistant=enabled (desativado por padrão) e somente quando um supervisor clica em Redigir com IA. Permanece dentro da AWS, na sua conta. O modelo padrão é um perfil de inferência global, então a AWS pode processar a solicitação em outra região; defina CoachingModelId com um perfil geográfico para mantê-la em uma única geografia. A AWS afirma que o Bedrock não armazena as solicitações nem as usa para treinar modelos. |
| Solicitação de rascunho de quiz: o texto de política ou de produto que um supervisor cola para que as perguntas sejam escritas a partir dele, até 6.000 caracteres, mascarado como os demais textos livres |
Amazon Bedrock, chamado a partir da sua própria conta da AWS |
Somente com CoachingAssistant=enabled e somente quando um supervisor clica em Redigir perguntas com IA. Valem o mesmo modelo e a mesma observação sobre regiões do rascunho de coaching. Não cole texto que você não enviaria a esse modelo. |
| Pedido de vale-presente: o valor, a moeda, a sua campanha, a sua fonte de fundos e uma referência criada a partir do id da recompensa. Nunca o nome, o e-mail, o identificador ou a equipe de um agente |
Tremendous, com a sua própria chave de API da Tremendous |
Somente com RewardDelivery=tremendous (desativado por padrão) e somente quando um supervisor aprova uma recompensa que tem valor de vale-presente. A chave é lida de um parâmetro SecureString na sua conta. O link de resgate que a Tremendous devolve fica na sua tabela e é mostrado apenas ao agente a quem pertence. |
A página de registro que você usou ao assinar roda na conta da EKPK. Ela recebe do Marketplace o ID da sua conta AWS e o identificador da assinatura, guarda os dois para que o link de lançamento continue válido, e nada mais. Ela nunca vê nada de dentro da sua stack. O link de configuração que o Marketplace entrega abre essa página uma única vez; uma cópia do link encontrada depois em um log ou no histórico do navegador não mostra nada.
Quem pode ver o quê
- O login é obrigatório em todas as páginas e em todas as rotas da API, com três exceções deliberadas que levam a própria chave no lugar do token de uma pessoa: os links de wallboard, as chaves de dados e as chaves de ingestão, descritas abaixo. O login é feito pelo seu grupo de usuários do Cognito ou pelo seu próprio provedor de identidade (OIDC); a API valida o token a cada chamada. Os usuários só podem alterar o próprio e-mail: os atributos que dizem quem é um agente e a qual equipe ele pertence são definidos pelos administradores e não podem ser editados pelo usuário.
- Supervisores (membros do grupo de supervisores) podem ler e agir sobre todas as equipes.
- Agentes veem o ranking, os desafios e os kudos da própria equipe, os próprios pontos e saldo, e a ação combinada dos próprios planos de coaching, nunca a nota privada de um supervisor nem a atividade de outro agente. Um agente pode se ocultar dos rankings e wallboards dos colegas; os supervisores continuam vendo.
- Chaves de dados (para data warehouses e ferramentas de BI) leem as linhas diárias por agente de todas as equipes, com nomes e ARNs, até dois anos para trás; chaves de ingestão permitem que outra plataforma grave eventos pontuados para qualquer agente. Ambas são geradas pelos supervisores no diálogo Dados do console, exibidas uma única vez e revogáveis a qualquer momento; trate-as como segredos de integração.
- Wallboards usam uma chave somente leitura que um supervisor gera para uma equipe, válida por até um ano (90 dias por padrão) e revogável a qualquer momento. Os nomes nos wallboards podem ser encurtados para nome e inicial, ou apenas iniciais, com a configuração
WallboardNames, já que qualquer pessoa que passe por uma tela pode lê-la.
- Operadores da sua conta AWS podem ler a tabela diretamente, como qualquer recurso da conta. Use os controles de acesso habituais da sua conta.
Privilégio mínimo dentro da stack
Cada função tem a sua própria role, limitada ao que ela faz. Em resumo:
| Função |
Pode |
| Ingestão |
Ler o fluxo do Kinesis; ler e gravar na tabela |
| API |
Ler e gravar na tabela; publicar no tópico do resumo; gerenciar usuários no grupo de usuários da própria stack (convidar, editar função e equipe, redefinir senha, remover); gravar o logotipo da empresa no bucket do site; invocar um modelo do Amazon Bedrock (somente se o assistente de coaching estiver ativado); ler o único parâmetro do Systems Manager que contém a sua chave da Tremendous (somente se a entrega de recompensas estiver ativada) |
| Avaliações, sentimento |
Ler o único bucket e prefixo que você indicou; ler e gravar na tabela |
| Confirmações de ciência, regras de avaliação |
connect:DescribeContactEvaluation (as regras de avaliação também ListContactEvaluations) nas suas instâncias; ler e gravar na tabela |
| Folgas |
Ler e gravar na tabela |
| Exportação |
Ler a tabela; gravar no bucket de exportação |
| Diagnóstico (somente se ativado) |
Ler o tópico de alarmes; enviar à EKPK o nome do alarme, o estado, o motivo, a versão e a região |
| Conector do Genesys Cloud (somente se ativado) |
Receber eventos de conversa do barramento de eventos que você indicar; ler e gravar na tabela. Não chama nada fora da sua conta nem guarda credenciais do Genesys |
| Aderência, carga histórica |
connect:GetMetricDataV2 (a carga histórica também ListUsers, DescribeUser, DescribeRoutingProfile); ler e gravar na tabela |
| Medição de uso |
aws-marketplace:BatchMeterUsage; ler e gravar na tabela |
| Sequências, resumo |
Ler e gravar na tabela; o resumo também publica no tópico do resumo |
| Implantação do site |
Gravar no bucket do site; invalidar a distribuição; definir as URLs de retorno do cliente do grupo de usuários |
Consulta da instância (somente quando ConnectInstanceArn está definido e ConnectInstanceUrl não) |
connect:DescribeInstance na sua instância, e ds:DescribeDirectories, somente leitura, do qual essa chamada depende, para descobrir o endereço da instância ao criar e atualizar a stack |
Nenhuma função tem permissão para criar recursos, alterar o IAM ou ler qualquer coisa no Connect além das métricas e dos registros de avaliação citados acima.
Proteções no navegador
- Frames. As páginas só podem ser exibidas em um frame da sua própria instância do Connect: o endereço em
ConnectInstanceUrl, ou aquele que a stack lê a partir de ConnectInstanceArn. Não há curinga, então outra instância do Connect ou qualquer outro site não consegue incorporar as suas páginas. A saída FramedBy da stack mostra quem está autorizado.
- Chamadas à API de outras origens. Nenhuma é permitida por padrão. As páginas chegam à API pelo próprio endereço do site, então a API não concede acesso a nenhum outro site. Uma origem específica pode ser permitida com
AllowedOrigin; curinga não é aceito.
- Política de segurança de conteúdo. Scripts, estilos e dados são carregados apenas do próprio site e dos endpoints da AWS nomeados. O HTTPS é imposto com HSTS, e a detecção automática de tipo de conteúdo está desativada.
Criptografia
Em trânsito: todos os caminhos usam TLS, incluindo do CloudFront ao navegador, do navegador à API e das funções aos serviços da AWS. Em repouso: Kinesis (KMS, chave gerenciada pela AWS), DynamoDB (chave de propriedade da AWS por padrão), S3 (AES-256), e Cognito e CloudWatch Logs conforme fornecidos pela AWS. As URLs de webhook do Slack e do Teams são guardadas inteiras na tabela e devolvidas ao console mascaradas.
Retenção e backups
- Registro de pontos por evento: 90 dias (
TTL_DAYS); depois o DynamoDB o expira.
- Totais diários e semanais por agente: mantidos, para que o relatório de resultados e os recordes pessoais tenham histórico.
- Linhas de confirmações de ciência pendentes: 45 dias. Marcadores de contato para agente: 14 dias. Marcadores de trabalhos: 14 dias. Folgas: 120 dias.
- Desafios, recompensas, planos de coaching (incluindo a nota privada do supervisor), orçamentos, catálogo, temas e chaves: mantidos até que você os remova, exclua o agente ou exclua a stack.
- Recuperação para um ponto no tempo da tabela: 35 dias.
- Kinesis: 24 horas.
- CloudWatch Logs: a retenção padrão da sua conta.
Excluir dados
Um agente. Como supervisor, DELETE <ApiUrl>/agents/<ARN do agente>, ou com as suas credenciais da AWS:
node delete-agent.js <nome da stack> --agent <ARN do agente> --dry-run
node delete-agent.js <nome da stack> --agent <ARN do agente>
O script delete-agent.js é publicado junto ao template de cada versão: troque template.yaml por delete-agent.js no endereço do seu template.
Remove as linhas do agente, os pedidos de recompensa, os planos de coaching e os kudos endereçados a ele, e grava uma linha de auditoria no log da API. O usuário do Cognito é separado; exclua-o no console do Cognito.
Tudo. Exclua a stack do CloudFormation. A tabela, o bucket, o grupo de usuários, o fluxo, as funções, os logs e os alarmes vão junto. Cancelar a assinatura do Marketplace interrompe a cobrança; não exclui a stack.
Dados sensíveis: PII, PHI e PCI
O Arena foi construído para que dados regulados não cheguem a ele. Ele lê eventos de agentes, notas de avaliação, números de sentimento e números de pesquisas, nunca gravações, transcrições, texto de chats, nomes de clientes, números de telefone ou dados de pagamento. Não há nenhum caminho pelo qual dados de titulares de cartão ou conteúdo clínico entrem no sistema a partir do Amazon Connect, portanto o Arena fica fora do escopo do PCI DSS e não guarda PHI vinda do contato.
O que o Arena guarda são dados pessoais da sua equipe: nomes, nomes de usuário, ARNs do Connect, pontuações, sequências, recompensas e planos de coaching. Sob a LGPD, o GDPR e leis semelhantes, você é o controlador e a stack na sua conta é o tratamento; a EKPK nunca os recebe. A exclusão por agente, a retenção e a tabela de saídas deste artigo são os controles.
O único lugar em que uma pessoa pode introduzir dados sensíveis é o texto livre: notas de kudos, motivos de prêmios pontuais, motivos, notas e ações de coaching, títulos de desafios e nomes enviados pelo endpoint de ingestão. Cada um desses campos é mascarado antes de ser guardado ou enviado a um canal, com dois níveis escolhidos pela configuração FreeTextRedaction:
patterns (padrão): números de cartão de pagamento que passam na verificação de Luhn, os formatos do número de seguridade social dos Estados Unidos e do seguro nacional do Reino Unido, endereços de e-mail e qualquer sequência de nove ou mais dígitos, como números de telefone, de conta ou de prontuário. São mascarados deixando os últimos caracteres, de modo que "4111 1111 1111 1111" é guardado como "••••••••••••1111".
comprehend: os padrões e, em seguida, a detecção de PII do Amazon Comprehend rodando na sua própria conta, mascarando nomes, endereços, datas de nascimento, números de banco e de cartão e os demais tipos de entidade que o Comprehend reconhece, em inglês ou espanhol (FreeTextRedactionLanguage), os dois idiomas que a detecção de PII dele suporta. Centros que trabalham em português, francês ou alemão têm o mascaramento por padrões em todos os idiomas, mas não devem esperar detecção de nomes. Se a chamada falhar, os padrões continuam valendo. O Comprehend é elegível para HIPAA e custa uma fração de centavo por nota.
HIPAA. Todos os serviços da AWS que a stack usa (Lambda, DynamoDB, Kinesis, API Gateway, CloudFront, S3, Cognito, SNS, EventBridge, CloudWatch, e Comprehend e Bedrock quando ativados) são elegíveis para HIPAA e cobertos pelo seu acordo de parceiro comercial (BAA) com a AWS. A EKPK não trata PHI e nenhum BAA com a EKPK é necessário. Centros que possam ver PHI nas notas de coaching devem definir FreeTextRedaction=comprehend.
PCI DSS. Por design, o Arena nunca recebe, armazena, processa ou transmite dados de titulares de cartão, e o filtro de padrões mascara um número de cartão que uma pessoa digite em uma nota. O Arena não está no seu ambiente de dados de titulares de cartão.
Integridade das versões
Cada versão são três arquivos em um local do S3 público, somente leitura e versionado: o template do CloudFormation, o arquivo de código das Lambdas e o arquivo de páginas. O template fixa o arquivo de código na versão exata do objeto no S3 e traz o SHA-256 do arquivo de páginas, que a stack confere antes de instalar as páginas; assim, um objeto trocado no bucket não muda nada para um template já publicado. Os mesmos três hashes aparecem sob cada versão na página de notas de versão, um domínio de confiança diferente do bucket, para que um revisor possa comparar o que o CloudFormation baixou com o que a EKPK publicou. Os objetos existentes no local de versões não podem ser excluídos, apenas substituídos por uma versão nova que nenhum template publicado referencia.
Operação e monitoramento
A stack inclui alarmes para erros de ingestão, para o fluxo com cinco minutos de atraso, para erros da função da API, para respostas 5xx da API e para um relatório de uso com falha, todos em um único tópico do SNS que você pode assinar. Cada função grava logs JSON estruturados. A exclusão de agentes e cada mudança de configuração (composição da pontuação, notificações, catálogo de recompensas e orçamentos, tema e logotipo, usuários, chaves, apelidos, prêmios pontuais) é registrada com quem a fez. As chaves de wallboard, de dados e de ingestão são guardadas como hash; o token é exibido uma única vez, quando é criado. Com Diagnostics=enabled, as mesmas notificações de alarme também são encaminhadas ao suporte da EKPK, reduzidas a nome do alarme, estado, motivo, versão e região; o padrão é desligado.
Atualizações
As versões são publicadas como templates e arquivos de código versionados em um local do S3 público e somente leitura. Você atualiza apontando a stack para a URL de um template novo; nada muda na sua conta até que você faça isso. Cada versão tem as suas notas de versão, e esta central de ajuda informa para qual versão cada artigo está atualizado.
Responsabilidade compartilhada
A EKPK é responsável pelo código da stack e por publicar as correções. Você é responsável pela conta AWS em que a stack roda: quem pode entrar, quem tem credenciais da conta, quando atualizar e as configurações que escolher, como o e-mail de alarmes, a exibição de nomes e as fontes de dados. A AWS é responsável pelos serviços por baixo, conforme o modelo de responsabilidade compartilhada da AWS.
Perguntas
Perguntas de segurança e relatos de vulnerabilidades vão para [email protected]. Respondemos em um dia útil.
Atualizado para a versão 0.38.0. As notas de versão (em inglês) mostram o que mudou desde então. O restante da central de ajuda está em inglês.