Como criptografar dados de um produtor de registro

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 3 min. de leitura
  • Crie regras de criptografia a partir do registro do produtor de registro para configurar o seu servidor proxy Edge Encryption para permitir inserções de um produtor de registro.

    Antes de Iniciar

    Função necessária: security_admin

    Os produtores de registro permitem que os usuários finais criem registros baseados em tarefas, como registros de incidentes, a partir de Catálogo de serviços e de Portal de serviços. Se um produtor de registro tentar inserir dados em um campo marcado para criptografia, uma mensagem de inserção inválida será exibida e os dados não serão salvos no campo.

    A criptografia de dados de um produtor de registro requer uma configuração de criptografia definida para o campo de destino. Verifique se você criou uma configuração de criptografia para o campo de destino e a tabela antes de criar uma regra de criptografia de um produtor de registro. Consulte Como criar uma configuração de Edge Encryption. Para criptografar anexos de um produtor de registro, Como configurar criptografia de anexo.

    Procedimento

    1. Faça login na sua instância por meio do servidor proxy Edge Encryption.
    2. Navegar até Catálogo de serviços > Definições de Catálogo > Produtores de Registros.
    3. Criar um produtor de registro ou abrir um registro de produtor de registro existente.
    4. Em Links relacionados, selecione Criar regra de Edge Encryption.
      Duas regras de criptografia inativas são criadas automaticamente para criptografar dados enviados do produtor de registro para o campo marcado para criptografia.
      Regra de criptografia Descrição
      <RecordProducerName> Regra criada para processar parâmetros POST do Catálogo de serviços e mapear variáveis para campos na instância.
      <RecordProducerName>Json Regra criada para processar uma carga JSON do Portal de serviços e mapear variáveis para campos na instância.
    5. Ative as regras de criptografia necessárias criadas pelo produtor de registro.
      1. Navegar até Configuração de Edge Encryption > Regras > Tudo.
      2. Dependendo de onde o produtor de registro será usado, abra a regra de criptografia associada criada pelo produtor de registro e selecione o sinalizador Ativo.
        Se estiver usando o produtor de registro em Catálogo de serviços, ative a regra de criptografia <RecordProducerName>. Se estiver usando o produtor de registro em Portal de serviços, ative a regra de criptografia <RecordProducerName>Json.
    6. Opcional: Examine o campo Ação da regra de criptografia e adicione os nomes de campo ou as instruções necessárias.

      Se um produtor de registro mapeia diretamente uma variável para um campo em uma tabela, a regra de criptografia mapeia automaticamente a variável para o campo correto. No entanto, se uma variável for mapeada indiretamente por meio de vários scripts na plataforma, talvez seja necessário atualizar as regras para mapear cada variável para o campo correto.

      A regra de criptografia abaixo foi criada a partir do produtor de registro "Indisponibilidade do relatório" e processa os parâmetros POST do Catálogo de serviços para mapear variáveis para campos na instância. Substitua "FILL ME IN" pelo campo de destino.

      Regra do Edge Encryption: Indisponibilidade do relatório

      A regra de criptografia abaixo foi criada a partir do produtor de registro "Indisponibilidade do relatório" e processa uma carga JSON de Portal de serviços para mapear variáveis para campos na instância. Adicione outras instruções para mapear quaisquer variáveis de script para os campos de destino.

      Regra do Edge Encryption: interrupção do relatório Json

      Quando a carga do produtor de registro for examinada, o elemento "error_message" irá conter o valor do campo "short_description". Ao adicionar a instrução a seguir, você poderá mapear a variável de script "error_message" para o campo "short_description".

      if (jsonElement.getName() == 'error_message')
              jsonElement.valueFor(tableName, 'short_description');

      O valor do campo Ação se torna:

      function ReportOutageJsonAction(request) {
      	var tableName = 'incident';
      	// Some fields are set in script, additional parameter lines may need to be added
      	// current.comments is accessed via script from notes; // assignment to current.comments does NOT replace existing values
      	// current.short_description is accessed via script from short_description;
      	// current.description is accessed via script from current.short_description;
      	// current.caller_id is accessed via script from gs.getUserID();
      	var jsonContent = request.getAsJsonContent();
      	for (var jsonElementItr = jsonContent.getIterator('variables'); jsonElementItr.hasNext();) {
      		var jsonElement = jsonElementItr.next();
      		if (jsonElement.getName() == 'error_message')
      			jsonElement.valueFor(tableName, 'short_description');
                    } else {
      		        jsonElement.valueFor(tableName, jsonElement.getName());
      	}
      }

    Resultado

    As duas regras de criptografia permitem que o produtor de registro insira valores em campos marcados para criptografia do Catálogo de serviços ou do Portal de serviços.