MyQ X Server
10.3 10.2 Print Server Central Server English French German Italian Portuguese Spanish
10.3 10.2 Print Server Central Server English French German Italian Portuguese Spanish

Gerenciamento de crachás

Para gerenciar as configurações de cartões de identificação, acesse MyQ > Configurações > Autenticação do usuário > Cartões.

Estão disponíveis as seguintes opções:

  • Ativar o registro de vários cartões — Esta opção está ativada por padrão. Se desativada, quando um novo cartão for registrado, os cartões atuais serão excluídos.

  • Registrar cartões como temporários — Se esta opção estiver ativada, os cartões de identificação poderão ser registrados como temporários.

    • Validade dos cartões temporários — Defina a duração da validade dos cartões temporários em horas.

  • Quando um cartão de identificação desconhecido é passado — Essas opções determinam o que deve acontecer quando um cartão de identificação desconhecido é passado. As opções são:

    • Falha na autenticação.

    • Permitir que o usuário existente registre o cartão — um usuário existente pode inserir seus dados de login após passar o cartão, e o cartão é registrado para esse usuário no servidor.

    • Registrar um novo usuário — registra o cartão como um novo usuário no servidor; é possível escolher se deseja que os usuários registrados dessa forma sejam automaticamente atribuídos a um grupo de usuários específico.

  • Transformação do código do cartão — essa transformação é utilizada por terminais embutidos (com leitores USB conectados diretamente ao dispositivo) e pelo leitor de um terminal de hardware que está conectado, geralmente, como leitor principal.

  • Transformação do leitor USB — marque a caixa para aplicar a transformação aos leitores de cartão conectados a uma porta USB do PC. Esses leitores de cartão são normalmente utilizados para recarregar crédito ou para associar cartões a contas de usuário.

users-settings-authentication-cards.png


Não é possível adicionar cartões manualmente quando os cartões são sincronizados a partir de uma fonte LDAP. Os cartões adicionados manualmente serão excluídos durante a próxima sincronização LDAP e substituídos pelos cartões da fonte LDAP.

É possível adicionar vários cartões por meio da sincronização LDAP.

Transformação de cartões de identificação

A transformação pode ser necessária caso o cliente precise importar números de cartões de um banco de dados de software de terceiros e o formato dos números de cartão nesse banco de dados não corresponda ao formato lido pelo leitor de cartões do MyQ.

Os leitores de cartões de sistemas de terceiros podem gerar saídas em um formato diferente daquele dos leitores de cartões utilizados no MyQ. Consequentemente, os números dos cartões dos usuários importados do sistema de terceiros podem diferir dos números lidos pelos leitores de cartões MyQ. Para unificar o formato das duas saídas, é possível definir uma sequência específica de comandos que transforme a saída dos leitores de cartões MyQ para o formato utilizado no banco de dados do sistema de terceiros.

Na maioria dos leitores de cartões MyQ, é possível utilizar o software de configuração do leitor para definir o formato diretamente no próprio leitor. No entanto, é mais simples e rápido definir uma ou duas transformações universais do MyQ do que alterar separadamente as configurações de cada leitor de cartões.

Como configurar a transformação de cartões:

Na guia “Configurações de autenticação do usuário”, na seção Cartões e na subseção Avançado, é possível definir e utilizar uma transformação para leitores de cartões e selecionar sua aplicação em um leitor USB conectado ao computador do administrador. O leitor USB pode ser utilizado para recarregar cartões de crédito ou associar cartões.

Observe que os comandos de transformação não são exibidos no log. Apenas o número completo do cartão, extraído do leitor, é mostrado. Assim que o processo de registro for concluído, o número do cartão transformado é armazenado no perfil do usuário.

Definindo a transformação

É possível definir a transformação adicionando comandos que podem ser encontrados na lista abaixo. Os comandos devem ser separados por um ponto-e-vírgula (;) e são lidos e executados da esquerda para a direita. Por exemplo, na transformação ComandoX;ComandoY, o Comando X é executado primeiro e o Comando Y, em segundo lugar.

Todos os comandos, exceto o comando +, são aplicados da seguinte maneira:

