Configurando seu Aplicativo para Utilizar EIM

Antes de configurar seus aplicativos para utilizarem EIM, será necessário importar um arquivo RAR (Resource Archive) de conector externo para seu espaço de trabalho.
  1. No IDE, selecione Arquivo > Importar.
  2. Selecione J2EE > Arquivo RAR e clique em Avançar.

    Diálogo Importar

  3. No diálogo Importação de Conector, clique em Navegador e navegue para X:\Program Files\IBM\SDP70Shared\plugins\com.ibm.etools.iseries.webtools.ae_7.0.0\lib, em que X é a unidade na qual o WebSphere Development Studio Client para iSeries está instalada.
  4. Para WebSphere Development Studio Client para iSeries, versão 7.0, um novo conector JCA para a versão 1.5 foi incluído. O conector JCA, versão 1.0, também foi atualizado. O conector JCA versão 1.5 deve ser utilizado para conectar-se ao WebSphere Application Server, versão 6.0 ou posterior, enquanto que o conector JCA versão 1.0 pode ser utilizado para o WebSphere Application Server, versões 5.1 e 6.0.

    Selecione o arquivo eimIdTokenRA.rar (para JCA versão 1.0) ou o arquivo eimIdTokenRA.JCA15.rar (para JCA versão 1.5) e clique em Abrir para incluí-lo no diálogo Importação do Conector.

  5. Selecione seu projeto EAR da lista.

    Diálogo Importar

    Nota: São fornecidos quatro arquivos RAR. eimIdTokenRA.JCA15.rar (ou eimIdTokenRA.rar para JCA versão 1.0) encapsula eim.jar e facilita a implementação. idTokenRA.rar e idTokenRA.JCA15.rar não contêm o eim.jar e requerem que o usuário inclua-o e configure o caminho de classe do Servidor.
  6. Clique em Concluir para importar o arquivo RAR.

    Agora, configure o adaptador de recursos para utilizar o domínio de EIM criado anteriormente.

  7. Ative a visualização do Navegador. (Se a visualização do Navegador não estiver visível, será possível exibi-la selecionando Janela > Mostrar Visualização > Outros > Geral > Navegador.) Expanda a pasta EAR para seu projeto. Expanda o diretório META-INF e dê um clique duplo no arquivo do EAR Deployment Descriptor (application.xml).

    Arquivo Application.xml no Projeto EAR

  8. Na parte inferior da área do editor, clique na guia Implementação e expanda a seção Autenticação.

    Guia Implementação e Seção Autenticação

  9. Clique em Incluir para configurar a autenticação JAAS para o administrador LDAP. Digite o ID do usuário e senha para este administrador e clique em OK.
  10. Expanda a seção Opções Externas do J2C.
  11. Clique em Incluir junto a J2C Resource Adapters. O diálogo Criar Adaptador de Recursos é exibido com o nome do adaptador de recursos eimIdTokenRA (ou emIdTokenRA.JCA15) no campo Nome do Adaptador de Recursos. Clique em OK para fechar o diálogo.

    Diálogo Criar Adaptador de Recursos

  12. Clique em Incluir junto a J2C Connection Factories. É exibido o diálogo Create Connection Factory.

  13. Digite um nome para a connection factory.
  14. Digite um nome JNDI para esta connection factory no campo JNDI name (por exemplo, eis/idTokenRoot).
  15. Configure Máximo de Conexões como 10.
  16. Todos os outros valores neste diálogo permanecerão em suas configurações padrão. Clique em OK para fechar o diálogo.

  17. Clique no depósito de informações de conexão recém-criada na lista de depósitos de informações de conexão J2C e clique em Propriedade de Configuração. O diálogo Modificar Propriedade de Configuração é aberto.
  18. Em Propriedades de Recursos, digite as informações apropriadas para configurar o depósito de informações de conexão. Algumas configurações padrão são sugeridas aqui:
    • KeyTimeoutSeconds: Especifica um valor, em segundos, antes de esgotar o tempo limite da tecla. Configure esse valor como 1200.
    • KeySize: Indica o tamanho da tecla, em bytes. Configure esse valor como 512.
    • LdapHostName: O nome do host ou o endereço IP do System i remoto.
    • LdapHostPort: A porta que o serviço LDAP é executada. Configure esse valor como 389.
    • SourceRegistryName: O nome para o registro de origem.
    • EimDomainName: O nome de domínio EIM.
    • ParentDomain: O nome de domínio completo para o domínio-pai, no formato separado pair=value. Por exemplo, se o nome de domínio para seu domínio-pai for torasbcc.torolab.ibm.com, o valor ParentDomain seria dc=torasbcc,dc=torolab,dc=ibm,dc=com.
    • TrustStoreName: O caminho para o arquivo de armazenamento confiável.
    • TrustStorePassword: A senha para o arquivo de armazenamento confiável.
    • KeyStoreName: O caminho para o arquivo de armazenamento de chaves.
    • KeyStorePassword: A senha para o arquivo de armazenamento de chaves.

    Informações adicionais sobre essas configurações estão disponíveis no WebSphere Application Server para a documentação do i5/OS.

  19. Salve e feche a configuração do servidor.
  20. Na visualização Servidores, clique com o botão direito no servidor de teste e selecione Reiniciar para iniciá-lo.
