После этого необходимо перезагрузить службу IISADMIN.

Подключение паспорта

Мы рассмотрим схему подключения паспорта, при которой сервер не имеет собственной системы идентификации, а использует только паспорт. При этом сервер обычно ведет дополнительно свою базу пользователей, где хранит анкетные данные. Чтобы получить доступ к определенным ресурсам, пользователь должен не только идентифицироваться, но и оставить о себе дополнительную информацию. На каждой странице сервера находится логотип паспорта, позволяющий выполнить вход/выход из системы.

Такая схема подключения используется на сервере GotDotNet.RU . Сервер идентифицирует через паспорт, а дополнительно спрашивает у пользователя псевдоним (для форумов и пробного хостинга) и адрес электронной почты.

Для этого необходимо реализовать следующие процедуры:

• общие процедуры проверки состояния паспорта
• отображение логотипа входа/выхода с текущим состоянием
• регистрацию пользователя во внутренней системе с выдачей части данных из профайла паспорта
• процедуру выхода

Общий код

В примере будет использоваться функции, зависимые от проекта:

• IsRegisterPage - проверяет, находимся ли мы сейчас на странице регистрации
• UserExists - проверяет по PUID есть ли такой пользователь во внутренней базе. PUID является уникальным кодом пользователя в паспорте и может быть использован для установления однозначного соответствия.
• ThisURL - возвращает адрес текущей страницы со всеми параметрами, либо без служебных параметров службы паспорта (t,p,did).

Const tNoTicket = 0
Const tStaleTicket = 1
Const tValidTicket = 2
Const lPassportTimeout = 3600
Const lPassportLang = 1049


' Создаем объект Passport Manager
Set oMgr = Server.CreateObject("Passport.Manager")
' После проведения успешной авторизации пользователь
' возвращается на сервер и при этом в аргументах
' передаются дополнительные параметры, необходимые для
' паспорта. Для корректного завершения входа
' необходимо вызвать метод FromNetworkServer, 
' который сохранит необходимые параметры в cookie,
' а потом удалить лишние аргументы из адреса.
' Для этого перенаправляем пользователя на
' текущую страницу, удаляя параметры t,p,did.
' Жаль, что Microsoft не ввел какие-нибудь префиксы
' для своих параметров. Легко попасть в ситуацию,
' когда страница уже имела параметры с такими именами
' и конфликт налицо.
'
' Если этот метод не вызвать, то вход не завершится успешно.
If oMgr.FromNetworkServer Then
    ' Функция ThisURL возвращает текущий URL, при
    ' необходимости удаляя из него фикс. параметры
    Response.Redirect ThisURL(True)
    Response.End
End If

' Проверим состояние идентификационного ключа пользователя
If oMgr.IsAuthenticated(lPassportTimeout) Then
   ' пользователь идентифицирован

   ' PUID - уникальный код пользователя в паспорте.
   sPUID = oMgr.HexPUID

   ' Проверим, что если мы не находимся на странице
   ' регистрации (ввода дополнительных данных)
   ' и значение в сессии не установлено, то надо
   ' попытаться установить соответствие
   ' между паспортом и внутренним пользователем

   If Not IsRegisterPage() And Len(Session(sSesUID)) = 0 Then
   	' Необходимо проверить
   	lUID = UserExists( sPUID)
   	If lUID > 0 Then
   		' Такой пользователь есть
   		Session(sSesUID) = lUID
   	Else
   		' Такого пользователя нет.  Это значит,
                ' что надо отправить его на страницу
   		' ввода дополнительных данных.
   		Response.Redirect sRegURL
   	End if
   End if
ElseIf oMgr.HasTicket Then
   ' у пользователя есть ключ, но время его
   ' жизни уже истекло необходимо обновить ключ.
   ' Это выполняется автоматически.
   oMgr.LoginUser Server.URLEncode(ThisURL(False)), _
         lPassportTimeout, , , lPassportLang
   ' далее не должно быть никакого кода, LoginUser
   ' выполняет Redirect
Else
   ' пользователь не авторизован
   ' очистим его значение в сессии
   Session(sSesUID) = Empty
End If

