Essa é uma revisão anterior do documento!
Procedimento para instalar guacamole no FreeBSD autenticando em uma Base Postgres
Links de auxílio:
https://guacamole.apache.org/doc/0.9.12-incubating/gug/jdbc-auth.html
https://wiki.freebsd.org/Ports/www/guacamole-client
https://dlcdn.apache.org/guacamole/1.5.0/binary/
https://guacamole.apache.org/doc/gug/jdbc-auth.html
http://guacamole.incubator.apache.org/releases/1.5.0/
1 - Atualizar o pkg e ports, vamos vão ser usados nesta instalação:
# pkg update # portsnap fetch extract
2 - Após atualizá-los vamos instalar todo o pacote do guacamole client e guacamole server pelo ports:
– GuacamoleClient
# cd /usr/ports/www/guacamole-client/ # make install clean BATCH=yes
– GuacamoleServer
# cd /usr/ports/net/guacamole-server/ # make install clean BATCH=yes
OBS: Caso receba uma mensagem de erro no final da instalação tanto do guacamole cliente, quando do guacamole server informando que já existe uma versão deles 1.4 instalados, efetue a atualização da instalação com o comando make reinstall, pois essa instalação pelo ports está instalando a versão 1.5, que é superior a 1.4.
3 - Após a instalação do passo 2, vamos ativar os serviços no /etc/rc.conf:
# # /usr/local/etc/rc.d/guacd enable guacd enabled in /etc/rc.conf # /usr/local/etc/rc.d/tomcat9 enable tomcat9 enabled in /etc/rc.conf # /usr/local/etc/rc.d/guacd start Starting guacd. guacd[97574]: INFO: Guacamole proxy daemon (guacd) version 1.4.0 started # /usr/local/etc/rc.d/tomcat9 start Starting tomcat9.
4 - Agora vamos precisar instalar o Banco de Dados Postgres, caso ainda não tenha instalado, pode clicar no link e seguir as instruções abaixo:
LINK: Instalação do Postgres
5 - Após o passo 4, vamos entrar no diretório /usr/local/etc/guacamole-client/ e criar dois novos diretórios :
# cd /usr/local/etc/guacamole-client/ # mkdir lib # mkdir extensions
6 - Agora vamos entrar no diretório extensions e fazer o download do guacamole-auth-jdbc do nosso banco, que no caso é o Postgres:
Link para download:
https://guacamole.apache.org/releases/
https://dlcdn.apache.org/guacamole/
# cd extensions # fetch https://dlcdn.apache.org/guacamole/1.5.0/binary/guacamole-auth-jdbc-1.5.0.tar.gz guacamole-auth-jdbc-1.5.0.tar.gz 30 MB 231 MBps 00s
7 - Vamos extrair e executar alguns passos. Segue abaixo:
# tar -jxvf guacamole-auth-jdbc-1.5.0.tar.gz
# cd guacamole-auth-jdbc-1.5.0 # cd postgresql/ # ll total 10537 -rw-r--r-- 1 1000 1000 10774697 Feb 13 21:17 guacamole-auth-jdbc-postgresql-1.5.0.jar drwxr-xr-x 3 1000 1000 5 Jul 21 2021 schema/
8 - Vamos copiar o arquivo guacamole-auth-jdbc-postgresql-1.5.0.jar, para o diretório /usr/local/etc/guacamole-client/extensions:
# cp guacamole-auth-jdbc-postgresql-1.5.0.jar /usr/local/etc/guacamole-client/extensions/
9 - Copie o driver JDBC do seu banco de dados para o diretório /usr/local/etc/guacamole-client/lib. Primeiro vamos ter que fazer o download no seguinte link:
Link para download: https://jdbc.postgresql.org/download/
# cd /usr/local/etc/guacamole-client/lib/ # fetch https://jdbc.postgresql.org/download/postgresql-42.6.0.jar postgresql-42.6.0.jar 1056 kB 3940 kBps 00s
10 - Depois de todos os passos acima, vamos criar o banco do guacamole. Siga os passos abaixo:
– Entre no banco :
# su - postgres $
– Entre no diretório /usr/local/etc/guacamole-client/extensions/guacamole-auth-jdbc-1.5.0/postgresql/ :
$ cd /usr/local/etc/guacamole-client/extensions/guacamole-auth-jdbc-1.5.0/postgresql/ $
– Liste o diretório schema e veja se os arquivos abaixo estão no seu interior:
$ ls -l schema/ total 22 -rw-r--r-- 1 1000 1000 21749 Jul 21 2021 001-create-schema.sql -rw-r--r-- 1 1000 1000 2699 Jul 21 2021 002-create-admin-user.sql drwxr-xr-x 2 1000 1000 10 Jul 21 2021 upgrade
– Crie o banco e após a criação do banco:
$ createdb guacamole_db $
–vamos popular a base:
$ cat schema/*.sql | psql -d guacamole_db -f - CREATE INDEX CREATE TABLE CREATE INDEX INSERT 0 1 INSERT 0 1 INSERT 0 6 INSERT 0 3 $
– Vamos entrar no banco criado:
$ psql -d guacamole_db psql (15.1) Type "help" for help. guacamole_db=#
–Vamos criar o acesso ao bando do Guacamole:
guacamole_db=# CREATE USER guacamole_user WITH PASSWORD 'some_password'; CREATE ROLE guacamole_db=# GRANT SELECT,INSERT,UPDATE,DELETE ON ALL TABLES IN SCHEMA public TO guacamole_user; GRANT guacamole_db=# GRANT SELECT,USAGE ON ALL SEQUENCES IN SCHEMA public TO guacamole_user; GRANT guacamole_db=# \q $
11 - Vamos configurar o Guacamole para autenticação ao banco. Vamos criar o arquivo guacamole.properties dentro de /usr/local/etc/guacamole-client:
# cd /usr/local/etc/guacamole-client # cp guacamole.properties.sample guacamole.properties
–Vamos editar o arquivo guacamole.properties e acrescentar as linhas abaixo:
# ee guacamole.properties # PostgreSQL properties postgresql-hostname: localhost postgresql-database: guacamole_db postgresql-username: guacamole_user postgresql-password: some_password
12 - Após isto, vamos reiniciar os três serviços instalados e efeutar os testes:
–Postgres
# /usr/local/etc/rc.d/postgresql restart 2023-03-31 23:17:48.347 -03 [99440] LOG: ending log output to stderr 2023-03-31 23:17:48.347 -03 [99440] HINT: Future log output will go to log destination "syslog".
–Guacd
# /usr/local/etc/rc.d/guacd restart Stopping guacd. Waiting for PIDS: 97576. Removing stale pidfile. Starting guacd. guacd[99473]: INFO: Guacamole proxy daemon (guacd) version 1.4.0 started
–Tomcat9
# /usr/local/etc/rc.d/tomcat9 restart Stopping tomcat9. Waiting for PIDS: 97590. Starting tomcat9.
13 - Após todos esses passos, vamos testar o serviço. Abra seu navegador com o seu ip, porta 8080/guacamole. Segue exemplo abaixo:
14 - Agora vamos ativar o serviço SSL/TLS para adicionar mais uma camada de segurança:
– O primeiro passo é gerar um keystore, exemplo abaixo:
# keytool -genkey -keystore /usr/local/etc/guacamole_keystore -alias tomcat -keyalg RSA -keysize 4096 -validity 720
Esse comando é usado para gerar um novo par de chaves de criptografia e criar um arquivo de armazenamento de chaves, também conhecido como keystore, que será usado para configurar o HTTPS no servidor Guacamole.
–Aqui está o que cada parte do comando faz:
keytool: é o utilitário de linha de comando Java que permite gerenciar certificados, chaves e keystores.
-genkey: indica que você deseja gerar um novo par de chaves de criptografia.
-keystore: especifica o nome e local do arquivo de armazenamento de chaves que será criado.
/usr/local/etc/guacamole_keystore: é o caminho e o nome do arquivo de armazenamento de chaves a ser criado.
-alias: especifica o nome que será usado para identificar a chave no keystore.
tomcat: é o nome do alias escolhido para identificar a chave no keystore.
-keyalg: especifica o algoritmo de criptografia a ser usado para gerar a chave.
RSA: é o algoritmo de criptografia escolhido para gerar a chave.
-keysize: especifica o tamanho da chave em bits.
4096: é o tamanho da chave escolhido para a chave.
-validity: especifica o período de validade da chave em dias.
720: é o período de validade escolhido para a chave, em dias.
15 - Você precisará fornecer uma senha no início e no final do procedimento Nr 14, fora que será necessário fornecer algumas informações. Segue o exemplo que eu fiz:
Enter keystore password: Re-enter new password: What is your first and last name? [Unknown]: SALADECOMANDO What is the name of your organizational unit? [Unknown]: SALADECOMANDO What is the name of your organization? [Unknown]: SALADECOMANDO What is the name of your City or Locality? [Unknown]: Macapa What is the name of your State or Province? [Unknown]: Amapa What is the two-letter country code for this unit? [Unknown]: AP Is CN=SALADECOMANDO, OU=SALADECOMANDO, O=SALADECOMANDO, L=Macapa, ST=Amapa, C=AP correct? [no]: yes Enter key password for <tomcat> (RETURN if same as keystore password): Re-enter new password: Warning: The JKS keystore uses a proprietary format. It is recommended to migrate to PKCS12 which is an industry standard format using "keytool -importkeystore -srckeystore /usr/local/etc/guacamole_keystore -destkeystore /usr/local/etc/guacamole_keystore -deststoretype pkcs12".
=== 16 - Vamos configurar o arquivo server.xml que fica localizado em “/usr/local/apache-tomcat-9.0/conf/”, incluir as informações do keystore e alterar as configurações do servidor. Segue abaixo:
# cd /usr/local/apache-tomcat-9.0/conf/ # ee server.xml
– Vamos acrescentar as configurações do servidor:
<Connector port="8443" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" SSLEnabled="true" scheme="https" secure="true" sslProtocol="TLS" keystoreFile="/usr/local/etc/guacamole_keystore" keystorePass="senha_da_keystore" />
– Após adicionar as linhas de configurações, comente ou apague as linhas da configuração anterior:
<!-- <Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" /> -->
– No meu caso, eu só comentei. Feche e salve as alterações:
Deixe sua contribuição