From eea15b2b6ff4986a026aed712ad82e455639c779 Mon Sep 17 00:00:00 2001
From: Edmar Moretti <edmar.moretti@gmail.com>
Date: Wed, 17 May 2017 18:12:52 -0300
Subject: [PATCH] Atualização da documentação do SAIKU

---
 ferramentas/saiku/esquemaxml.php | 23 +++++++++++++++++------
 ferramentas/saiku/instal.txt     | 82 ++++++++++++++++++++++++++++++++++++++++++++++++----------------------------------
 2 files changed, 65 insertions(+), 40 deletions(-)

diff --git a/ferramentas/saiku/esquemaxml.php b/ferramentas/saiku/esquemaxml.php
index 91b6fbd..0e480bc 100755
--- a/ferramentas/saiku/esquemaxml.php
+++ b/ferramentas/saiku/esquemaxml.php
@@ -1,5 +1,16 @@
 <?php
-exit;
+/*
+Importante:
+
+A integração do SAIKU com o i3GEO é experimental.
+
+O SAIKU utiliza os arquivos de fonte de dados que sao criados de forma dinamica na pasta ms_tmp/saiku-datasources.
+Esses arquivos apontam para o arquivo XML com o esquema utilizado para construir os cubos, que tambem sao criados de forma dinamica.
+Como o SAIKU precisa ler esse arquivo XML, o mesmo deve ter permissoes de leitura de forma que o Apache consiga carregar esse arquivo XML.
+E importante destacar que ao fazer isso o arquivo xml fica exposto, o que pode permitir que um usuario qualquer tenha acesso a esse XML.
+Esse XML contem os SQL utilizados para acessar o banco de dados. Ao usar o SAIKU e necessario avaliar se essa caracteristica pode
+apresentar-se como um problema de seguranc
+*/
 //
 //utilize &output=xml para ver o xml
 //
@@ -11,7 +22,10 @@ exit;
  http://localhost/i3geo/ferramentas/saiku/esquemaxml.php?output=xml
  http://localhost/i3geo/ferramentas/saiku/esquemaxml.php?xmlesquema=&output=xml&regiao=1
  */
-
+//
+//remova essa linhas para poder usar o SAIKU
+//
+echo "Bloqueado. Consulte o administrador.";exit;
 //
 //quando o saiku e iniciado de fora do i3geo, e necessario inicializar um mapfile para uso como base dos mapas
 //
@@ -31,13 +45,10 @@ $nomeConexao = criaConexaoEsquema();
 $map_file = $_SESSION["map_file"];
 
 $arquivoXmlEsquema = dirname($map_file)."/".str_replace(".txt","",$nomeConexao).".xml";
-
 gravaDataSource();
-
 if(!empty($_GET["xmlesquema"])){
 	imprimeEsquema();
 }
-
 $m = new Metaestat();
 
 //
@@ -207,7 +218,7 @@ function criaConexaoEsquema(){
 	}
 	else{
 		$urlXmlEsquema = $_GET["xmlesquema"];
-		//cria um nome de arquivo reaproveitável
+		//cria um nome de arquivo reaproveitável
 		$nomeConexao = md5($_GET["xmlesquema"]);
 	}
 	//$arquivoXmlEsquema = dirname($map_file)."/".$nomeConexao.".xml";
diff --git a/ferramentas/saiku/instal.txt b/ferramentas/saiku/instal.txt
index e28536c..a8199a6 100755
--- a/ferramentas/saiku/instal.txt
+++ b/ferramentas/saiku/instal.txt
@@ -1,31 +1,33 @@
-Roteiro para instalação e configuração do SAIKU para uso com o i3Geo (testado no Ubuntu).
+Roteiro para instalação e configuração do SAIKU para uso com o i3Geo (testado no Ubuntu).
 
-Para mais informações veja em: http://docs.analytical-labs.com/
+Para mais informações veja em: http://docs.analytical-labs.com/
 
 Importante:
 
-	Por questões de segurança, modifique o arquivo de configuração do Apache incluindo as seguintes diretivas:
+	A integração do SAIKU com o i3GEO é experimental.
+
+	Por questões de segurança, modifique o arquivo de configuração do Apache incluindo as seguintes diretivas:
 
 		<Directory /var/www/ms_tmp/saiku-datasources>
 			Order Deny,Allow
 			Deny from All
 		</Directory>
 
