Certificados Digitais

A seguir são apresentados os passos para criação e distribuição do Certificado Digital de segurança para os serviços do Foundation Saúde. Será usada a ferramenta Keytool, distribuída junto com a instalação Java JDK.

Observação: A criação do certificado digital deve ser feita apenas para o uso dos serviços TISS. Os serviços do PTU devem utilizar o certificado fornecido pela Unimed do Brasil.

Contenedor de Certificados (keystore)

A keystore é um repositório de certificados. Na keystore configurada no Foundation Saúde, é possível instalar todos os certificados necessários para o funcionamento dos serviços disponibilizados pelo Foundation Saúde, como PTU Online, TISS e GPU.

Para criar o certificado, utilize o keytool e digite a seguinte linha de comando (cmd):

keytool -genkeypair -alias keystore -dname distinguished-name -keypass medical -keystore dir instalação do JBoss/jboss4.2.3.GA JBOSS_HOME/server/default/conf/server.keystore -storepass medical -validity 365

Os A seguir, a descrição das propriedades, onde os valores sublinhados devem ser substituidossubstituídos:

• • distinguished-name: De preferência em conformidade com a estrutura suportada pelo Keytoolkeytool. Detalhes sobre a ferramenta podem ser encontrados na documentação disponível em http://java.sun.com/javase/6/docs/technotes/tools/windows/keytool.html#DName.

As operadoras devem usar o nome da máquina hospedeira (host) no campo CN (Common Name), é o mesmo host nome utilizado na configuração do parâmetro “-b” para a publicação do sistema para acessos externos conforme o capítulo 5.1.-b, definido na configuração de acesso externo.

Segue abaixo um exemplo: 
CN = foundation foundation.dominio_operadora.com.br br 
OU = Totvs Saúde 
O = Totvs 
L = Joinville 
S = SC 
C = BR 

Estes atributos formam a o seguinte "string" texto para preenchimento do valor: “CN=foundation.dominio_operadora.com.br, OU=Totvs Saude,O=Totvs, L=Joinville, ST=SC, C=BR”. 
NotaAtenção: Lembre-se de usar aspas na linha de comando para strings textos com espaços.

• • -keypass: Senha para a chave do certificado digital. O valor padrão é medical.
  • -keystore: Caminho ou diretório onde serão criados o certificado, o arquivo contenedor de certificados, e o arquivo contenedor dos certicados válidos de clientes. O valor padrão é “c:\totvs\jboss-4.2.3.GA”o JBOSS_HOME.
  • -storepass: Senha para o arquivo contenedor de certificados. O valor padrão é medical.
  • -validity: Número de dias antes que o certificado se expire. O valor padrão é 365(1 ano);

Atenção: Verifique se o arquivo

...

server.keystore

...

 foi criado no diretório escolhido (-keystore).

...

Exemplos de criação do keystore server e client:

>keytool -genkeypair -alias keystore -dname "CN=LOCALHOST, OU=Totvs Saude,O=Totvs, L=Joinville, ST=SC, C=BR" -keypass medical -keystore "client.keystore" -storepass medical -validity 365

>keytool -genkeypair -alias keystore -dname "CN=LOCALHOST, OU=Totvs Saude,O=Totvs, L=Joinville, ST=SC, C=BR" -keypass medical -keystore "server.keystore" -storepass medical -validity 365

...

Criação do Certificado

Para extrair o certificado

...

da keystore digite a seguinte linha de comando (cmd) :

keytool -exportcert -alias keystore -file c:/totvs/jboss-4.2.3.GA/server/default/conf/certificate.

...

cer -keystore c:/totvs/jboss-4.2.3.GA/server/default/conf/keystore.keystore -storepass medical

...

A seguir, os detalhes de cada propriedade:

-
• • alias: Crie um alias para seu arquivo de chaves, esse nome será usado internamente. Valor padrão é “keystore”.
-
• • file: Caminho ou diretório onde serão criados o certificado, o arquivo contenedor de certificados, e o arquivo contenedor dos certicados válidos de clientes. O valor padrão é “c:/totvs/jboss-4.2.3.GA/server/default/conf/”.
-
• • storepass: Senha para o arquivo contenedor de certificados. O valor padrão é “medical”.

...

Atenção: Verifique se o arquivo “certificate.cer” foi criado no diretório escolhido (-file).

Exemplo de criação dos certificados:

>keytool -exportcert -alias keystore -file "c:/totvs/jboss-4.2.3.GA/server/default/conf/client.cer" -keystore "client.keystore" -storepass medical

>keytool -exportcert -alias keystore -file " c:/totvs/jboss-4.2.3.GA/server/default/conf /server.cer" -keystore "server.keystore" -storepass medical

...

Importação dos Certificados

Cada cliente autorizado a receber ou enviar mensagens "Web Service" deve fornecer seu arquivo de certificado pra ser adicionado à lista de clientes confiáveis.

...