MASTERSAF REDF SP · 2 Versão: 02. MASTERSAF REDF SP CONFIGURAÇÃO E CRIPTOGRAFIA ... Com o...

13
MASTERSAF REDF SP CONFIGURAÇÃO E CRIPTOGRAFIA

Transcript of MASTERSAF REDF SP · 2 Versão: 02. MASTERSAF REDF SP CONFIGURAÇÃO E CRIPTOGRAFIA ... Com o...

Page 1: MASTERSAF REDF SP · 2 Versão: 02. MASTERSAF REDF SP CONFIGURAÇÃO E CRIPTOGRAFIA ... Com o serviço do Tomcat parado, copiar o arquivo da aplicação “Redf.war” enviada para

MASTERSAF REDF SP CONFIGURAÇÃO E CRIPTOGRAFIA

Page 2: MASTERSAF REDF SP · 2 Versão: 02. MASTERSAF REDF SP CONFIGURAÇÃO E CRIPTOGRAFIA ... Com o serviço do Tomcat parado, copiar o arquivo da aplicação “Redf.war” enviada para

MASTERSAF REDF SP CONFIGURAÇÃO E CRIPTOGRAFIA

ÍNDICE

OBJETIVO ........................................................................................................................................................... 3

CONFIGURAÇÃO DO TOMCAT 5.5 .................................................................................................................. 3

PASSOS NECESSÁRIOS ............................................................................................................................... 3

CONFIGURANDO O SERVIDOR DE BANCO DE DADOS................................................................................. 9

SCRIPTS DDL ............................................................................................................................................. 9

INICIANDO A INSTALAÇÃO ...................................................................................................................... 9

CONFIGURANDO O MENU DO SISTEMA REDF ............................................................................................. 11

CONFIGURANDO O ACESSO AO MÓDULO ATRAVÉS DO MANAGER ......................................................... 11

INFORMAÇÕES ADICIONAIS........................................................................................................................... 11

VERIFICAÇÕES PÓS-INSTALAÇÃO ................................................................................................................ 12

SUPORTE TÉCNICO ........................................................................................................................................ 13

2

Versão: 02

Page 3: MASTERSAF REDF SP · 2 Versão: 02. MASTERSAF REDF SP CONFIGURAÇÃO E CRIPTOGRAFIA ... Com o serviço do Tomcat parado, copiar o arquivo da aplicação “Redf.war” enviada para

MASTERSAF REDF SP CONFIGURAÇÃO E CRIPTOGRAFIA

OBJETIVO

O Objetivo deste manual é orientar sobre os procedimentos necessários para realizar o processo de

configuração e criptografia do produto MASTERSAF REDF SP.

CONFIGURAÇÃO DO TOMCAT 5.5

Descompacte o arquivo REDF.ZIP e execute os procedimentos abaixo.

SERVIDOR/FUNCIONALIDADE NOME IP Tomcat /Redf <servidor:porta>

PASSOS NECESSÁRIOS

1) Com o serviço do Tomcat parado, copiar o arquivo da aplicação “Redf.war” enviada para a pasta

“webapps”.

Para configurar a conexão com o banco de dados são necessárias as seguintes informações:

PARÂMETROS

Usuário do Banco de Dados Senha do Usuário do Banco de Dados IP ou Nome do Host de Banco de Dados Porta de Acesso ao Banco de Dados Nome do Serviço do Banco de Dados (SID)

3

Versão: 02

Page 4: MASTERSAF REDF SP · 2 Versão: 02. MASTERSAF REDF SP CONFIGURAÇÃO E CRIPTOGRAFIA ... Com o serviço do Tomcat parado, copiar o arquivo da aplicação “Redf.war” enviada para

MASTERSAF REDF SP CONFIGURAÇÃO E CRIPTOGRAFIA

Os parâmetros “IP ou Nome do Host”, “Porta” e “Serviço” podem ser obtidos executando um

TNSPING para o alias de acesso ao banco de dados, conforme exemplo abaixo:

C:\>tnsping sbrhomo

TNS Ping Utility for 32-bit Windows: Version 9.2.0.1.0 - Production on 11-ABR-20

