**Apache Rampart-${project.version} build  (${buildTimestamp})**

http://axis.apache.org/axis2/java/rampart
------------------------------------------------------

_______________________________
**Содержание бинарного дистрибутива**
===============================

lib — этот каталог содержит все библиотеки, необходимые для работы Rampart, в дополнение к библиотекам, доступным в стандартном бинарном выпуске Axis2.

rampart-${project.version}.mar — поддержка WS-Security и WS-SecureConversation для Axis2
rahas-${project.версия}.mar — модуль STS, который используется для добавления операций STS к сервису.

samples — содержит примеры использования Apache Rampart и настройки различных компонентов для выполнения различных операций WS-Sec*.

README.txt — этот файл.

build.xml — файл установки для копирования всех jar-файлов в нужные места.
____________
**Установка**
============

Использование Ant
---------
Запустите скрипт ant на извлечённом бинарном дистрибутиве, и он скопирует необходимые файлы в Axis2. Вы должны установить системную переменную AXIS2_HOME, чтобы она указывала на ваше бинарное распределение Axis2. 

Ручная установка
-------------------
Вы можете скопировать необходимые библиотеки и файлы модулей вручную. Вам нужно скопировать все библиотеки из каталога lib дистрибутива Rampart в каталог lib Axis2 и все файлы модулей в каталог модулей дистрибутива Rampart в каталог modules Axis2.

Каталог lib Axis2 — AXIS2_HOME/lib (стандартный бинарный дистрибутив) или axis2/WEB-INF/lib (WAR).

Каталог модулей Axis2 — AXIS2_HOME/repository/modules (стандартный бинарный дистрибутив) или axis2/WEB-INF/modules (WAR).

ВАЖНО: перед сборкой rampart из исходного дистрибутива вам необходимо предусмотреть неограниченную юрисдикцию безопасности, поскольку некоторые тестовые случаи используют размер ключа 256. Поэтому вам нужно загрузить jce_policy-x_y_z.zip (в соответствии с вашей версией JDK) и заменить старые файлы jar (local_policy.jar и US_export_policy.jar) в $JAVA_HOME/jre/lib/security. Эти файлы перечислены на сайте загрузки sun под вашей версией JDK как Java(TM) Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy Files.

Банки Bouncy castle больше не поставляются с бинарным дистрибутивом Rampart из-за некоторых патентных проблем. Но поскольку банки Bouncy castle необходимы для Rampart, пользователям придётся вручную загружать и копировать банку Bouncy castle, соответствующую их версии JDK. Банки Bouncy castle можно скачать по адресу http://www.bouncycastle.org/latest_releases.html.

Добавление bouncycastle в качестве поставщика безопасности

1.) Загрузите bouncycastle согласно вашей версии java. Вы можете скачать bouncycastle по следующей ссылке.
http://www.bouncycastle.org/latest_releases.html
2.) Добавьте bcprov-jdkXX-139.jar в путь к классам вашего сервиса / клиента.
3.) Добавьте следующую строку в файл java.security, который можно найти в каталоге lib/security JRE, в качестве последней строки.
security.provider.X=org.bouncycastle.jce.provider.BouncyCastleProvider

В более старых версиях JDK поддержка SAML 2.0 требует одобрения стандартной реализации JAXP JDK с помощью Xerces (http://xerces.apache.org/mirrors.cgi#binary) и Xalan (http://xml.apache.org/xalan-j/downloads.html#latest-release). Для этого вам нужно скопировать resolver-x.x.x.jar, serializer-x.x.x.jar, xercesImpl-x.x.x.jar и xml-apis-x.x.x.jar из бинарного распределения Xerces и xalan-x.x.x.jar из двоичного распределения xalan в одобренный каталог. Если вы используете Sun JDK, одобренный каталог находится по адресу $JAVA_HOME/jre/lib/endorsed.

Обратите внимание, что во время сборки эти JAR-файлы автоматически добавляются в загрузочный путь к классам JVM, выполняющей модульные тесты. Поэтому это необходимо только во время выполнения, а не при сборке Rampart.

Когда Rampart развёртывается на конкретном сервере приложений, обратитесь к механизму одобрения, рекомендованному для этого сервера, и одобрите реализацию JAXP, используя набор упомянутых выше jar-файлов.

Прежде чем пытаться использовать какие-либо образцы, убедитесь, что у вас есть:

1.) Загружен стандартный бинарный выпуск Axis2. **Извлечено.**

2.) Установите переменную среды AXIS2_HOME.
3.) Запустите ant из каталога «samples», чтобы скопировать необходимые библиотеки и модули в соответствующие каталоги в AXIS2_HOME. 
___________________
**Уведомление о криптографии**
===================

Данное распространение включает программное обеспечение для криптографии. В стране, в которой вы проживаете, могут быть ограничения на импорт, владение, использование и/или реэкспорт программного обеспечения для шифрования в другую страну. Прежде чем использовать любое программное обеспечение для шифрования, пожалуйста, ознакомьтесь с законами, правилами и политиками вашей страны, касающимися импорта, владения или использования и реэкспорта программного обеспечения для шифрования. Проверьте, разрешено ли это. Дополнительную информацию можно найти по адресу: <http://www.wassenaar.org/>.

Министерство торговли США, Бюро промышленности и безопасности (BIS), классифицировало это программное обеспечение как номер контроля экспорта товаров (ECCN) 5D002.C.1, который включает программное обеспечение информационной безопасности, использующее или выполняющее криптографические функции с асимметричными алгоритмами. Форма и способ распространения Apache Software Foundation делают его пригодным для экспорта в соответствии с исключением License Exception ENC Technology Software Unrestricted (TSU) (см. раздел 740.13 Правил экспортного администрирования BIS) как для объектного кода, так и для исходного кода.

Ниже приведены более подробные сведения о включённом программном обеспечении для криптографии:

Apache Santuario: http://santuario.apache.org/
Apache WSS4J: http://ws.apache.org/wss4j/
Bouncycastle: http://www.bouncycastle.org/
___________________
**Поддержка**
===================

О любой проблеме с этим выпуском можно сообщить в список рассылки Rampart или в систему отслеживания проблем JIRA.

Подписка на список рассылки:
    java-dev-subscribe@axis.apache.org

Jira:
    http://issues.apache.org/jira/browse/RAMPART

Спасибо за использование Apache Rampart!

Команда Apache Rampart.

[1] http://www.apache.org/dist/java-repository/xalan/jars/