Параметры фабрики соединений J2C

С помощью этой страницы укажите параметры фабрики соединений.

Открыть эту страницу административной консоли можно двумя способами:

Область

Задает область адаптера ресурса, соединяющего приложение с информационная система предприятия (EIS) через данную фабрику соединений. Использовать эту фабрику соединений могут лишь приложения, установленные в данной области.

Поставщик

Адаптер ресурса, используемый WebSphere Application Server для данной фабрики соединений.

Провайдера можно указать только при создании новой фабрики соединений. В списке показаны все имеющиеся адаптеры ресурсов, заданные в соответствующей области. Выберите один из списка для использования имеющегося адаптера ресурса в качестве провайдера.

Создать новый провайдер

Позволяет настроить новый адаптер ресурса для новой фабрики соединений.

Опция Создать новый провайдер отображается только при создании, а не изменении фабрики соединений.

При щелчке на опции Создать новый провайдер консоль отображает страницу настройки адаптера ресурса, с помощью которой можно создать новый адаптер. После нажатия кнопки OK для сохранения изменений вы увидите страницу набора фабрик соединений. Выберите Создать для определения новой фабрики соединений для применения с новым адаптером ресурса; консоль отобразит страницу настройки, на которой адаптер ресурса будет указан как новый провайдер фабрики соединений.

Имя

Имя данной фабрики соединений.

Это обязательное свойство.

Информация Значение
Тип данных Строка

Имя JNDI

Задает имя JNDI данной фабрики соединений.

Например, именем может быть eis/myECIConnection.

Задав это значение сохраните его и перезапустите сервер. Вы увидите эту строку при запуске инструмента dumpNameSpace. Это обязательное свойство. Если не указать имя JNDI, оно будет заполнено по умолчанию с учетом значения поля Имя.

Информация Значение
Тип данных Строка
Значение по умолчанию eis/отображаемое имя
Важное замечание: Имена JNDI должны удовлетворять следующим требованиям:
  • Не указывайте одинаковые имена JNDI для ресурсов разных типов (например, ресурсов источников данных и фабрик соединений J2C или JMS).
  • Не указывайте одинаковые имена JNDI для разных ресурсов одного и того же типа из одной области.

Описание

Задает текстовое описание данной фабрики соединений.

Информация Значение
Тип данных Строка

Интерфейс фабрики соединений

Задает полное имя интерфейса фабрики соединений, поддерживаемое адаптером ресурса.

Это обязательное свойство. Для новых объектов список доступных классов предоставляется адаптером ресурса с помощью выпадающего списка. После создания фабрики соединений это поле станет доступным только для чтения.

Информация Значение
Тип данных Выпадающий список или текст

Категория

Задает строку, используемую для классификации или группировки фабрик соединений.

Информация Значение
Тип данных Строка

Псевдоним идентификации для восстановления XA

Задает псевдоним идентификации, применяемый в процессе восстановления XA. Если имя псевдонима изменяется после сбоя сервера, последующее восстановление XA будет использовать значение этого параметра, которое было до сбоя.

Выберите псевдоним из списка.

Чтобы задать новый псевдоним, отсутствующий в списке, выполните следующие действия:
  1. Нажмите Применить. В разделе "Связанные элементы" будет показан список "Записи идентификационных данных архитектуры коннекторов Java Platform, Enterprise Edition (Java EE) (J2C).
  2. Выберите JAAS - Идентификационные данные J2C.
  3. Выберите Создать.
  4. Задайте псевдоним.
  5. Последовательно нажмите кнопки OK и Сохранить. На консоли отображается страница набора псевдонимов со списком всех настроенных псевдонимов. Перед таблицей на этой странице отображается имя фабрики соединений в хронологии пути.
  6. Щелкните на имени фабрики соединений J2C для возврата на страницу конфигурации создаваемой фабрики соединений.
  7. Выберите новый псевдоним в списке управляемых контейнером псевдонимов идентификации.
  8. Нажмите Применить.

Если адаптер ресурса не поддерживает транзакции XA, то это поле не отображается. Значение по умолчанию извлекается из выбранного псевдонима для идентификации приложения, если он указан.

