Configurações de Connection Factories J2C

Utilize esta página para especificar definições para uma Connection Factory.

É possível acessar esta página do console administrativo de uma das seguintes formas:
  • Recursos > Adaptadores de Recursos > Connection Factories J2C > connection_factory_J2C
  • Recursos > Adaptadores de Recursos > Adaptadores de Recursos > adaptador_de_recursos > Connection Factories J2C > connection_factory_J2C

Escopo

Especifica o escopo do adaptador de recursos que conecta aplicativos a um EIS (Enterprise Information System) através dessa connection factory. Somente os aplicativos instalados com esse escopo podem utilizar essa connection factory.

Provedor

Especifica o adaptador de recursos que o WebSphere Application Server utiliza para esse connection factory.

Só é possível selecionar provedor ao criar um novo connection factory. A lista mostra todos os adaptadores de recursos existentes definidos no escopo relevante. Selecione um na lista se quiser utilizar um adaptador de recursos existente como Provedor.

Criar Novo Provedor

Fornece a opção de configurar um novo adaptador de recursos para a nova connection factory.

Criar Novo Provedor é exibido somente quando você cria, em vez de editar uma connection factory.

Clicar em Criar Novo Provedor aciona o console para exibir a página de configuração do adaptador de recursos, onde você cria o novo adaptador. Após clicar em OK para salvar suas configurações, você consulta a página de coleção de connection factory. Clique em Novo para definir uma nova connection factory para utilização com o novo adaptador de recursos; o console agora exibe uma página de configuração que lista o adaptador de recursos como o novo Provedor de connection factory.

Nome

Especifica o nome deste Connection Factory.

Essa é uma propriedade requerida.

Informações Valor
Tipo de D]ados Sequência de Caracteres

Nome de JNDI

Especifica o nome JNDI desta fábrica de conexões.

Por exemplo, o nome pode ser eis/myECIConnection.

Depois de definir esse valor, salve-o e inicie novamente o servidor. Esta cadeia poderá ser vista ao executar a ferramenta dumpNameSpace. Esta é uma propriedade obrigatória. Se não for selecionado um nome JNDI, ele será preenchido, por padrão, usando o campo Nome.

Informações Valor
Tipo de D]ados Sequência de Caracteres
Default eis/nome de exibição
Importante: Siga estes requisitos para os nomes JNDI:
  • Não atribua nomes de JNDI duplicados entre tipos de recursos diferentes (como origens de dados versus connection factories J2C ou connection factories JMS).
  • Não atribua nomes de JNDI duplicados para vários recursos do mesmo tipo no mesmo escopo.

Description

Especifica uma descrição de texto desta fábrica de conexões.

Informações Valor
Tipo de D]ados Sequência de Caracteres

Interface do Connection Factory

Especifica o nome completo das Interfaces de Connection Factory suportadas pelo adaptador de recursos.

Esta é uma propriedade obrigatória. Para novos objetos, a lista de classes disponíveis é fornecida pelo adaptador de recursos em uma lista drop-down. Depois de criar a connection factory, o campo será um campo de texto de leitura.

Informações Valor
Tipo de D]ados Lista drop-down ou texto

Category

Especifica uma cadeia que pode ser utilizada para classificar ou agrupar esta fábrica de conexões.

Informações Valor
Tipo de D]ados Sequência de Caracteres

Alias de Autenticação para Recuperação XA

Especifica o alias de autenticação usado durante o processamento de recuperação de XA. Se esse nome de alias for alterado após uma falha do servidor, o processamento de recuperação XA subsequente utilizará a configuração original que estava em vigor antes da falha.

Selecione um alias na lista.

Para definir um novo alias que não é exibido na lista:
  1. Clique em Aplicar. Em Itens Relacionados, agora você vê uma listagem de entradas de dados de autenticação Java™ Platform, Enterprise Edition (Java EE) Connector Architecture (J2C).
  2. Clique em JAAS - Dados de Autenticação do J2C.
  3. Clique em Novo.
  4. Defina um alias.
  5. Clique em OK e em Salvar. Agora, o console exibe uma página de coleção de alias que lista todos os aliases configurados. Sobre a tabela, essa página também exibe o nome do connection factory na trilha de navegação.
  6. Clique no nome de sua connection factory J2C para retornar para a página de configuração para a connection factory que está sendo criada.
  7. Selecione o novo alias na lista de aliases de autenticação gerenciada por contêiner.
  8. Clique em Aplicar.

