Obrigatoriedade do objeto cooperativas

O objeto COOPERATIVAS, serve somente aos apps das Unimed, que possuem o novo cartão Unimed, homologado pela Unimed Brasil. A estrutura do objeto COOPERATIVAS, serve a carteirinha, no design de cores, nas informações do cartão e na construção do token de validação do beneficiário.

Estrutura objeto Cooperativas

"cooperativas": {
     "convenioAnsContratada": "999887",
     "layoutCartaoVirtual": "BENEFICIARIO",
     "seed": "LBKUMSDKOJKFUUSUJNIUYTSRGN4HKNSC",
     "unimedContratada": "Unimed de Exemplo Contratada",
     "nomeCartao": "NOME DO BENEFICIARIO",
     "nomeSocialCartao": "NOME SOCIAL DO BENEFICIARIO",
}

Combinados entre a Unimed e Mobile Saúde, para geração do token TOTP

Para geração do token TOTP, é necessário ter um seed, que é a chave secreta para geração do token. Como o seed é um dado sensível, é recomendado (mas não obrigatório) que seja criptografado. E descriptografado somente ao usa-lo para gerar o token TOTP. O seed pode ser qualquer valor, desde que seja representado em Base32.

Além do seed, é necessário escolher um algoritmo de encriptação, que pode ser sha1, sha256 e sha512. Também é necessário definir o tamanho do token a ser gerado, que pode ser de 6 a 8 dígitos. E o tempo de recarga (Ou período válido) do token gerado. Essas informações são importantes para geração e devem ser as mesmas tanto para a Unimed quanto para a Mobile Saúde.

Exemplo onde os dados de entrada são diferentes, mas o seed é o mesmo:

Nesse exemplo é utilizado o algoritmo sha-1.

Token TOTP com o período de 1800

Token TOTP com o período de 900

Atualmente, apenas o seed é repassado pelo objeto COOPERATIVAS e o algoritmo de encriptação, tamanho do token e o tempo de recarga, são configurados remotamente pela Mobile Saúde. Caso queira garantir que não haja inconsistências na geração do token, é necessário a inclusão do algoritmo de encriptação, o tamanho em dígitos do token e o tempo de recarga no objeto cooperativas, retornado no Login.

Exemplo:

Exemplo na geração do token

Site utilizado para validação do token: https://totp.danhersam.com