Если на сервере приложений определены домены защиты и псевдонимы идентификации, то для выбора псевдонима идентификации настраиваемого ресурса можно воспользоваться кнопкой Обзор.... Домены защиты позволяют изолировать псевдонимы идентификации одного сервера от других. Данный иерархический список помогает получить представление о том, какому домену защиты принадлежит псевдоним, и какие серверы к каким псевдонимам имеют доступ. Этот список настраивается под каждый ресурс индивидуально, поэтому домены и псевдонимы, к которым вы не имеете доступа, не показываются.

Кнопка Обзор доступна только в том случае, если задан по крайней мере один домен защиты и ему присвоена область, доступная редактируемому ресурсу. Кроме того, домен защиты должен содержать по крайней мере один псевдоним идентификации J2C JAAS.

Информация Значение
Тип данных Выпадающий список

Псевдоним идентификации, управляемой компонентом

Задает данные идентификации для управляемого компонентом входа в ресурс.

Выберите псевдоним из списка.

Чтобы задать новый псевдоним, отсутствующий в списке, выполните следующие действия:
  1. Нажмите Применить. В разделе "Связанные элементы" будет показан список "Записи идентификационных данных архитектуры коннекторов Java Platform, Enterprise Edition (Java EE) (J2C).
  2. Выберите JAAS - Идентификационные данные J2C.
  3. Выберите Создать.
  4. Задайте псевдоним.
  5. Последовательно нажмите кнопки OK и Сохранить. На консоли отображается страница набора псевдонимов со списком всех настроенных псевдонимов. Перед таблицей на этой странице отображается имя фабрики соединений в хронологии пути.
  6. Щелкните на имени фабрики соединений J2C для возврата на страницу конфигурации создаваемой фабрики соединений.
  7. Выберите новый псевдоним в списке управляемых контейнером псевдонимов идентификации.
  8. Нажмите Применить.

Если на сервере приложений определены домены защиты и псевдонимы идентификации, то для выбора псевдонима идентификации настраиваемого ресурса можно воспользоваться кнопкой Обзор.... Домены защиты позволяют изолировать псевдонимы идентификации одного сервера от других. Данный иерархический список помогает получить представление о том, какому домену защиты принадлежит псевдоним, и какие серверы к каким псевдонимам имеют доступ. Этот список настраивается под каждый ресурс индивидуально, поэтому домены и псевдонимы, к которым вы не имеете доступа, не показываются.

Кнопка Обзор доступна только в том случае, если задан по крайней мере один домен защиты и ему присвоена область, доступная редактируемому ресурсу. Кроме того, домен защиты должен содержать по крайней мере один псевдоним идентификации J2C JAAS.

Информация Значение
Тип данных Список

Псевдоним, указанный для управляемой компонентом идентификации, не относится ко всем клиентам, которым необходим доступ к защищенному ресурсу. Внешние клиенты Java с доступом JNDI могут находить ресурс Java 2 Connector (J2C), например источник данных или очередь службы сообщений Java (JMS). Однако они не могут использовать псевдоним управляемой компонентом идентификации, заданный для ресурса. Этот псевдоним — значение по умолчанию, используемое, когда во время вызова метода getConnection() не указываются данные идентификации (такие как user и password) или ConnectionSpec. Если внешнему клиенту требуется соединение, то он должен передать аргументы для идентификации в вызове getConnection().

Но если клиенты (например сервлеты или объекты EJB) работают в процессах, расположенных в одной ячейке с сервером приложений, и могут искать ресурсы в пространстве имен JNDI, тогда они могут получать соединения, не предоставляя идентификационные данные во время вызова getConnection(). В этом случае, если для параметра res-auth компонента установлено значение Application, то для идентификации применяется псевдоним управляемой компонентом идентификации, определенный в фабрике соединений. Когда вы устанавливаете res-auth в значение Container, данные идентификации берутся из конфигурации входа в систему, определяемой в ссылке на ресурс. Если ссылка на ресурс для данного компонента не определяет конфигурацию входа, данные идентификации берутся из "Управляемого контейнером псевдонима идентификации", определяемого фабрикой соединений.
Предотвращение неполадок Предотвращение неполадок: Псевдоним идентификации J2C задается в каждой ячейке. Объект EJB или сервлет на сервере приложений не может находить ресурсы в другом процессе сервера, который находится в другой ячейке, поскольку псевдоним в данном случае невозможно обработать.gotcha

