DocumentaçãoAEM 6.5 LTSGuia do usuário

Configuração do Armazenamento de Credenciais do Banco de Dados (com base no Elytron)

Última atualização: 24 de março de 2026
  • Aplica-se a:
  • Experience Manager 6.5 LTS

Criado para:

  • User
  • Admin
  • Developer

Configurar Repositório de Credenciais do Banco de Dados Usando Elytron

O JBoss EAP 8 usa armazenamentos de credenciais Elytron para gerenciar com segurança senhas de bancos de dados para implantações do AEM Forms. A Adobe fornece scripts automatizados para simplificar a criação e a configuração do armazenamento de credenciais baseado em Elytron no modo de domínio.

Esta instalação deve ser concluída antes de iniciar o Controlador de Domínio JBoss.

Pré-requisitos

  • O servidor JBoss deve ser completamente interrompido antes de executar o script de criação de repositório de credenciais.
  • A criação do repositório de credenciais deve ser executada somente no modo offline.

Para interromper o JBoss se ele estiver em execução:

  • Windows

    code language-none 
    <JBOSS_HOME>\bin\jboss-cli.bat --connect command=:shutdown

  • Linux/UNIX

    code language-none 
    <JBOSS_HOME>/bin/jboss-cli.sh --connect command=:shutdown

Baixar Scripts

Baixe o script apropriado com base no seu sistema operacional:

Nome do script
Sistema Operacional
create-elytron-cred-domain.bat
Windows
create-elytron-cred-domain.sh
Linux/UNIX

Para Linux, torne o script executável:

chmod +x create-elytron-cred-domain.sh

Etapas de configuração

Etapa 1: baixar e colocar o script

Baixe o script apropriado e coloque-o no seguinte diretório:

<JBOSS_HOME>/bin

Etapa 2: executar o script

  • Windows

    code language-none 
    cd <JBOSS_HOME>\bin
create-elytron-cred-domain.bat

  • Linux/UNIX

    code language-none 
    cd <JBOSS_HOME>/bin
./create-elytron-cred-domain.sh

Etapa 3: Fornecer As Informações Necessárias

Durante a execução, o script solicita as seguintes entradas:

  1. Caminho do JBOSS_HOME
    Insira o caminho completo para o diretório de instalação do JBoss.

  2. Nome do Arquivo de Configuração do Banco de Dados
    Insira uma das seguintes opções com base no seu banco de dados:

    • domain_oracle.xml
    • domain_mysql.xml
    • domain_mssql.xml

  3. Senha do Repositório de Credenciais
    Insira uma senha forte para proteger o armazenamento de credenciais.

    Esta senha fica oculta durante a entrada e deve ser lembrada para etapas posteriores.

  4. Senha do Banco de Dados
    Digite a senha da conexão real com o banco de dados.

Etapa 4: Execução e validação de script

O script executa as seguintes ações automaticamente:

  • Cria cred-store.p12 em:

    code language-none 
    <JBOSS_HOME>/domain/configuration/

  • Cria os seguintes aliases de credencial:

    • EncryptDBPassword
    • EncryptDBPassword_IDP_DS
    • EncryptDBPassword_EDC_DS
    • EncryptDBPassword_AEM_DS

  • Verifica se todos os aliases foram adicionados com êxito

A execução bem-sucedida confirma a criação do armazenamento de credenciais e a verificação de alias.

Etapa 5: Configurar Opções de JVM

Atualize a configuração de inicialização do domínio JBoss para fornecer a senha do armazenamento de credenciais.

  • Linux
    Editar:

    code language-none 
    <JBOSS_HOME>/bin/domain.conf

    Adicionar:

    code language-none 
    JAVA_OPTS="$JAVA_OPTS -DCS_PASS=YourCredStorePassword"

  • Janelas
    Editar:

    code language-none 
    <JBOSS_HOME>/bin/domain.conf.bat

    Adicionar:

    code language-none 
    set "JAVA_OPTS=%JAVA_OPTS% -DCS_PASS=YourCredStorePassword"

Substitua YourCredStorePassword pela senha inserida durante a criação do repositório de credenciais.

Os arquivos de configuração de domínio fazem referência a esse valor usando a variável ${CS_PASS}.

Etapa 6: verificar configuração de domínio

Abra o arquivo de configuração de domínio do banco de dados:

<JBOSS_HOME>/domain/configuration/<domain_*.xml>

Verifique se as fontes de dados fazem referência ao armazenamento de credenciais Elytron:

<security>
    <user-name>your_database_username</user-name>
    <credential-reference store="db-creds" alias="EncryptDBPassword_IDP_DS"/>
</security>

Cada fonte de dados usa um alias específico:

  • IDP_DS: EncryptDBPassword_IDP_DS
  • EDC_DS: EncryptDBPassword_EDC_DS
  • AEM_DS: EncryptDBPassword_AEM_DS
  • DefaultDS / ExampleDS: EncryptDBPassword

Todos os aliases fazem referência à mesma senha do banco de dados armazenada no armazenamento de credenciais.

NOTE
  • Copie o arquivo de armazenamento de credenciais (cred-store.p12) criado no principal para cada nó subordinado.
recommendation-more-help
experience-manager-65-lts-help-main-toc