08 07:48:04

Copyright (c) 1997 Oracle Corporation. All rights reserved.

Arquivos de parâmetros usados:

Usado o adaptador TNSNAMES para resolver o apelido

Attempting to contact (DESCRIPTION = (ADDRESS_LIST = (ADDRESS = (PROTOCOL = TCP)

(HOST = SSPDTS010)(PORT = 1521))) (CONNECT_DATA = (SERVICE_NAME = REDF)))

OK (0 ms)

O SID do banco, neste exemplo, é o SBR.

Após obter os parâmetros, editar o arquivo “security-db.properties”, localizado em:

4

Versão: 02

Page 5: MASTERSAF REDF SP · 2 Versão: 02. MASTERSAF REDF SP CONFIGURAÇÃO E CRIPTOGRAFIA ... Com o serviço do Tomcat parado, copiar o arquivo da aplicação “Redf.war” enviada para

MASTERSAF REDF SP CONFIGURAÇÃO E CRIPTOGRAFIA

Modelo do Arquivo “security-db.properties”:

#Nome do Usuário do banco de dados

username=redf32

#Senha do usuário do banco de dados

#Esta senha deverá ser criptografada pela aplicação.

#Url para criptografia: http://nome_servidor_aplicação:porta/Redf/encrypt.jsp

password= j+NEPbycXjA=

#Nome ou IP do servidor do banco de dados

host=10.11.99.103

#Porta do servidor de banco de dados

port=1521

#Nome da instância do banco de dados

instance=msafprod

Alterar o atributo que permite acesso ao Banco de Dados:

Username=”Seu usuario do banco”

Password=”Senha CRIPTOGRAFADA de usuario do banco”

Host =”Nome (IP) do Servidor do Banco de Dados”

Port=”Porta do Servidor de Banco de Dados”

Instance=”Instância do Banco de Dados”

A url é composta pelos seguintes elementos e que devem ser preenchidos:

Host ou IP, seguido da Porta e do Serviço do Banco de Dados:

http://nome_servidor_aplicação:porta/Redf/encrypt.jsp

Para Criptografar a senha

5

Versão: 02

Page 6: MASTERSAF REDF SP · 2 Versão: 02. MASTERSAF REDF SP CONFIGURAÇÃO E CRIPTOGRAFIA ... Com o serviço do Tomcat parado, copiar o arquivo da aplicação “Redf.war” enviada para

MASTERSAF REDF SP CONFIGURAÇÃO E CRIPTOGRAFIA

2) Como Criptografar a senha do Banco de Dados:

3) Iniciar o serviço do Tomcat

Arquivo security-db.properties:

6

Versão: 02

Page 7: MASTERSAF REDF SP · 2 Versão: 02. MASTERSAF REDF SP CONFIGURAÇÃO E CRIPTOGRAFIA ... Com o serviço do Tomcat parado, copiar o arquivo da aplicação “Redf.war” enviada para

MASTERSAF REDF SP CONFIGURAÇÃO E CRIPTOGRAFIA

Inserir o endereço para ser gerada a senha criptografada, no caso do exemplo:

http://10.11.96.113:8080/Redf/pages/gerarSenha.jsf

Inserir a Senha do Banco de Dados

7

Versão: 02

Page 8: MASTERSAF REDF SP · 2 Versão: 02. MASTERSAF REDF SP CONFIGURAÇÃO E CRIPTOGRAFIA ... Com o serviço do Tomcat parado, copiar o arquivo da aplicação “Redf.war” enviada para

MASTERSAF REDF SP CONFIGURAÇÃO E CRIPTOGRAFIA

A Senha foi CRIPTOGRAFADA: j+NEPbycXjA=

A Senha deve ser copiada para ser adicionada no arquivo: security-db.properties.

8

Versão: 02

Page 9: MASTERSAF REDF SP · 2 Versão: 02. MASTERSAF REDF SP CONFIGURAÇÃO E CRIPTOGRAFIA ... Com o serviço do Tomcat parado, copiar o arquivo da aplicação “Redf.war” enviada para

MASTERSAF REDF SP CONFIGURAÇÃO E CRIPTOGRAFIA