Регистрация пользователя во внутренней системе

Отметим сразу несколько моментов:

• При установке Passport SDK он устанавливается с Site ID = 1. Можно создавать тестовые реализации и с этим Site ID, не получая собственный ключ через .NET My Services Manager. Но при этом Вы гарантированно не получите никаких данных о пользователе.
• При работе в PreProduction режиме Вы сможете получить данные только о пользователях, которые зарегистрировались в тестовом режиме. При работе в PreProduction режиме в форме ввода имени и пароля будет ссылка на получение нового паспорта. Необходимо получить такой паспорт и использовать этих пользователей для тестирования. Остальных пользователей Вы сможете только идентифицировать.
• Получить данные можно, только если пользователь отметил соответствующие разрешающие флаги в своем профайле.

Список атрибутов, которые Вы можете получить, не очень велик – дата рождения, город, страна, фамилия, имя, пол, почтовый индекс, электронный адрес, псевдоним. Часть атрибутов хранят непосредственное значение, а часть строятся на базе словарей.

Со словарями сразу начинаются проблемы:

1. Список значений словарей получается не с сервера, а хранится локально. Это явный просчет в архитектуре паспорта. Словари на сервере могут измениться, а их актуальность на клиенте никем не гарантируется.
2. В словарях для русского языка (поддиректория 1049) установлена кодировка .1252 вместо .1251.
3. Часть словарей для русского языка, например, города (city.dat) – просто пустые.
4. Планируется, что значение по коду мы получаем значение из словаря, используя объект LookupTable. Данный объект позволяет быстро загрузить текстовый файл и далее получить значение по ключу. Но даже этим воспользоваться нельзя. Например, Россия описана в справочнике стран строкой «181,Россия,4,2,RU,7». Объект LookupTable может по коду 181 вернуть значение «Россия,4,2,RU,7». А паспорт нам возвращает значение «RU».

Далее нам остается только сохранить введенные данные в свою систему.

Отображение логотипа для входа/выхода

Response.Write( oMgr.LogoTag2(Server.URLEncode _
     (ThisURL(False)), lPassportTimeout, , , lPassportLang))

Выход из системы

Активизация

• Заключить договор с паспортом.
• Осуществить оплату за использование.
• Через .NET My Services Manager осуществить запрос на перевод сайта в режим Production.
• Дождаться получения по почте дискеты с ключом. По соображениям безопасности, других способов доставки нет.
• Через Passport Administration Utility перевести паспорт в режим Production и установить новый полученный ключ.

Настройка внешнего вида

Для этого при регистрации сервера в .NET My Services Manager служат параметры:

• Cobrand URL- адрес страницы, содержащей JavaScript, которая заполняет фиксированные переменные. Укажем http:///cobrand.js
• Cobrand CSS URL – адрес страницы со стилями. На страницы регистрации она будет включена через обычный link rel=stylesheet. Поставьте ссылку на файл со стилями вашего сайта.

Файл, определяемый адресом Cobrand URL, должен содержать инициализацию фиксированных переменных JavaScript. Переменные должны содержать строки с HTML-кодом, который будет вставлен в определенные места.

• CBLoginHead – значение будет добавлено в раздел HEAD на страницу входа.
• CBLoginBody – аналогично в раздел BODY.
• CBRegistrationHead, CBRegistraionBody – аналогично для страницы регистрации.

Дополнительно Вы имеете возможность настраивать внешний вид не статически, а в зависимости от места вызова. Для этого методы LogoTag2, LoginUser, AuthURL2 имеют дополнительные параметр coBrandArgs. Значение этого параметра будет передано Вашему скрипту и может быть нужным образом обработано.

Использование паспорта в ASP.NET

• Указываем, что будем использовать идентификацию через паспорт. Для этого в web.config указываем .
• Подключаем System.Web.Security.
• Объявляем переменную private PassportIdentity myPassport;
• В Page_Load инициализируем переменную myPassport. myPassport = (PassportIdentity ) (Page.User.Identity) ;
• Далее выполняем все вызовы (FromNetworkServer, IsAuthenticated и т.д.), согласно описанию, приведенному выше.