O primeiro comando da transformação e cada comando imediatamente após o comando + são aplicados ao número inicial do cartão. Todos os demais comandos são aplicados ao resultado de seus antecessores.

 Comandos de transformação de cartões de identificação

  • ltrim(número de caracteres) – Remove os primeiros X caracteres da esquerda.
    ltrim(2): 123456 —> 3456

  • rtrim(número de caracteres) – Remove os primeiros X caracteres da direita (os últimos X caracteres).
    rtrim(2): 123456 —> 1234

  • prepend(sequência de caracteres) – Adiciona a sequência de caracteres à frente do número do cartão.
    prepend(AB): 123456 —> AB123456

  • append(sequência de caracteres) – Adiciona a sequência de caracteres ao final do número do cartão.
    append(AB): 123456 —> 123456AB

  • left(número de caracteres) – Seleciona os primeiros X caracteres da esquerda (e remove o restante).
    left(2): 123456 —> 12

  • right(número de caracteres) – Seleciona os primeiros X caracteres a partir da direita.
    right(2): 123456 —> 56

  • mid(número de caracteres, número de caracteres) – Conte X caracteres a partir da esquerda e, em seguida, remova Y caracteres.
    mid(2,2): 123456 —> 1256

  • lpad(número de posições, símbolo) – Completa a sequência até o comprimento especificado pelo parâmetro número de posições, adicionando o valor do parâmetro símbolo à esquerda (à frente do número do cartão).
    lpad(12,0): 123456 —> 000000123456

  • hex2dec() – Converte o número do cartão do formato hexadecimal para o decimal.
    hex2dec(): 1000AB —> 1048747

  • dec2hex() – Converte o número do cartão do formato decimal para o formato hexadecimal.
    dec2hex(): 1048747 —> 1000AB

  • hex2bin – Converte o número do cartão do formato hexadecimal para o formato binário.
    hex2bin(): 1000AB —> 100000000000010101011

  • bin2hex – Converte o número do cartão do formato binário para o formato hexadecimal.
    bin2hex(): 100000000000010101011 —> 1000AB

  • dec2bin – Converte o número do cartão do modo decimal para o modo binário.
    dec2bin(): 100023 —> 11000011010110111

  • bin2dec – Converte o número do cartão do formato binário para o decimal.
    bin2dec(): 11000011010110111 —> 100023

  • reverse() – Inverte a sequência de bytes, ou seja, agrupa todos os caracteres em pares de dois e inverte a ordem desses pares. (O último par passa para o primeiro lugar, o penúltimo para o segundo, e assim por diante.)
    reverse(): 1234AB —> AB3412

  • reverseString() – Inverte a sequência de caracteres. (O último caractere passa para o primeiro lugar, o penúltimo para o segundo, etc.)
    reverseString(): 1234AB —> BA4321

  • reverseNibbleBits() – Converte cada caractere do modo hexadecimal para o modo binário, inverte a sequência de caracteres de cada quarteto e reconverte o resultado para o modo hexadecimal.
    reverseNibbleBits(): 10AB —> 0001 0000 1010 1011 —> 1000 0000 0101 1101 —> 805D

  • upper() – Converte a string para maiúsculas.
    upper(): Abcd —> ABCD

  • plugin(referência) – Chama um plugin de transformação de cartões com a referência fornecida. Esta opção permite o uso de scripts PHP personalizados para a transformação. Para obter mais informações sobre esta opção, entre em contato com o suporte do MyQ.

  • asciiCode2ascii – Converte caracteres ASCII codificados como dígitos hexadecimais em caracteres ASCII.
    asciiCode2ascii(): 414F —> AO

  • "string 1" + "string 2" – Une as strings à frente e atrás do comando +.
    "string 1":

    • O número inicial do cartão (caso não haja comandos precedendo o símbolo +),

    • ou o resultado do último comando antes do símbolo + (caso não haja comandos + precedendo o símbolo +),

    • ou o resultado do comando + anterior.
      “string 2”:

    • O número inicial do cartão (caso não haja comandos após o símbolo + ou caso o próximo comando seja outro comando +),

    • ou o resultado do último comando da transformação (caso não haja comandos + após o símbolo +),

    • ou o resultado do último comando antes de outro comando +.

Exemplo de transformação de cartão de identificação:

Número do cartão: 10AB

Transformação do código do cartão: hex2bin();lpad(16,0);reverseString();ltrim(8);reverseString();bin2hex() + ltrim(4);lpad(4,10AB)

Resultado: 1010AB

Processo de transformação:
(“10AB” —> “1 0000 1010 1011” —> “0001 0000 1010 1011” —> “1101 0101 0000 1000” —> “0000 1000” —> “0001 0000” —> “10”) + (“10AB” —> “” —> “10AB”) ==> “1010AB”

Excluir cartões

Caso tenha a permissão Excluir cartões atribuída a si, poderá excluir os cartões de outros usuários. Isso se destina, por exemplo, a situações em que uma organização possui uma recepção onde o(a) senhor(a) devolve seu cartão e este deve ser removido do sistema.

Para isso:

  1. Faça login e abra o Painel do MyQ.

  2. Clique na opção Excluir cartões….

  3. Insira o número do cartão de identificação (manualmente ou passando o cartão em um leitor conectado ao seu computador).

  4. Clique em Enter para pesquisar o cartão.

  5. Quando o usuário for encontrado, clique no X para excluir o cartão e, em seguida, salve as alterações.