Преобразование псевдонимов конфигурации

Задает псевдоним идентификации для конфигурации преобразования службы идентификации Java (JAAS), используемой этой фабрикой соединений.

Конфигурация JAAS DefaultPrincipalMapping преобразует псевдоним идентификации в ИД пользователя и пароль. Можно задать и использовать и другие конфигурации преобразования.
Предотвращение неполадок Предотвращение неполадок: Некоторые псевдонимы конфигурации преобразования не используют псевдонимы идентификации, управляемые контейнером, поэтому, если выбраны именно такие псевдонимы конфигурации преобразования, управляемые контейнером псевдонимы идентификации выбрать будет нельзя.gotcha
Информация Значение
Тип данных Список выбора

Псевдоним идентификации, управляемой контейнером

Задает данные идентификации, которые представляют собой JAAS (записи идентификационных данных J2C), для управляемого контейнером входа в ресурс. Этот параметр можно выключить в зависимости от значения, выбранного для псевдонима конфигурации преобразования.

Выберите псевдоним из списка.

Чтобы задать новый псевдоним, отсутствующий в списке, выполните следующие действия:
  1. Нажмите Применить. В разделе "Связанные элементы" будет показан список "Записи идентификационных данных архитектуры коннекторов Java Platform, Enterprise Edition (Java EE) (J2C).
  2. Выберите JAAS - Идентификационные данные J2C.
  3. Выберите Создать.
  4. Задайте псевдоним.
  5. Последовательно нажмите кнопки OK и Сохранить. На консоли отображается страница набора псевдонимов со списком всех настроенных псевдонимов. Перед таблицей на этой странице отображается имя фабрики соединений в хронологии пути.
  6. Щелкните на имени фабрики соединений J2C для возврата на страницу конфигурации создаваемой фабрики соединений.
  7. Выберите новый псевдоним в списке управляемых контейнером псевдонимов идентификации.
  8. Нажмите Применить.

Если на сервере приложений определены домены защиты и псевдонимы идентификации, то для выбора псевдонима идентификации настраиваемого ресурса можно воспользоваться кнопкой Обзор.... Домены защиты позволяют изолировать псевдонимы идентификации одного сервера от других. Данный иерархический список помогает получить представление о том, какому домену защиты принадлежит псевдоним, и какие серверы к каким псевдонимам имеют доступ. Этот список настраивается под каждый ресурс индивидуально, поэтому домены и псевдонимы, к которым вы не имеете доступа, не показываются.

Кнопка Обзор доступна только в том случае, если задан по крайней мере один домен защиты и ему присвоена область, доступная редактируемому ресурсу. Кроме того, домен защиты должен содержать по крайней мере один псевдоним идентификации J2C JAAS.

Информация Значение
Тип данных Список выбора

Параметр идентификации

Задает механизм идентификации, указанный для данной фабрики соединений.

Этот параметр указывает, какой из механизмов идентификации, заданных для соответствующего адаптера ресурса, применяется к данной фабрике соединений. К общим значениям, в зависимости от возможностей адаптера, относятся KERBEROS, BASIC_PASSWORD и None.

Если выбрано значение None, идентификацией будет управлять компонент приложения (<res-auth>Application</res-auth>). В таком случае ИД пользователя и пароль берутся из одного из следующих:
  • Псевдонима управляемой компонентом идентификации
  • Пользовательских свойств Имя пользователя, Пароль
  • Параметров, переданных методу getConnection
Например, если для адаптера ресурса в документе ra.xml заданы две записи механизма идентификации:
  • <authentication-mechanism-type>BasicPassword</authentication-mechanism-type>
  • <authentication-mechanism-type>Kerbv5</authentication-mechanism-type>
Параметр идентификации указывает механизм, используемый для управляемой контейнером идентификации. Если выбранный механизм не поддерживается адаптером ресурса, при запуске сервера выбрасывается исключительная ситуация.
Информация Значение
Тип данных Список выбора
Значение по умолчанию BASIC_PASSWORD


Имя файла: udat_j2cconnfacdet.html