-	No caso o texto "/var/www/ms_tmp" deve ser alterado para refletir as configurações do seu servidor, indicando corretamente a pasta temporária
+	No caso o texto "/var/www/ms_tmp" deve ser alterado para refletir as configurações do seu servidor, indicando corretamente a pasta temporária
 
 -------------------
 	Edite o arquivo
 
 	saiku-server/tomcat/webapps/saiku/WEB-INF/users.properties
-	
+
 	Para remover o usuario anonimo ou acrescentar novos usuarios
 -------------------
 
-Utilize uma das opções abaixo para instalar o servidor saiku-server
+Utilize uma das opções abaixo para instalar o servidor saiku-server
 
 1) Download do software diretamente de http://meteorite.bi/saiku/download
 
-		- Faça o download do SAIKU Server no endereço: http://meteorite.bi/saiku/download
+		- Faça o download do SAIKU Server no endereço: http://meteorite.bi/saiku/download
 
 		- Descompacte os arquivos em uma pasta em seu servidor (no Linux /var por exemplo)
 
@@ -35,14 +37,14 @@ Utilize uma das opções abaixo para instalar o servidor saiku-server
 
 				<Connector port="9090" protocol="HTTP/1.1"
 
-			e modifique o valor da porta se achar necessário
+			e modifique o valor da porta se achar necessário
 
 		- Fontes de dados
 
-			O i3Geo cria arquivos de fontes de dados em uma pasta temporária. Essa pasta é criada quando o i3Geo é inicializado.
-			(/tmp/ms_tmp/saiku-datasources por padrão)
+			O i3Geo cria arquivos de fontes de dados em uma pasta temporária. Essa pasta é criada quando o i3Geo é inicializado.
+			(/tmp/ms_tmp/saiku-datasources por padrão)
 
-			Para que o SAIKU veja essa pasta é necessário editar o arquivo
+			Para que o SAIKU veja essa pasta é necessário editar o arquivo
 
 			saiku-server/tomcat/webapps/saiku/WEB-INF/saiku-beans.xml
 
@@ -56,19 +58,19 @@ Utilize uma das opções abaixo para instalar o servidor saiku-server
 
 		- Arquivos alterados
 
-			Alguns dos códigos do SAIKU originais foram alterados. As alterações estão na pasta i3geo/ferramentas/saiku/saiku-server
-			O conteúdo dessa pasta deve ser copiado para a pasta onde o saiku for instalado (saiku-server)
+			Alguns dos códigos do SAIKU originais foram alterados. As alterações estão na pasta i3geo/ferramentas/saiku/saiku-server
+			O conteúdo dessa pasta deve ser copiado para a pasta onde o saiku for instalado (saiku-server)
+
+2) Download via Git do saiku-server com as alterações já realizadas
 
-2) Download via Git do saiku-server com as alterações já realizadas
+		Veja as orientações sobre uso do Git e sobre como obter o código do i3geo. A obtenção do código do saiku-server segue a mesma lógica, no entanto você deve usar como exemplo os comandos abaixo:
 
-		Veja as orientações sobre uso do Git e sobre como obter o código do i3geo. A obtenção do código do saiku-server segue a mesma lógica, no entanto você deve usar como exemplo os comandos abaixo:
-		
 		mkdir /var/saiku-server
 		cd /var/saiku-server
 		git -c http.sslVerify=false clone http://softwarepublico.gov.br/gitlab/i3geo/saiku-server.git .
-		chmod -R 766 /var/www/saiku-server
 
-Após a obtenção dos arquivos, inicialize o servidor
+
+Após a obtenção dos arquivos, inicialize o servidor
 
 	Procure na pasta saiku-server o programa start-saiku.bat (para Windows) ou start-saiku.sh para Linux.
 
@@ -80,42 +82,54 @@ Após a obtenção dos arquivos, inicialize o servidor
 
 		http://localhost:9090/
 
-	(Se aparecer a tela de login. Utilize admin como usuário e admin como senha)
+	(Se aparecer a tela de login. Utilize admin como usuário e admin como senha)
 
