Arena for Amazon Connect

Central de ajuda › Segurança e os seus dados

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

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ê

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

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

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:

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.