Objeto Cooperativas Unimed
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
Clique aqui para verificar as regras e estrutura para o objeto Cooperativas
Na documentação citada existe um exemplo de retorno da API - com sucesso, que mostra corretamente como deve ser o retorno para este objeto.
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:
PROPRIEDADE | TIPO | DESCRIÇÃO |
---|---|---|
algorithm | STRING | Algoritmo de encriptação, para geração do token. Podendo assumir os valores sha1, sha256 e sha512. |
digits | STRING | Quantidade de dígitos que o token poderá ter. Obrigatoriamente, é necessário ser de 6 a 8 dígitos. |
period | STRING | Período válido até que seja gerado um novo token. |
Exemplo na geração do token
Site utilizado para validação do token: https://totp.danhersam.com
Mobile Saúde - 2019