Se o adaptador de recursos não suportar transações XA, esse campo não será exibido. O valor padrão é derivado do alias selecionado para autenticação do aplicativo, caso algum seja especificado.

Se tiver definido diversos domínios de segurança e diversos aliases de autenticação no servidor de aplicativos, poderá clicar em Procurar... para selecionar um alias de autenticação para o recurso que está sendo configurado. Os domínios de segurança permitem isolar aliases de autenticação entre servidores. A visualização em árvore é útil na determinação do domínio de segurança ao qual um alias pertence e, além disso, ela pode ajudar a determinar os servidores que poderão acessar cada alias de autenticação. A visualização em árvore é adaptada para cada recurso, portanto domínios e aliases ficam ocultos quando não é possível utilizá-los.

O botão Procurar estará acessível apenas se, pelo menos, um domínio de segurança for definido e um escopo designado, o que se aplica ao recurso que está sendo editado. Além disso, o domínio de segurança em questão deve conter pelo menos um alias de autenticação J2C JAAS.

Informações Valor
Tipo de D]ados Lista suspensa

Alias de Autenticação Gerenciado por Componente

Especifica os dados de autenticação para conexão ao recurso gerenciada por componente.

Selecione um alias na lista.

Para definir um novo alias que não é exibido na lista:
  1. Clique em Aplicar. Em Itens Relacionados, agora você vê uma listagem de entradas de dados de autenticação Java Platform, Enterprise Edition (Java EE) Connector Architecture (J2C).
  2. Clique em JAAS - Dados de Autenticação do J2C.
  3. Clique em Novo.
  4. Defina um alias.
  5. Clique em OK e em Salvar. Agora, o console exibe uma página de coleção de alias que lista todos os aliases configurados. Sobre a tabela, essa página também exibe o nome do connection factory na trilha de navegação.
  6. Clique no nome de sua connection factory J2C para retornar para a página de configuração para a connection factory que está sendo criada.
  7. Selecione o novo alias na lista de aliases de autenticação gerenciada por contêiner.
  8. Clique em Aplicar.

Se tiver definido diversos domínios de segurança e diversos aliases de autenticação no servidor de aplicativos, poderá clicar em Procurar... para selecionar um alias de autenticação para o recurso que está sendo configurado. Os domínios de segurança permitem isolar aliases de autenticação entre servidores. A visualização em árvore é útil na determinação do domínio de segurança ao qual um alias pertence e, além disso, ela pode ajudar a determinar os servidores que poderão acessar cada alias de autenticação. A visualização em árvore é adaptada para cada recurso, portanto domínios e aliases ficam ocultos quando não é possível utilizá-los.

O botão Procurar estará acessível apenas se, pelo menos, um domínio de segurança for definido e um escopo designado, o que se aplica ao recurso que está sendo editado. Além disso, o domínio de segurança em questão deve conter pelo menos um alias de autenticação J2C JAAS.

Informações Valor
Tipo de D]ados Lista

O alias configurado para autenticação gerenciada pelo componente não se aplica a todos os clientes que devem acessar o recurso protegido. Clientes Java externos com acesso JNDI (Java Naming and Directory Interface) podem consultar um recurso J2C (Java 2 Connector), por exemplo, uma origem de dados ou uma fila JMS (Java Message Service). Porém, eles não têm permissão para aproveitar o alias de autenticação gerenciado pelo componente definido no recurso. Esse alias é o valor padrão utilizado quando o método getConnection() não especifica nenhum dado de autenticação, como usuário e senha, ou um valor para ConnectionSpec. Se um cliente externo precisar de uma conexão, ele deverá assumir a responsabilidade pela autenticação, transmitindo-a, por meio de argumentos, na chamada getConnection().

Entretanto, se clientes como servlets ou enterprise beans forem executados em processos na mesma célula do servidor de aplicativos, e os clientes puderem consultar um recurso no namespace JNDI, esses clientes poderão obter conexões sem fornecer explicitamente dados de autenticação na chamada getConnection(). Nesse caso, se a configuração do componente res-auth for Aplicativo, a autenticação será derivada do alias de autenticação gerenciado pelo componente, definido no connection factory. Ao configurar res-auth como Contêiner, a autenticação será derivada da configuração de login definida na referência de recurso do componente. Se a referência de recurso do componente não definir uma configuração de login, a autenticação será derivada do alias de autenticação gerenciado pelo contêiner, definido no connection factory.
Evitar Problemas Evitar Problemas: O alias de autenticação J2C é por célula. Um enterprise bean ou servlet em um servidor de aplicativos não pode consultar um recurso em outro processo do servidor que esteja em uma célula diferente, porque o alias não seria resolvido.gotcha