-Ajustes nas variáveis de inicialização do i3geo/ms_configura.php
+Ajustes nas variáveis de inicialização do i3geo/ms_configura.php
 
-	No arquivo i3geo/ms_configura.php existem duas variáveis que são utilizadas na integração com o SAIKU.
+	No arquivo i3geo/ms_configura.php existem duas variáveis que são utilizadas na integração com o SAIKU.
 
-	Edite esse arquivo caso seja necessário adaptar os parâmetros conforme suas necessidades.
+	Edite esse arquivo caso seja necessário adaptar os parâmetros conforme suas necessidades.
 
-	Observe principalmente o endereço de acesso ao SAIKU e os parâmetros de conexão com o banco de dados e tabela com a dimensão temporal
+	Observe principalmente o endereço de acesso ao SAIKU e os parâmetros de conexão com o banco de dados e tabela com a dimensão temporal
 
 Banco de dados
 
-	O banco de dados PostgreSQL a ser utilizado pode ser qualquer um já existente e que esteja cadastrado como uma conexão no
-	sistema de metadados estatísticos.
+	O banco de dados PostgreSQL a ser utilizado pode ser qualquer um já existente e que esteja cadastrado como uma conexão no
+	sistema de metadados estatísticos.
 
-	Esse banco deve ter as funções Postgis e deve também conter a tabela com a dimensão tempo.
+	Esse banco deve ter as funções Postgis e deve também conter a tabela com a dimensão tempo.
 
 	Essa tabela pode ser obtida fazendo-se o RESTORE do banco de dados default. Para obter o arquivo de backup utilize:
 
 	https://softwarepublico.gov.br/gitlab/i3geo/i3geosaude/blob/master/databasei3geosaude.backup
 
-	Por padrão, esse banco de ve ser restaurado em um DATABASE chamado "i3geosaude" com usuário "postgres" e senha "postgres"
+	Por padrão, esse banco de ve ser restaurado em um DATABASE chamado "i3geosaude" com usuário "postgres" e senha "postgres"
 
-	Se o banco de dados "i3geosaude" não for utilizado, apenas copie a tabela i3geo_metaestat.dim_tempo
-	para dentro do banco de dados que será utilizado
+	Se o banco de dados "i3geosaude" não for utilizado, apenas copie a tabela i3geo_metaestat.dim_tempo
+	para dentro do banco de dados que será utilizado
 
 
 
-Observação:
+Observação:
 
-Para testar o uso do SAIKU e aprender mais sobre sua instalação, dê preferência ao uso do arquivo de instalação do SVN
+Para testar o uso do SAIKU e aprender mais sobre sua instalação, dê preferência ao uso do arquivo de instalação do SVN
 e utilize o database i3geosaude.
 
-Após se assegurar que está tudo funcionando, faça os ajustes necessários.
+Após se assegurar que está tudo funcionando, faça os ajustes necessários.
 
-O banco de dados de administração do i3Geo, localizado em i3geo/admin/admin.db, contém as definições de variáveis que são compatíveis com
+O banco de dados de administração do i3Geo, localizado em i3geo/admin/admin.db, contém as definições de variáveis que são compatíveis com
 o banco de dados i3geosaude, permitindo o teste do funcionamento do SAIKU.
 
-Para acionar o SAIKU utilize o menu suspenso do i3Geo (item Análise).
+Para acionar o SAIKU utilize o menu suspenso do i3Geo (item Análise).
+
+Importante:
+
+Altere as permissões da pasta saiku-server de forma a impedir a escrita.
+
+O SAIKU utiliza os arquivos de fonte de dados que são criados de forma dinâmica na pasta ms_tmp/saiku-datasources.
+Esses arquivos apontam para o arquivo XML com o esquema utilizado para construir os cubos, que também são criados de forma dinâmica.
+Como o SAIKU precisa ler esse arquivo XML, o mesmo deve ter permissões de leitura de forma que o Apache consiga carregar esse arquivo XML.
+É importante destacar que ao fazer isso o arquivo xml fica exposto, o que pode permitir que um usuário qualquer tenha acesso a esse XML.
+Esse XML contém os SQL utilizados para acessar o banco de dados. Ao usar o SAIKU é necessário avaliar se essa característica pode
+apresentar-se como um problema de segurança
+
--
libgit2 0.21.2