Conceitos relacionados
Descritor de Implementação

Configurando Definições de Autenticação para seu Aplicativo WebFacing

Se estiver utilizando a WebFacing Tool, configure as definições de autenticação nas propriedades de Run Time de seu projeto. Consulte Definindo Opções de Autenticação para obter informações adicionais sobre como definir opções de autenticação para aplicativos WebFacing.

  1. Para abrir as propriedades do projeto do WebFacing, clique com o botão direito no projeto na visualização Projetos do WebFacing e selecione Propriedades. O nome do host nas configurações do projeto é o nome do sistema que contém o registro de destino.

  2. Clique na guia Autenticação para visualizar as definições de autenticação.
  3. Clique no botão de rádio Utilizar a conexão única.
  4. Para este exemplo, marque o campo Especificar referência de recurso EIM e digite idTokenRR.
    Nota: A cadeia idTokenRR pode ser qualquer cadeia. Ele é utilizada durante o mapeamento desta referência de recurso para o nome do adaptador real configurado no WAS. Esta cadeia faz distinção entre maiúsculas e minúsculas.
  5. Clique em OK para concluir.

Configurando Definições de Autenticação Utilizando Web Tools

Se estiver utilizando Web Tools, ative a conexão única utilizando o assistente Configuração de Tempo de Execução de Ferramentas da Web do iSeries. Consulte Configurando o Tempo de Execução do iSeries para obter informações adicionais sobre a definição de valores de autenticação, quando utilizar o Web Tools.

  1. Na perspectiva da Web, clique com o botão direito no projeto da Web e selecione Especificar a Configuração do Tempo de Execução do iSeries Web Tools.
  2. Clique no botão de rádio Conexão única.
  3. Digite o nome do host no qual o programa reside no campo Nome do host e idTokenRR no campo Referência de recurso EIM.
    Nota: A cadeia idTokenRR pode ser qualquer cadeia. Ele é utilizada durante o mapeamento desta referência de recurso para o nome do adaptador real configurado no WAS. Esta cadeia faz distinção entre maiúsculas e minúsculas.
  4. Clique em Concluir para concluir o assistente.

Incluindo uma Referência de Recurso no Web Deployment Descriptor

Agora atualize o Web Deployment Descriptor para Web Tools e aplicativos WebFacing.

  1. Na visualização Navegador, expanda a pasta Projeto da Web e dê um clique duplo no arquivo Web Deployment Descriptor (web.xml) na pasta WebContent\WEB-INF.

    Arquivo do Descritor de Implementação web.xml

  2. Agora clique na guia Referências na parte inferior da área do editor para configurar as referências de recursos.
  3. Clique em Incluir e selecione Referência de Recurso para especificar a referência de recurso para o aplicativo.

    Diálogo Incluir Referência

  4. Clique em Avançar.
  5. Neste exemplo, digite idTokenRR para a referência de recurso, selecione javax.jms.ConnectionFactory no campo Tipo e selecione Contêiner na lista Autenticação.
  6. Clique em Concluir.
  7. Em WebSphere Bindings, digite eis/idTokenRoot para Nome do JNDI. Esse é o nome especificado durante a configuração de EIM.
  8. Salve e feche o arquivo do Web Deployment Descriptor.

Feedback