LoginServiceServerOpenSessionAsync - метод
Выполняет аутентификацию пользователя, используя анонимную аутентификацию по учётной записи Windows
и по заданным параметрам логин/пароль/доменное имя, или используя аутентификацию для пользователя Tessa.
Создаёт и возвращает сессионный токен
SessionToken, сериализованный
токен в формате XML, а также информацию по двухфакторной аутентификации или
,
если она не требуется.
Пространство имён: Tessa.Web.ServicesСборка: Tessa.Web (в Tessa.Web.dll) Версия: 4.1.3+7e2b1422f9b8c7c41fbbc4b151a843bed05319ab
public Task<OpenSessionExtendedResult> OpenSessionAsync(
SessionClientParameters? parameters,
Guid applicationID,
string login,
string password,
string? loginMethod = null,
bool twoFactorAuthSupport = false,
CancellationToken cancellationToken = default
)
Public Function OpenSessionAsync (
parameters As SessionClientParameters,
applicationID As Guid,
login As String,
password As String,
Optional loginMethod As String = Nothing,
Optional twoFactorAuthSupport As Boolean = false,
Optional cancellationToken As CancellationToken = Nothing
) As Task(Of OpenSessionExtendedResult)
public:
virtual Task<OpenSessionExtendedResult^>^ OpenSessionAsync(
SessionClientParameters^ parameters,
Guid applicationID,
String^ login,
String^ password,
String^ loginMethod = nullptr,
bool twoFactorAuthSupport = false,
CancellationToken cancellationToken = CancellationToken()
) sealed
abstract OpenSessionAsync :
parameters : SessionClientParameters *
applicationID : Guid *
login : string *
password : string *
?loginMethod : string *
?twoFactorAuthSupport : bool *
?cancellationToken : CancellationToken
(* Defaults:
let _loginMethod = defaultArg loginMethod null
let _twoFactorAuthSupport = defaultArg twoFactorAuthSupport false
let _cancellationToken = defaultArg cancellationToken new CancellationToken()
*)
-> Task<OpenSessionExtendedResult>
override OpenSessionAsync :
parameters : SessionClientParameters *
applicationID : Guid *
login : string *
password : string *
?loginMethod : string *
?twoFactorAuthSupport : bool *
?cancellationToken : CancellationToken
(* Defaults:
let _loginMethod = defaultArg loginMethod null
let _twoFactorAuthSupport = defaultArg twoFactorAuthSupport false
let _cancellationToken = defaultArg cancellationToken new CancellationToken()
*)
-> Task<OpenSessionExtendedResult>
- parameters SessionClientParameters
-
Параметры сессии, полученные с клиента в процессе открытия сессии.
Укажите null, если вместо клиентских параметров используются параметры сервера,
например, часовой пояс, заданный на сервере.
- applicationID Guid
-
Идентификатор приложения. Укажите Guid.Empty, если используется приложение, неизвестное системе.
- login String
-
Логин (имя пользователя) для учётной записи Windows вместе с указанием его домена в том же виде,
в каком задано в справочнике сотрудников, или логин пользователя, авторизация которого
выполняется средствами Tessa с проверкой пароля по хешу.
- password String
- Пароль для учётной записи Windows или для записи пользователя Tessa.
- loginMethod String (Optional)
-
Способ входа в систему, соответствующий типу входа клиента в систему,
или null, если способ входа неизвестен или не задан.
Может быть строкой локализации или обычным текстом.
- twoFactorAuthSupport Boolean (Optional)
-
Признак того, что вызывающая сторона поддерживает двухфакторную аутентификацию.
- cancellationToken CancellationToken (Optional)
- Объект, посредством которого можно отменить асинхронную задачу.
TaskOpenSessionExtendedResult
Результат открытия сессии - объект с сессионным токеном
SessionToken,
сериализованным токеном в формате
Auth и
информацией по двухфакторной аутентификации или
, если она не требуется.
ILoginServiceOpenSessionAsync(SessionClientParameters, Guid, String, String, String, Boolean, CancellationToken)
Если требуется выполнить двухфакторную аутентификацию, то сессия не будет открыта, хотя
возвращаемый токен для неё будет создан. При этом возвращаемый сессионный токен
не будет подписан, и лицензия не будет проверена (если требовалось). Эти действия будут
производиться после успешного выполнения двухфакторной аутентификации.