A configuração na plataforma Windows também pode ser feita através da interface de configuração da agente.
Os parâmetros da biblioteca nativa são mantidos em variáveis de ambiente do sistema. As configurações feitas com esta interface serão colocadas no escopo do perfil do usuário, portanto válidas e reconhecidas somente para as aplicações executando sob o perfil do usuário corrente.
Não há necessidade de perfil administrativo ou elevação de privilégio para o usuário setar ou editar os parâmetros da biblioteca.
Para editar a configuração clique com o botão direito sobre o ícone do agente na bandeja do sistema. O menu do agente deverá ser mostrado; selecione a opção Cliente. Caso o agente não esteja carregado na bandeja do sistema é possível executá-lo novamente no atalho (shortcut) Start HSM Agent no menu de atalhos do Windows.
Fig. Menu Agente - Opção Cliente
Fig. Configuração Cliente HSM - Parâmetros da biblioteca cliente Windows
Cache de Sessões
O checkbox habilita e desabilita o sistema de cache de sessões da biblioteca. Veja maiores detalhes em Cache de sessões.
Balanceamento de carga
O checkbox habilita e desabilita o sistema de balanceamento da biblioteca.
O Pocket dispõe de um mecanismo de balanceamento de carga, permitindo maior disponibilidade do ambiente e desempenho para as aplicações. É possível ter até 16 (dezesseis) unidades do Pocket em sistema de balanceamento de carga, com a mesma quantidade de sessões em cada um dos equipamentos. O balanceamento de carga é transparente para a aplicação, ou seja, uma vez habilitado o balanceamento no ambiente, a aplicação se beneficia sem precisar de qualquer alteração.
O balanceamento funciona num esquema tipo round-robin, distribuindo conexões circularmente entre os HSM configurados para balanceamento. A unidade de balanceamento é a sessão com o HSM, independente da carga ou das APIs utilizadas em cada sessão e também da taxa de utilização de recursos em cada HSM. O HSM que vai estabelecer a sessão com a aplicação é definido pela estrutura de balanceamento e não pela aplicação. O esquema do balanceamento funciona por processo, ou seja, dentro de cada processo são suas sessões que serão balanceadas; caso dois processos rodem ao mesmo tempo, cada um terá uma estrutura de balanceamento separada e independente.
Quando esta opção está habilitada, o endereço IP do HSM onde será aberta a sessão é lido da lista de balanceamento, e o endereço IP informado via API é ignorado.
Na lista Endereço IP indique os HSM que farão parte do balanceamento, utilize os botões + e - para acrescentar e remover entradas na lista.
Veja maiores detalhes em Balanceamento de carga.
Nível de log
O sistema de log da biblioteca tem 5 níveis de log:
| 1. | Apenas erros |
| 2. | Advertências |
| 3. | Informações |
| 4. | Depuração |
| 5. | Desabilitado |
O nível de informação logada em arquivo aumente dos níveis 1 até 4. No nível Desabilitado nenhum log em arquivo é gerado.
Durante o operação normal da aplicação o log geralmente fica desabilitado ou setado para o nível Apenas erros, pois os aquivos gerados podem ser bastante grande, além de impactar negativamente o desempenho. Aumente o nível de log quando precisar gerar mais informação para depuração de problemas ou como subsídio para o pessoal de suporte.
Arquivo de log
Os arquivo de log são gerados individualmente para cada processo que carrega a biblioteca; cada processo gera um arquivo de log que tem a identificação do processo (Process ID ou PID) no nome do arquivo. Por exemplo, para um nome arquivo de log tacndlib.log os arquivos gerados seriam da forma tacndlib_<PID>.log, como por exemplo tacndlib_3456.log, tacndlib_5947.log, etc.
Na configuração default os arquivos de log são criados numa sub pasta de perfil de usuário em AppData\Local\DinamoNetworks\log. É possível abrir diretamente a pasta de log configurada usando a tecla F7; esta opção também está no menu de sistema do interface.
Fig. Configuração Cliente HSM - Menu de sistema
Log síncrono
O checkbox habilita e desabilita a gravação imediata dos registros de log em arquivo, sem passar pelo subsistema de cache.
A biblioteca pode manter um pequeno cache de registros de log antes de fazer a gravação física no arquivo. Isto permite ganhos de desempenho. Em condições de erro ou situações de diagnóstico, é interessante que o registro seja gravado imediatamente após sua ocorrência, ou seja, de modo síncrono.
Retentativas de conexão
Define o número de novas tentativas para estabelecer uma conexão com o HSM, caso a primeira tentativa falhe por algum motivo. O valor default é 3.
Tempo máximo para envio
Define, dentro de uma sessão estabelecida, o tempo máximo (em milissegundos) que a biblioteca irá aguardar por uma resposta de confirmação antes de decidir que o envio falhou e uma condição de erro deve ser reportada para a aplicação.
Valor não definido significa trabalhar com o tempo default usado na pilha do protocolo TCP/IP do sistema operacional. Consulte documentação de seu sistema operacional em particular sobre este valor.
Tempo máximo para recepção
Define, dentro de uma sessão estabelecida, o tempo máximo (em milissegundos) que a biblioteca irá aguardar por uma resposta a uma solicitação antes de decidir que a comunicação falhou e uma condição de erro deve ser reportada para a aplicação.
Valor não definido significa trabalhar com o tempo default usado na pilha do protocolo TCP/IP do sistema operacional. Consulte documentação de seu sistema operacional em particular sobre este valor.
Tempo de suspensão (BC)
É o tempo (em segundos) de suspensão no balanceamento de carga (BC), o período que a biblioteca vai retirar da lista da balanceamento um endereço problemático.
Durante a operação da biblioteca com balanceamento de carga pode acontecer de um ou mais dos endereços indicados na lista não conseguir estabelecer sessão com a aplicação. Neste caso a biblioteca vai retirar temporariamente da lista de balanceamento o endereço problemático e vai tentar uma nova conexão vencido este prazo.
Escopo por aplicação, por usuário e por sistema
Usando a interface do agente (ou definindo as variáveis de ambiente no perfil do usuário) o escopo dos parâmetros é sempre por usuário.
Para definir um escopo por aplicação, é necessário carregar a aplicação com uma definição específica das variáveis, por exemplo encapsulando a carga da aplicação num arquivo de lote (batch).
Para definir um escopo global (do sistema) é preciso definir as variáveis na âmbito do sistema, por exemplo via painel de controle na área de variáveis de sistema.
Para detalhes sobre cada parâmetro e a variável correspondente consulte a sessão Usando variáveis de ambiente.
Nota: para informações sobre as opções do menu CSP e Certificados consulte o tópico Configuração da CSP .