CONFIGURANDO O SERVIDOR DE BANCO DE

DADOS

SCRIPTS DDL

Utilize o mesmo usuário de banco de dados do MASTERSAF para ser o owner da aplicação, com direitos

para criação dos objetos necessários: Tabelas, Sequences, Triggers, Packages, Views, Procedures e

Functions.

Deve, obviamente, possuir direitos de: insert, update, delete e select e/ou execute nos objetos criados.

Além destes, deve possuir acesso de Select às Tabelas e Views do MASTERSAF.

Antes de iniciarmos a instalação devemos ter pelo menos um conceito:

- O REDF gera os arquivos em uma pasta dentro do diretório do Oracle. Estes diretórios são

representados dentro do banco com um objeto assim como uma tabela, view etc...

Este objeto chama-se DIRECTORIES sendo que sua criação deve ser feita pelo usuário SYS do banco de

dados e concedidos direitos de READ e WRITE ao usuário MASTERSAF DW.

O mesmo deve apontar para um diretório físico no servidor onde está instalado o banco de dados. Para

saber o endereço deste diretório, caso não tenha acesso de visualização do mesmo, consulte o DBA.

INICIANDO A INSTALAÇÃO

1º - Antes de executar, altere o script “004_cria_diretorio.sql” que está dentro da pasta

“PROCEDURES” para refletir os diretórios correntes do Oracle. Estes diretórios serão utilizados na

geração dos arquivos de notas fiscais e ECFs.

Observação: Os Nomes dos Diretórios (Directory) deverão ser obrigatoriamente: REDF e ECFSMFD,

pois as: Packages, Procedures, etc..., “observarão” o diretório criado com esse nome.

9

Versão: 02

Page 10: MASTERSAF REDF SP · 2 Versão: 02. MASTERSAF REDF SP CONFIGURAÇÃO E CRIPTOGRAFIA ... Com o serviço do Tomcat parado, copiar o arquivo da aplicação “Redf.war” enviada para

MASTERSAF REDF SP CONFIGURAÇÃO E CRIPTOGRAFIA

2º - Dentro da pasta “PROCEDURES” executar o script “Install.sql”.

3º - Após executar o script “Install.sql”, verifique e altere a tabela RDF_PARAMETROS para que reflita

a infraestrutura da sua empresa.

Atenção: Se este próximo passo não for executado de forma adequada, o sistema irá criar os arquivos,

porém, não irá transferi-los para o diretório de Destino. (Lembrando que diretório de Destino ainda

deverá ser configurado dentro da aplicação REDF).

Esta configuração deve ser feita diretamente no banco de dados, pois não há interface para isto.

Onde:

DIR_ORACLE_METODO: Informe 1 se a sua aplicação trabalhar exclusivamente com rede interna, file

system. Informe 2 se a sua aplicação trabalhar exclusivamente com serviços de FTP.

DIR_ORACLE_HOST: Este parâmetro se refere ao endereço de FTP a ser utilizado e que deve,

obrigatoriamente, apontar para o diretório onde são criados os arquivos no Oracle.

DIR_ORACLE_PORTA: Utilize esta configuração apenas se o seu servidor de FTP obrigar a utilização de

uma porta. Na maioria dos casos esta informação não é preponderante.

DIR_ORACLE_USUARIO: Se refere ao usuário do FTP ou relacionado ao usuário de acesso à rede

interna.

DIR_ORACLE_SENHA: Senha de acesso ao FTP ou rede interna, file system.

DIR_ORACLE_CAMINHO: É o caminho onde se encontram os arquivos no FTP ou rede interna.

Observação: No caso de FTP, observar a correta sinalização dos diretórios, pois seguem um padrão

diferente do informado em redes Windows. Para validar, procure sempre

10

Versão: 02

Page 11: MASTERSAF REDF SP · 2 Versão: 02. MASTERSAF REDF SP CONFIGURAÇÃO E CRIPTOGRAFIA ... Com o serviço do Tomcat parado, copiar o arquivo da aplicação “Redf.war” enviada para

