ISessionServerOpenSessionAsync(String, String, NullableGuid, Boolean, Boolean, SessionClientParameters, IReadOnlyCollectionUserLoginType, String, DictionaryString, Object, CancellationToken) - метод

Открывает сессию по заданным параметрам, если не требуется двухфакторная аутентификация.

Definition

Пространство имён: Tessa.Platform.Runtime
Сборка: Tessa (в Tessa.dll) Версия: 4.1.3+7e2b1422f9b8c7c41fbbc4b151a843bed05319ab
C#
Task<OpenSessionResult> OpenSessionAsync(
	string login,
	string? password = null,
	Guid? applicationID = null,
	bool consumeClientLicense = false,
	bool twoFactorAuthSupport = false,
	SessionClientParameters? parameters = null,
	IReadOnlyCollection<UserLoginType>? expectedLoginTypes = null,
	string? loginMethod = null,
	Dictionary<string, Object?>? info = null,
	CancellationToken cancellationToken = default
)

Параметры

login  String
Логин (имя пользователя) для учётной записи Windows вместе с указанием его домена в том же виде, в каком задано в справочнике сотрудников, или логин пользователя, авторизация которого выполняется средствами Tessa с проверкой пароля по хешу.
password  String  (Optional)
Пароль для записи пользователя Tessa или null для пользователя Windows. Пароль учётной записи Windows не передаётся, а проверку пароля осуществляет Windows.
applicationID  NullableGuid  (Optional)

Идентификатор приложения или null, если используется приложение Other.

Стандартные идентификаторы приложений указаны в полях класса ApplicationIdentifiers.

consumeClientLicense  Boolean  (Optional)
Признак того, что сессия должна потреблять клиентскую лицензию (персональную или конкурентную).
twoFactorAuthSupport  Boolean  (Optional)
Признак того, что вызывающая сторона поддерживает двухфакторную аутентификацию.
parameters  SessionClientParameters  (Optional)
Параметры сессии, полученные с клиента в процессе открытия сессии, или null, если используются параметры по умолчанию, полученные для текущего потока.
expectedLoginTypes  IReadOnlyCollectionUserLoginType  (Optional)
Ожидаемые типы аутентификации или null/пустая коллекция, если доступен любой тип аутентификации, отличный от Forbidden. Тип аутентификации Forbidden недоступен даже при его явном указании.
loginMethod  String  (Optional)

Способ входа в систему, соответствующий типу входа клиента в систему, или null, если способ входа неизвестен или не задан.

Это текстовое описание, указываемое в событиях истории действий. Может быть строкой локализации или обычным текстом. Строки для доступных в системе методов определены в строках локализации с префиксом ActionHistory_Sessions_LoginMethod_.

info  DictionaryString, Object  (Optional)
Дополнительная информация, связанная с запросом на аутентификацию.
cancellationToken  CancellationToken  (Optional)
Объект, посредством которого можно отменить асинхронную задачу.

Возвращаемое значение

TaskOpenSessionResult
Результат открытия сессии - токен для сессии ISessionToken и информация по двухфакторной аутентификации или , если она не требуется.

Заметки

Если требуется выполнить двухфакторную аутентификацию, то сессия не будет открыта, хотя возвращаемый токен для неё будет создан. При этом возвращаемый сессионный токен не будет подписан, и лицензия не будет проверена (если требовалось). Эти действия будут производиться после успешного выполнения двухфакторной аутентификации.

См. также