Instalação do plug-in do Cisco Email Security usando arquivos de configuração personalizados

Introdução

Este documento descreve o processo de uso de arquivos de configuração personalizados para instalar o plug-in do Cisco Email Security.

Instalação do plug-in do Cisco Email Security usando arquivos de configuração personalizados

Instalar o plug-in do Cisco Email Security

1. Baixe e instale a versão mais recente do plug-in.  (Os arquivos de download estão disponíveis na página Produtos.)
2. Instale o plug-in por meio da instalação padrão.  (Consulte o Guia do administrador do plug-in do Cisco Email Security para obter detalhes.)
3. Carregue o arquivo de configuração XML assinado do BCE (Business Class Email).  
4. Confirme se o plug-in funciona conforme esperado para criptografia.  (Isso garantiria configurações personalizadas para o XML BCE para descriptografar/sinalizar/criptografar e, em seguida, configuração personalizada adicional para o XML CommonComponentsConfiguration.)

Criar um diretório de configuração personalizado

1. Em um host Windows ou Servidor de rede, crie um diretório de instalação personalizado.  (Para este exemplo, usando um compartilhamento de rede: \\172.18.250.59\share\my_plugin_install)
2. No host Windows, navegue até o diretório de instalação padrão:

   1. C:\ProgramData\Cisco\Cisco IronPort Email Security Plug-In\

3. Copie o diretório 'Common' do diretório de instalação padrão para o diretório de instalação personalizado.
4. No host Windows, no diretório de instalação padrão, abra o diretório user_id:

   1. C:\ProgramData\Cisco\Cisco IronPort Email Security Plug-In\<user_id>

5. Copie os arquivos config_1.xml e CommonComponentsConfig.xml existentes para o diretório de instalação personalizado, no diretório 'Common'.
6. No diretório de instalação personalizado, no diretório 'Common' que está sendo construído para instalação personalizada, exclua os arquivos used_configs.bin e cachedFolders.xml, se presentes. 

Neste ponto, a estrutura do diretório de instalação personalizada deve ser semelhante à seguinte:

Edite CommonComponentsConfig.xml

Edite o arquivo CommonComponentsConfig.xml para que não seja usuário, permitindo que qualquer usuário carregue a configuração em seu perfil do Outlook.

1. Usando um editor de texto, do diretório de instalação personalizado, no diretório 'Common' que está sendo construído para instalação personalizada, modifique o arquivo CommonComponentsConfig.xml.
2. Localize a marca accountFileNames:

   1. <accountFileNames>
       <accountFileName filePath="config_1.xml" emailAddressAndKeyServer="user@domain.com res.cisco.com" defaultReportAccount="true" defaultEncryptAccount="true" profileName="[Cisco Enterprise Exchange]" />
      </accountFileNames>

3. Edite a seção accountFileNames, removendo as entradas emailAddress e profileName preexistentes:

   1. <accountFileNames>
       <accountFileName filePath="config_1.xml" emailAddressAndKeyServer="*" defaultReportAccount="true" defaultEncryptAccount="true" />
      </accountFileNames>

Observação: verifique se a sintaxe accountFileName está formatada corretamente.  Se a linha de configuração de accountFileName estiver incorreta, o Outlook definirá o plug-in com os valores padrão e também marcará o plug-in como Inativo para Suplementos do Outlook:

Implantar os arquivos de configuração personalizados

Desinstale a instalação padrão do plug-in que foi executada desde o início deste artigo.  Isso pode ser feito por meio da desinstalação normal do Windows: Painel de Controle > Programas e Recursos > Plug-In do Cisco Email Security e selecionando Desinstalar/Alterar.  Conclua as etapas conforme solicitado.

Neste ponto, os arquivos de configuração personalizada estão prontos para instalação.  Na CLI do Windows, execute a seguinte sintaxe para instalar:

Cisco Email Security Plugin.exe /exenoui /qn UseCustomConfig="\\{SHARED_DIR}\{CONFIG_FOLDER}

Em que o diretório após "=" especifica o diretório para os arquivos de configuração personalizados.

Outros parâmetros de switch usados durante a instalação do .exe:

Switch	Descrição
/exenoui	Inicia a instalação EXE sem interface do usuário
/qn	q , qn - Sem interface

Continuando com o exemplo construído acima, usando o seguinte:

C:>CiscoEmailSecurity-7-5-2-009.exe /exenoui /qn UseCustomConfig="\\172.18.250.59\share\my_plugin_install"

A instalação geralmente leva aproximadamente 30 segundos para ser concluída.  Após a conclusão da instalação, após abrir o Outlook, a instalação final do produto na barra da faixa de opções do Outlook seria semelhante a:

Em New E-mail, a opção Encryption deve estar realçada e pronta para uso:

A opção de criptografia será definida com base na configuração XML BCE original:

 <!--
 Plugin related configuration. Valid type edition values are:
 decrypt - Plugin can only decrypt PXE envelopes.
 flag - Plugin can decrypt and flag a message for encryption.
 encrypt - Plugin can decrypt and encrypt a message on the device.
 -->
 <plugin edition="flag">

Troubleshooting

• UseCustomConfig deve estar no caso correto e não é plural. UseCustomConfigs não funcionará e fará com que o Outlook não leia a configuração corretamente.
• Não encerre o comando de instalação de configuração personalizada referente ao diretório do arquivo de configuração personalizado com um "\".
• O diretório e os arquivos de configuração personalizados devem ter permissões definidas como tal para permitir que o usuário final que executa o Outlook tenha permissão para ler/gravar os arquivos.  Caso contrário, isso também pode fazer com que o Outlook não leia a configuração corretamente, e o usuário final receberá erros durante a inicialização do Outlook.
• Revise o arquivo CiscoEmailSecurity.log no diretório do usuário final para obter mais detalhes sobre os erros gerados e associados à operação do plug-in:

• C:\ProgramData\Cisco\Cisco IronPort Email Security Plug-In\<user_id>\CiscoEmailSecurity.log