Alias de Configuração de Mapeamento

Especifica o alias de autenticação para a configuração de mapeamento JAAS (Java Authentication and Authorization Service) que é utilizada por esse connection factory.

A configuração JAAS DefaultPrincipalMapping mapeia o alias de autenticação para o ID do usuário e a senha. É possível definir e usar outras configurações de mapeamento.
Evitar Problemas Evitar Problemas: Alguns aliases de configuração de mapeamento não usam aliases de autenticação gerenciados por contêiner, portanto, não será possível selecionar um alias de autenticação gerenciado por contêiner se um desses aliases de configuração de mapeamento for selecionado.gotcha
Informações Valor
Tipo de D]ados Lista de seleção

Alias de Autenticação Gerenciado por Contêiner

Especifica dados de autenticação, que é uma entrada de dados de autenticação entre JAAS e J2C, para conexão gerenciada por contêiner com o recurso. Essa configuração pode ser desativada, dependendo do valor selecionado para a configuração Alias de mapeamento da configuração.

Selecione um alias na lista.

Para definir um novo alias que não é exibido na lista:
  1. Clique em Aplicar. Em Itens Relacionados, agora você vê uma listagem de entradas de dados de autenticação Java Platform, Enterprise Edition (Java EE) Connector Architecture (J2C).
  2. Clique em JAAS - Dados de Autenticação do J2C.
  3. Clique em Novo.
  4. Defina um alias.
  5. Clique em OK e em Salvar. Agora, o console exibe uma página de coleção de alias que lista todos os aliases configurados. Sobre a tabela, essa página também exibe o nome do connection factory na trilha de navegação.
  6. Clique no nome de sua connection factory J2C para retornar para a página de configuração para a connection factory que está sendo criada.
  7. Selecione o novo alias na lista de aliases de autenticação gerenciada por contêiner.
  8. Clique em Aplicar.

Se tiver definido diversos domínios de segurança e diversos aliases de autenticação no servidor de aplicativos, poderá clicar em Procurar... para selecionar um alias de autenticação para o recurso que está sendo configurado. Os domínios de segurança permitem isolar aliases de autenticação entre servidores. A visualização em árvore é útil na determinação do domínio de segurança ao qual um alias pertence, além de poder ajudar a determinar os servidores que estão aptos para acessar cada alias de autenticação. A visualização em árvore é adaptada para cada recurso, portanto domínios e aliases ficam ocultos quando não é possível utilizá-los.

O botão Procurar estará acessível apenas se, pelo menos, um domínio de segurança for definido e um escopo designado, o que se aplica ao recurso que está sendo editado. Além disso, o domínio de segurança em questão deve conter pelo menos um alias de autenticação J2C JAAS.

Informações Valor
Tipo de D]ados Lista de seleção

Preferência de Autenticação

Especifica os mecanimos de autenticação definidos para essa fábrica de conexões.

Essa definição especifica qual dos mecanismos de autenticação definido para o adaptador de recursos correspondente aplica-se a essa fábrica de conexões. Valores comuns, dependendo das capacidades do adaptador de recursos, são: KERBEROS, BASIC_PASSWORD e None.

Se None for selecionado, é esperado que o componente de aplicativo gerencie a autenticação (<res-auth>Application</res-auth>). Neste caso, o ID do usuário e a senha são obtidos de um dos seguintes elementos:
  • O alias de autenticação gerenciado por componente
  • Propriedades Customizadas de Senha, Nome do Usuário
  • Cadeias transmitidas no método getConnection
Por exemplo, se duas entradas do mecanismo de autenticação estiverem definidas para um adaptador de recursos no documento ra.xml:
  • <authentication-mechanism-type>BasicPassword</authentication-mechanism-type>
  • <authentication-mechanism-type>Kerbv5</authentication-mechanism-type>
A preferência de autenticação especifica o mecanismo a ser usado para a autenticação gerenciada por contêiner. Uma exceção é emitida durante a inicialização do servidor, se um mecanismo que não é suportado pelo adaptador de recursos for selecionado.
Informações Valor
Tipo de D]ados Lista de seleção
Default BASIC_PASSWORD

Ícone que indica o tipo de tópico Tópico de Referência



Ícone de registro de data e hora Última atualização: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=udat_j2cconnfacdet
Nome do arquivo: udat_j2cconnfacdet.html