MASTERSAF REDF SP CONFIGURAÇÃO E CRIPTOGRAFIA

fazer um teste com um serviço de FTP, do DOS, por exemplo, para certificar-se de estar se conectando

com o usuário e senha corretos.

CONFIGURANDO O MENU DO SISTEMA REDF

Primeiro, abra o MASTERSAF DW e acesse o Módulo Segurança (Power Lock) para realizar a associação

dos usuários com o módulo REDF.

O usuário, administrador do MASTERSAF DW, deve acessar o sistema e inserir o módulo ao usuário.

Fazer a associação de regras para o Módulo REDF.

CONFIGURANDO O ACESSO AO MÓDULO

ATRAVÉS DO MANAGER

Edite o arquivo REDF.INI e altere o endereço da aplicação, conforme exemplo abaixo:

[parametros]

url=http://10.11.99.91:8081/Redf

Onde: 10.11.99.91:8081 corresponde ao endereço no qual o sistema foi instalado no Tomcat.

Mova os arquivos alterados: REDF.EXE e REDF.INI para o diretório de executáveis do MASTERSAF DW.

INFORMAÇÕES ADICIONAIS

Para que o usuário possa, através do REDF, visualizar o arquivo Nota Fiscal gerado no local

parametrizado, o mesmo precisa ter permissão no diretório.

11

Versão: 02

Page 12: MASTERSAF REDF SP · 2 Versão: 02. MASTERSAF REDF SP CONFIGURAÇÃO E CRIPTOGRAFIA ... Com o serviço do Tomcat parado, copiar o arquivo da aplicação “Redf.war” enviada para

MASTERSAF REDF SP CONFIGURAÇÃO E CRIPTOGRAFIA

VERIFICAÇÕES PÓS-INSTALAÇÃO

O processo de instalação disponibiliza um relatório completo sobre o estado dos objetos criados, mas

algumas verificações podem ser feitas para minimizar a possibilidade de erros durante a execução da

aplicação.

1) Estando com acesso ao banco de dados, a partir do plsqldeveloper ou sqlplus, execute o

comando abaixo:

SELECT * FROM USER_OBJECTS WHERE OBJECT_NAME LIKE 'RDF%' AND STATUS = 'INVALID';

Se o comando retornar alguma informação, indicando que algum objeto está inválido, verifique o

motivo, e se é passível de solução. Em caso de dúvida procure o suporte MASTERSAF para mais

ajuda.

2) Verifique se o arquivo CONTEXT.XML da aplicação no Tomcat foi alterado, conforme

documentação.

Se houver a necessidade de alterar o arquivo, não se esqueça de sempre restartar o serviço do

Tomcat, caso contrário, as informações não serão atualizadas pelo servidor de aplicação.

3) Verifique se as configurações do FTP e/ou File System foram corretamente preenchidas na

tabela RDF_PARAMETROS, não esquecendo que todos os valores de 1 a 6 devem ser

preenchidos, caso contrário, a aplicação não irá funcionar.

4) Ao abrir a aplicação, acesse o menu CONFIGURAÇÕES DE REGRAS -> DIRETÓRIOS E METODOS

DE ACESSO e configure o diretório para a empresa e estabelecimento, apontando o endereço

para onde serão enviados os arquivos gerados.

Obs.: Se esta informação não for informada, o sistema não funcionará e seus arquivos não

serão gerados.

12

Versão: 02

Page 13: MASTERSAF REDF SP · 2 Versão: 02. MASTERSAF REDF SP CONFIGURAÇÃO E CRIPTOGRAFIA ... Com o serviço do Tomcat parado, copiar o arquivo da aplicação “Redf.war” enviada para

MASTERSAF REDF SP CONFIGURAÇÃO E CRIPTOGRAFIA

SUPORTE TÉCNICO

Para dúvidas ou problemas, abra um chamado no Contact Center ou entre em contato com nossa equipe

de Suporte Técnico MASTERSAF pelo Telefone:

(11) 2159-0600 opção 01 (Atendimento das Soluções Fiscais).

Nosso horário de atendimento é de segunda à sexta-feira de 09h00min às 18h00min.

13

Versão: 02