Configurar o VPC Service Controls para o CX Agent Studio

O VPC Service Controls pode ajudar você a reduzir o risco de exfiltração de dados do CX Agent Studio. Use o VPC Service Controls para criar um perímetro de serviço que proteja os recursos e dados especificados por você. Por exemplo, quando você usa o VPC Service Controls para proteger o CX Agent Studio, os seguintes artefatos não podem sair do perímetro de serviço:

  • Dados do aplicativo do agente
  • Solicitações e respostas de runSession

O CX Agent Studio permite interagir com outros recursos doGoogle Cloud , como modelos de edição da DLP, BigQuery para exportação de conversas e repositórios de dados. Esses recursos estão sob seu controle e precisam estar disponíveis no mesmo perímetro do VPC-SC que o aplicativo do agente.

Limitações

Considere as seguintes limitações:

  • As ferramentas e os callbacks não podem enviar solicitações para endpoints HTTP ou HTTPS arbitrários quando o VPC Service Controls está ativado, já que isso pode resultar na exfiltração de dados para fora do perímetro do VPC Service Controls. Para permitir solicitações de saída, configure o Diretório de Serviços para acesso à rede privada para destinos de VPC privada ou adicione domínios externos às Origens permitidas nas configurações de local do projeto.
  • As gravações de áudio não podem ser gravadas em buckets do Cloud Storage fora do perímetro.
  • As conversas não podem ser gravadas em conjuntos de dados do BigQuery fora do perímetro.
  • Os modelos de encobrimento da Proteção de Dados Sensíveis fora do perímetro causam falhas no encobrimento do conteúdo da conversa.
  • As ferramentas da OpenAPI não podem referenciar chaves de autenticação usando secrets que estão fora do perímetro.
  • As ferramentas do Datastore que especificam um repositório de dados fora do perímetro não são executadas.
  • Os agentes baseados em fluxo que especificam um recurso de agente fora do perímetro falham quando chamados.
  • A tentativa de importar um aplicativo de agente de um bucket do Cloud Storage fora do perímetro falha.
  • A tentativa de exportar um aplicativo de agente para um bucket do Cloud Storage fora do perímetro falha.

Criação do perímetro de serviço

Ao criar um perímetro de serviço, inclua o CX Agent Studio (ces.googleapis.com) e o CX Insights (contactcenterinsights.googleapis.com) como serviços protegidos. Inclua todos os serviços que você quer restringir (por exemplo, storage.googleapis.com, bigquery.googleapis.com) no painel Serviços restritos.

Para mais informações sobre como criar um perímetro de serviço, consulte Como criar um perímetro de serviço na documentação do VPC Service Controls.

Documentação do VPC Service Controls para dependências opcionais:

Permitir endpoints externos usando origens permitidas

Quando o VPC Service Controls está ativado, as ferramentas e os callbacks que chamam URLs HTTP ou HTTPS externos sem usar o Diretório de Serviços são bloqueados com um erro 403, a menos que você adicione cada origem externa (incluindo todos os endpoints de token OAuth externos) às Origens permitidas do seu projeto e local.

Para ver e atualizar as origens permitidas, conceda o papel predefinido do Identity and Access Management Editor de configurações de segurança do Gemini Enterprise for Customer Experience (roles/ces.securitySettingsEditor) ou um papel personalizado com ces.securitySettings.get e ces.securitySettings.update (também incluído em roles/ces.admin). Insira as origens exatas com o esquema, o domínio e a porta opcional (por exemplo, https://api.example.com ou https://api.example.com:8443), sem caminhos de URL, barras finais ou caracteres curinga.

É possível configurar origens permitidas no console ou usando a API REST:

Como usar o diretório de serviços para acesso a redes privadas

O CX Agent Studio se integra ao acesso à rede privada do Diretório de Serviços, para que ele possa se conectar aos destinos das ferramentas da OpenAPI na sua rede VPC. Isso mantém o tráfego na rede do Google Cloud e aplica o Identity and Access Management e o VPC Service Controls.

Para configurar uma ferramenta que segmenta uma rede privada:

  1. Siga a configuração de rede particular do Diretório de serviços para configurar sua rede VPC e o endpoint do Diretório de serviços.

  2. A conta de serviço do agente de serviço do Pacote de engajamento do cliente com o seguinte endereço precisa existir para o projeto do agente:

    service-agent-project-number@gcp-sa-ces.iam.gserviceaccount.com

    Conceda os seguintes papéis à conta de serviço do agente de serviço do Pacote de engajamento do cliente no projeto em que o Diretório de serviços está localizado:

    • servicedirectory.viewer
    • servicedirectory.pscAuthorizedService

    Além disso, se o Diretório de Serviços estiver em um projeto diferente do aplicativo do agente, você também precisará conceder o papel servicedirectory.viewer à conta do agente de serviço do Pacote de Engajamento do Cliente no projeto que hospeda o aplicativo do agente.

  3. Forneça o serviço do Diretório de Serviços com o URL e as informações de autenticação opcionais ao criar a ferramenta. Esse campo está disponível nas configurações avançadas da ferramenta.

Para resolver problemas, configure uma verificação de tempo de atividade particular para conferir se o Diretório de Serviços está configurado corretamente.