-
Notifications
You must be signed in to change notification settings - Fork 10
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
36128cc
commit 8aad024
Showing
2 changed files
with
90 additions
and
30 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,62 @@ | ||
# OpenAM .Net SDK and IIS policy agent | ||
[![Latest release](https://img.shields.io/github/release/OpenIdentityPlatform/OpenAM-.Net-Agent.svg)](https://github.com/OpenIdentityPlatform/OpenAM-.Net-Agent/releases) | ||
[![Build Status](https://travis-ci.org/OpenIdentityPlatform/OpenAM-.Net-Agent.svg)](https://travis-ci.org/OpenIdentityPlatform/OpenAM-.Net-Agent) | ||
[![Build status](https://ci.appveyor.com/api/projects/status/a518k1mp0a0p95cn/branch/master?svg=true)](https://ci.appveyor.com/project/OpenIdentityPlatfom/openam-net-agent/branch/master) | ||
[![Issues](https://img.shields.io/github/issues/OpenIdentityPlatform/OpenAM-.Net-Agent.svg)](https://github.com/OpenIdentityPlatform/OpenAM-.Net-Agent/issues) | ||
[![Last commit](https://img.shields.io/github/last-commit/OpenIdentityPlatform/OpenAM-.Net-Agent.svg)](https://github.com/OpenIdentityPlatform/OpenAM-.Net-Agent/commits/master) | ||
[![License](https://img.shields.io/badge/license-CDDL-blue.svg)](https://github.com/OpenIdentityPlatform/OpenAM-.Net-Agent/blob/master/LICENSE.md) | ||
[![Gitter](https://img.shields.io/gitter/room/nwjs/nw.js.svg)](http://gitter.im/OpenIdentityPlatform/OpenAM) | ||
[![GitHub top language](https://img.shields.io/github/languages/top/OpenIdentityPlatform/OpenAM-.Net-Agent.svg)](https://github.com/OpenIdentityPlatform/OpenAM-.Net-Agent) | ||
[![GitHub code size in bytes](https://img.shields.io/github/languages/code-size/OpenIdentityPlatform/OpenAM-.Net-Agent.svg)](https://github.com/OpenIdentityPlatform/OpenAM-.Net-Agent) | ||
|
||
|
||
## Установка и настройка | ||
Идентифицируйте папку ${site}, в которой размещены файлы вашего приложения, путем поиска файла ${site}/web.config | ||
|
||
### Установка файлов бинарной поставки: | ||
* Скачайте [файл бинарной поставки](https://github.com/OpenIdentityPlatform/OpenAM-.Net-Agent/releases) | ||
* Распакуйте содержимое в папку ${site}/bin | ||
|
||
### Настройка записи журналов полиси агента: | ||
* Создайте папку ${site}/App_Data/Logs | ||
* Предоставьте право записи для пользователя IUSER_XXX в папку ${site}/App_Data/Logs | ||
|
||
### Настройка приложения: | ||
Настройки полиси агента хранятся в файле ${site}/web.config в секции \<appSettings\>, добавьте следующие настройки: | ||
* \<add key="com.sun.identity.agents.config.naming.url" value="" /\> | ||
* \<add key="com.sun.identity.agents.config.organization.name" value="/" /\> | ||
* \<add key="com.sun.identity.agents.app.username" value="" /\> | ||
* \<add key="com.iplanet.am.service.password" value="" /\> | ||
* \<add key="com.sun.identity.agents.config.key" value="" /\> (опустите настройку, если password не криптован) | ||
* \<add key="com.sun.identity.agents.config.local.log.path" value="${basedir}/App_Data/Logs"/\> (переопределите путь хранения журналов) | ||
|
||
Значения настроек предоставляются администратором сервера OpenAM или могут быть найдены в файлe c:\iis7_agent\Identifier_${site_id}\config\OpenSSOAgentBootstrap.properties предыдущей установки | ||
|
||
### Включение полиси агента: | ||
Включение полиси агента производится в файле ${site}/web.config в секции \<httpModules\> : | ||
* Удалите предыдущую версию полиси агента: \<add name="iis7agent" /\> | ||
* Добавьте новую версию полиси агента путем добавления строки: \<add name="OpenAM" type="ru.org.openam.iis.OpenAMHttpModule"\> | ||
* Проверьте работу приложения и файлы журналов в ${site}/App_Data/Logs | ||
|
||
ВАЖНО: добавление необходимо производить первой строчкой после тэга \<httpModules\> или после тега \<clear/\> внутри \<httpModules\> , если он существует. | ||
|
||
### Выключение полиси агента: | ||
Включение полиси агента производится в файле ${site}/web.config в секции \<httpModules\> : | ||
* Удалите строку: \<add name="OpenAM" type="ru.org.openam.iis.OpenAMHttpModule"\> | ||
|
||
### Примеры настройки | ||
Пример настройки ${site}/web.config: https://github.com/OpenIdentityPlatform/OpenAM-.Net-Agent/blob/master/ru.org.openam.iis.site.sample/web.config | ||
|
||
### Возможные проблемы | ||
|
||
#### System.Net.WebException: The underlying connection was closed: Could not establish trust relationship for the SSL/TLS secure channel | ||
На сервере используется не доверенный сертификат. Добавьте сертификат сервера в список надежных или отключите строгую проверку сертификатов (не рекомендуется в продуктивной среде) настройкой: | ||
|
||
\<add key="com.sun.identity.agents.config.trust.server.certs" value="true"/\> | ||
|
||
#### System.Net.WebException: The underlying connection was closed: A connection that was expected to be kept alive was closed by the server. at System.Net.HttpWebRequest.GetResponse() | ||
Сетевое оборудование некорректно обрабатывает поддержание открытых сетевых соединений, попробуйте запретить открытые соединения: | ||
|
||
\<add key="org.openidentityplatform.agents.config.keepalive.disable" value="true"/\> | ||
|
||
|