Você especifica a conexão EIS gerenciada por componente durante o desenvolvimento de aplicativo e a configura durante a implementação do aplicativo.
Sobre Esta Tarefa
Ao criar um aplicativo Java™ EE
usando um ambiente de desenvolvimento do Rational ou do WebSphere,
você pode selecionar uma conexão de EIS gerenciada por componente ou gerenciada por
contêiner. A configuração da diretiva de autenticação na referência de recurso do
descritor de implementação do aplicativo como Aplicativo define seu aplicativo
para a conexão de EIS gerenciada por componente. Etapas semelhantes seriam usadas para outros recursos e outros IDEs.
O exemplo a seguir explica como verificar ou alterar essa configuração para um projeto EJB em um ambiente de desenvolvimento do Rational ou WebSphere:
Procedimento
- Configure o valor do elemento para Aplicativo.
- Na perspectiva J2EE, na visualização do Explorador de Projetos, expanda seu projeto EJB em Projetos EJB.
- Clique com o botão direito do mouse no Descritor de Implementação: your_EJB_project e selecione .
- Na visualização Descritor de Implementação do EJB, clique na guia Referências, expanda o nome do componente EJB usado por seu aplicativo e selecione a referência de recurso para o EJB. Ao selecionar a referência de recurso para o EJB, os campos à direita da visualização EJB Deployment Descriptor
são exibidos com valores.
- Selecione Aplicativo, caso ainda não esteja selecionado,
no campo Autenticação. Esse campo mapeia para o elemento <res-auth>.
- Feche o EJB Deployment Descriptor Editor e clique em Sim para
salvar as mudanças. O código a seguir é incluído no descritor de implementação do
aplicativo EJB:
<res-auth>Application</res-auth>
Normalmente, a conexão gerenciada por componente não requer mais
configurações, pois as informações de segurança são fornecidas pelo
aplicativo no objeto IMSConnectionSpec. Entretanto,
se o aplicativo não fornecer um objeto IMSConnectionSpec,
ou se o ID do usuário não for especificado no objeto IMSConnectionSpec
fornecido, o IMS TM
Resource Adapter obterá
os valores de segurança do connection factory usado pelo aplicativo.
- Se o componente de aplicativo não fornecer um ID de usuário ou
o ID de usuário fornecido for nulo ou espaços em branco, os valores de segurança padrão
serão usados. O valor padrão é fornecido no connection factory
e pode ser fornecido de duas formas:
- Especifique um alias de autenticação gerenciado por componente.
- Para usar um alias de autenticação gerenciado pelo componente, você deve definir
um alias de autenticação de JAAS.
- Na visualização Servidores, clique com o botão direito do mouse no servidor e selecione Executar Console Administrativo.
- Expanda Recursos e selecione Adaptadores de Recursos.
- Clique no adaptador de recursos que você deseja modificar.
- Em Propriedades Adicionais, clique em Connection Factories do J2C.
- Em Itens Relacionados, clique em Entradas de Dados de Autenticação do J2C.
- Acima da lista de alias, clique em Novo.
- Digite um nome de alias, seu ID de usuário, senha e uma descrição opcional.
Selecione OK.
- Selecione o alias de autenticação do JAAS para a propriedade de alias
gerenciado por componente do connection factory do J2C usado pelo
aplicativo. É possível selecionar o alias de autenticação do JAAS
ao criar o connection factory pela primeira vez ou posteriormente ao editar
o connection factory. Para editar o connection factory:
- No console administrativo do servidor, navegue até o
connection factory que deseja modificar selecionando .
- Na lista suspensa Alias de Autenticação Gerenciado por Componente,
selecione o alias de autenticação do JAAS a ser usado para autenticação gerenciada
por componente por aplicativos que usam esse connection factory.
- Selecione OK.
O ID do usuário e a senha associados ao alias de autenticação
gerenciado por componente são usados para configurar (ou substituir, se aplicável) os valores
padrão nas propriedades customizadas do connection factory associado durante a
inicialização do servidor de aplicativos.
- Defina os valores padrão nas propriedades customizadas do connection factory.
- Se você não designar um alias de autenticação do JAAS válido para o campo Alias de Autenticação Gerenciado por Componente de seu connection
factory do J2C, poderá designar valores para os campos userName, password e groupName
na página Propriedades Customizadas de seu connection factory do J2C.
- Para criar um connection factory, use a API do IMSConnectionSpec
para especificar as propriedades de conexão. É preferível usar um alias de autenticação gerenciado
por componente a especificar valores nas propriedades customizadas do
connection factory do J2C. O alias de autenticação gerenciado por componente
fornece mais segurança para o ID do usuário e para a senha, pois o nome do usuário
e os valores de senha de um alias de autenticação do JAAS são visíveis somente para
os administradores do servidor.
Resultados
O processo para configurar a conexão gerenciada por componente no
ambiente de teste de um IDE e o processo para configurar a conexão gerenciada por componente
em um WebSphere Application Server independente são semelhantes.