Índice
| Índice |
|---|
| maxLevel | 4 |
|---|
| outline | true |
|---|
| exclude | .*ndice |
|---|
| style | none |
|---|
|
Objetivo
Este guia tem como finalidade demonstrar os passos necessários para realizar a encriptação sobre a senha de acesso ao banco de dados.
| Nota |
|---|
Esse procedimento pode ser realizado para encriptação da senha de todos os bancos de dados homologados pela matriz de portabilidade do fluig. |
Encriptação de senha
A encriptação de senha do banco de dados do fluig é um procedimento muito importante, para evitar o acesso não autorizado à base de dados e com isso aumentar a segurança das suas informações.
Para realizar esse procedimento, é necessário seguir as etapas abaixo, que consistem em gerar a senha criptografada e, em seguida, criar a política de autenticação da aplicação com essa senha.
Encriptação da senha da base de dados (DataSource)
Nessa etapa, a senha da base de dados é encriptada usando o método principal da classe SecureIdentityLoginModule, passando como parâmetro a senha em texto plano do banco de dados utilizado. Para fazer a configuração, siga os passos abaixo:
| Painel |
|---|
| Deck of Cards |
|---|
| | Card |
|---|
| Navegue até a pasta raiz do fluig, e acesse a pasta appserver. Linux ==> /opt/fluig/appserver Windows ==> c:\fluig\appserver |
| Card |
|---|
| Gere a senha encriptada. Linux:
java -cp modules/system/layers/base/org/jboss/logging/main/jboss-logging-3.3.0.Final.jar:modules/system/layers/base/org/picketbox/main/picketbox-4.9.6.Final.jar org.picketbox.datasource.security.SecureIdentityLoginModule senha#do#banco@123! Windows:
java -cp modules/system/layers/base/org/picketbox/main/picketbox-4.9.6.Final.jar org.picketbox.datasource.security.SecureIdentityLoginModule senha#do#banco@123!
| Nota |
|---|
Neste caso senha#do#banco@123!, será a senha de acesso ao banco de dados, e o resultado será: Encoded password: -73d03118655333edb6cf7435bc02950441a847c51697cc6c |
|
|
|
Criar a política de autenticação da aplicação com a senha encriptada
Nessa etapa é mostrado onde fica o arquivo de configuração para acesso ao banco de dados (domain.xml), a aplicação da política de autenticação pelo aplicativo e a sua respectiva configuração.
| Nota |
|---|
|
Antes de fazer qualquer alteração, é importante manter uma cópia do arquivo domain.xml original, caso seja necessário retornar alguma configuração. |
| Painel |
|---|
| Deck of Cards |
|---|
| | Card |
|---|
| Navegue até a pasta raiz de instalação do fluig. Depois vá até a pasta de configuração onde está o arquivo domain.xml. Abra esse arquivoem modo administrador ou root.
Linux ==> /opt/fluig/appserver/domain/configuration Windows ==> c:\fluig\appserver\domain\configuration |
| Card |
|---|
| Edite o arquivo domain.xml incluindo o bloco que contém a política de autenticação e a senha encriptada gerada na etapa anterior. Ao abrir o arquivo domain.xml, procurar pela tag: | Bloco de código |
|---|
| <subsystem xmlns="urn:jboss:domain:security:1.2"> |
Dentro da tag <security-domains> deve-se inserir os seguintes blocos: | Bloco de código |
|---|
| language | xml |
|---|
| title | A partir da versão 1.6.5-190514 |
|---|
| <security-domain name="encrypted-FluigDS" cache-type="default">
<authentication>
<login-module code="org.picketbox.datasource.security.SecureIdentityLoginModule" flag="required">
<module-option name="username" value="admin"/><!-- usuário do banco -->
<module-option name="password" value="-73d03118655333edb6cf7435bc02950441a847c51697cc6c"/>
<!-- senha encriptada -->
<module-option name="managedConnectionFactoryName" value="jboss.jca:service=LocalTxCM,name=FluigDS"/>
</login-module>
</authentication>
</security-domain>
<security-domain name="encrypted-FluigDSRO" cache-type="default">
<authentication>
<login-module code="org.picketbox.datasource.security.SecureIdentityLoginModule" flag="required">
<module-option name="username" value="admin"/><!-- usuário do banco -->
<module-option name="password" value="-73d03118655333edb6cf7435bc02950441a847c51697cc6c"/>
<!-- senha encriptada -->
<module-option name="managedConnectionFactoryName" value="jboss.jca:service=NoTxCM,name=FluigDSRO"/>
</login-module>
</authentication>
</security-domain>
<security-domain name="encrypted-AppDS" cache-type="default">
<authentication>
<login-module code="org.picketbox.datasource.security.SecureIdentityLoginModule" flag="required">
<module-option name="username" value="admin"/><!-- usuário do banco -->
<module-option name="password" value="-73d03118655333edb6cf7435bc02950441a847c51697cc6c"/>
<!-- senha encriptada -->
<module-option name="managedConnectionFactoryName" value="jboss.jca:service=NoTxCM,name=AppDS"/>
</login-module>
</authentication>
</security-domain> |
| Bloco de código |
|---|
| language | xml |
|---|
| title | Até a versão 1.6.5-190507 |
|---|
| <security-domain name="encrypted-FluigDS" cache-type="default">
<authentication>
<login-module code="org.picketbox.datasource.security.SecureIdentityLoginModule" flag="required">
<module-option name="username" value="admin"/><!-- usuário do banco -->
<module-option name="password" value="-73d03118655333edb6cf7435bc02950441a847c51697cc6c"/>
<!-- senha encriptada -->
<module-option name="managedConnectionFactoryName" value="jboss.jca:service=LocalTxCM,name=FluigDS"/>
</login-module>
</authentication>
</security-domain>
<security-domain name="encrypted-FluigDSRO" cache-type="default">
<authentication>
<login-module code="org.picketbox.datasource.security.SecureIdentityLoginModule" flag="required">
<module-option name="username" value="admin"/><!-- usuário do banco -->
<module-option name="password" value="-73d03118655333edb6cf7435bc02950441a847c51697cc6c"/>
<!-- senha encriptada -->
<module-option name="managedConnectionFactoryName" value="jboss.jca:service=NoTxCM,name=FluigDSRO"/>
</login-module>
</authentication>
</security-domain>
|
Os atributos security-domain name, serão usados posteriormente na configuração de acesso ao banco de dados. |
| Card |
|---|
|
Edite o arquivo domain.xml alterando o bloco de acesso ao banco de dados. Ao abrir o arquivo, procure pelas tags: | Bloco de código |
|---|
| language | xml |
|---|
| title | A partir da versão 1.6.5-190514 |
|---|
| <subsystem xmlns="urn:jboss:domain:datasources:4.0">
<datasources>
<datasource enabled="true" jndi-name="java:/jdbc/FluigDS" jta="true" pool-name="FluigDS" use-java-context="false">
<datasource enabled="true" jndi-name="java:/jdbc/FluigDSRO" jta="false" pool-name="FluigDSRO" use-java-context="false">
<datasource enabled="true" jndi-name="java:/jdbc/AppDS" jta="false" pool-name="AppDS" use-java-context="false"> |
| Bloco de código |
|---|
| language | xml |
|---|
| title | Até a versão 1.6.5-190507 |
|---|
| <subsystem xmlns="urn:jboss:domain:datasources:4.0">
<datasources>
<datasource enabled="true" jndi-name="java:/jdbc/FluigDS" jta="true" pool-name="FluigDS" use-java-context="false">
<datasource enabled="true" jndi-name="java:/jdbc/FluigDSRO" jta="false" pool-name="FluigDSRO" use-java-context="false">
|
No primeiro datasource cujo pool-name é FluigDS, deve-se eliminar o seguinte bloco: | Bloco de código |
|---|
| <security>
<user-name>admin</user-name>
<password>senhaDeTextoPlano</password>
</security> |
Após remover o bloco acima, substituí-lo pelo bloco abaixo: | Bloco de código |
|---|
| <security>
<security-domain>encrypted-FluigDS</security-domain>
</security> |
No segundo datasource cujo pool-name é FluigDSRO, deve-se eliminar o seguinte bloco: | Bloco de código |
|---|
| <security>
<user-name>admin</user-name>
<password>senhaDeTextoPlano</password>
</security> |
Após remover o bloco acima, substituí-lo pelo bloco abaixo. | Bloco de código |
|---|
| <security>
<security-domain>encrypted-FluigDSRO</security-domain>
</security> |
A partir da versão 1.6.5-190514 No terceiro datasource cujo pool-name é AppDS, deve-se eliminar o seguinte bloco: | Bloco de código |
|---|
| <security>
<user-name>admin</user-name>
<password>senhaDeTextoPlano</password>
</security> |
Após remover o bloco acima, substituí-lo pelo bloco abaixo. | Bloco de código |
|---|
| <security>
<security-domain>encrypted-AppDS</security-domain>
</security> |
|
|
|
Pronto!
Após estes procedimentos, o fluig pode ser iniciado e passa a operar com a senha do banco encriptada, evitando acessos não autorizados e trazendo mais segurança para as suas informações.