Pages
API Documentation
On this page

SignOn::UiSessionData Class

Data container to hold values for the user interaction of an authentication session. More...

List of all members, including inherited members

Public Functions

Detailed Description

Inherit this class if you want to extend the property range.

Warning: All this class' definitions must be inline.

Member Function Documentation

UiSessionData::UiSessionData(const QVariantMap &data = QVariantMap())

Constructor. Creates a UiSessionData containing data.

Note: Internal use only recommended. As a SSO client application developer use setters/getters for specific SessionData properties.

void UiSessionData::setCaptchaImage(const QByteArray &value)

QByteArray UiSessionData::CaptchaImage() const

The property CaptchaImage contains the captcha image to be verified by user. CaptchaImage is passed to signon-ui when plugin requires the captcha verification from user. If this is empty, captcha query is not shown, unless CaptchaUrl point to valid image.

void UiSessionData::setCaptchaResponse(const QString &value)

QString UiSessionData::CaptchaResponse() const

The property CaptchaResponse is passed to plugin after signon-ui has processed the captcha query. It contains user input for captcha query.

See also CaptchaUrl(), CaptchaImage()

void UiSessionData::setCaptchaUrl(const QString &value)

QString UiSessionData::CaptchaUrl() const

The property CaptchaUrl contains url to the captcha image to be verified by user. CaptchaUrl is used in signon-ui when plugin requires the captcha verification from user. If this is empty, captcha query is not shown, unless CaptchaImage contain valid image.

void UiSessionData::setCaption(const QString &value)

QString UiSessionData::Caption() const

The property Caption is used to set credentials caption. Empty caption is discarded.

Warning: This string is shown to user as it is, plugin is responsible for localization.

void UiSessionData::setConfirm(const bool &value)

bool UiSessionData::Confirm() const

The property Confirm will set dialog to confirm password mode.

void UiSessionData::setFinalUrl(const QString &value)

QString UiSessionData::FinalUrl() const

The property FinalUrl: if this URL is set, the signon-ui browser widget will close automatically when this URL is reached.

void UiSessionData::setForgotPassword(const QString &value)

QString UiSessionData::ForgotPassword() const

The property ForgotPassword: this string is shown as a link to user.

See also ForgotPasswordUrl()

void UiSessionData::setForgotPasswordUrl(const QString &value)

QString UiSessionData::ForgotPasswordUrl() const

The property ForgotPasswordUrl is shown to user if ForgotPassword link is pressed.

See also ForgotPassword()

void UiSessionData::setIcon(const QString &value)

QString UiSessionData::Icon() const

The property Icon is shown to user in signin dialog.

void UiSessionData::setOpenUrl(const QString &value)

QString UiSessionData::OpenUrl() const

The property OpenUrl: this url is passed to signon-ui to be opened and shown to user. Empty url does not open the url view.

void UiSessionData::setQueryErrorCode(const int &value)

int UiSessionData::QueryErrorCode() const

The property QueryErrorCode is used to report errors in ui interaction that is shown to user.

See also SignOn::QueryError

void UiSessionData::setQueryMessage(const QString &value)

QString UiSessionData::QueryMessage() const

The property QueryMessage is used to show given message to user. Empty message is discarded.

Warning: This string is shown to user as it is, plugin is responsible for localization.

void UiSessionData::setQueryMessageId(const int &value)

int UiSessionData::QueryMessageId() const

The property QueryMessageId is used to select predefined localized message that is shown to user.

See also SignOn::QueryMessageId

void UiSessionData::setQueryPassword(const bool &value)

bool UiSessionData::QueryPassword() const

The property QueryPassword is used to enable password input in signon-ui.

void UiSessionData::setQueryUserName(const bool &value)

bool UiSessionData::QueryUserName() const

The property QueryUserName is used to enable username input in signon-ui.

void UiSessionData::setRememberPassword(const bool &value)

bool UiSessionData::RememberPassword() const

The property RememberPassword is used to enable password storing signond.

void UiSessionData::setShowRealm(const bool &value)

bool UiSessionData::ShowRealm() const

The property ShowRealm is used to show realm in signon-ui.

void UiSessionData::setTitle(const QString &value)

QString UiSessionData::Title() const

The property Title is used to set dialog title for password confirmation.

Warning: This string is shown to user as it is.

void UiSessionData::setUrlResponse(const QString &value)

QString UiSessionData::UrlResponse() const

The property UrlResponse: the response from signon-ui for OpenUrl request. After completion UrlResponse contains redirect target url, if there was redirection.

enum QueryError

Error codes for ui interaction.

Constant Value Description
SignOn::UiSessionData::QUERY_ERROR_NONE 0 No errors.
SignOn::UiSessionData::QUERY_ERROR_GENERAL 1 Generic error during interaction.
SignOn::UiSessionData::QUERY_ERROR_NO_SIGNONUI 2 Cannot send request to signon-ui.
SignOn::UiSessionData::QUERY_ERROR_BAD_PARAMETERS 3 Signon-Ui cannot create dialog based on the given UiSessionData.
SignOn::UiSessionData::QUERY_ERROR_CANCELED 4 User canceled action. Plugin should not retry automatically after this.
SignOn::UiSessionData::QUERY_ERROR_NOT_AVAILABLE 5 Requested ui is not available. For example browser cannot be started.
SignOn::UiSessionData::QUERY_ERROR_BAD_URL 6 Given url was not valid.
SignOn::UiSessionData::QUERY_ERROR_BAD_CAPTCHA 7 Given captcha image was not valid.
SignOn::UiSessionData::QUERY_ERROR_BAD_CAPTCHA_URL 8 Given url for captcha loading was not valid.
SignOn::UiSessionData::QUERY_ERROR_REFRESH_FAILED 9 Refresh failed.
SignOn::UiSessionData::QUERY_ERROR_FORBIDDEN 10 Showing ui forbidden by ui policy.
SignOn::UiSessionData::QUERY_ERROR_FORGOT_PASSWORD 11 User pressed forgot password.
SignOn::UiSessionData::QUERY_ERROR_NETWORK 12 Network error.
SignOn::UiSessionData::QUERY_ERROR_SSL 13 SSL error.

enum QueryMessageId

Predefined messages to be shown to user while querying input.

Constant Value Description
SignOn::UiSessionData::QUERY_MESSAGE_EMPTY 0 No predefined message.
SignOn::UiSessionData::QUERY_MESSAGE_LOGIN 1 Login without prior errors.
SignOn::UiSessionData::QUERY_MESSAGE_NOT_AUTHORIZED 2 Authentication failed.
We use cookies to personalize content and to analyze our traffic. Please decide if you are willing to accept cookies from our website.