MASTERSAF REDF SP · 2 Versão: 02. MASTERSAF REDF SP CONFIGURAÇÃO E CRIPTOGRAFIA ... Com o...
Transcript of MASTERSAF REDF SP · 2 Versão: 02. MASTERSAF REDF SP CONFIGURAÇÃO E CRIPTOGRAFIA ... Com o...
MASTERSAF REDF SP CONFIGURAÇÃO E CRIPTOGRAFIA
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
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
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
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
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
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
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
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
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
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
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
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