Enables scripted content fragments to perform authorization tasks and retrieve OAuth data.

Methods

ChangePassword

Changes the password of the accessing user

Usage

#set($additionalInfoResponse = $core_v2_authentication.ChangePassword($oldPassword, $newPassword))

Parameters

NameTypeDescriptionRequiredDefaultOptions
oldPasswordstringCurrent PasswordRequired
newPasswordstringNew PasswordRequired

Return Type

AdditionalInfo

CreateLoginAndRedirect

Creates a new user from explicit credentials, logs the user in, and redirects to a redirectUrl

Usage

#set($booleanResponse = $core_v2_authentication.CreateLoginAndRedirect($username, $password, $privateEmail, $rememberUser, $redirectUrl, "%{AllowSitePartnersToContact = $allowSitePartnersToContactArg, AllowSiteToContact = $allowSiteToContactArg, Bio = $bioArg, Birthday = $birthdayArg, DisplayName = $displayNameArg, Gender = $genderArg, Language = $languageArg, Location = $locationArg, PublicEmail = $publicEmailArg, RssFeeds = $rssFeedsArg, TimeZone = $timeZoneArg, WebUrl = $webUrlArg}"))

Parameters

NameTypeDescriptionRequiredDefaultOptions
usernamestringUsernameRequired
passwordstringPasswordRequired
privateEmailstringPrivate EmailRequired
rememberUserboolRemember UserRequired
redirectUrlstringRedirect UrlRequired
AllowSitePartnersToContactboolAllow Site Partners To ContactOptional
AllowSiteToContactboolAllow Site To ContactOptional
BiostringBioOptional
BirthdayDateTimeBirthdayOptional
DisplayNamestringDisplay NameOptional
GenderstringGenderOptional
LanguagestringLanguageOptional
LocationstringLocationOptional
PublicEmailstringPublic EmailOptional
RssFeedsIList<string>Rss FeedsOptional
TimeZonedoubleTime ZoneOptional
WebUrlstringWeb UrlOptional

Return Type

bool

CreateLoginAndRedirect

Creates a new user from an OAuth data token, logs the user in, and redirects to a redirectUrl

Usage

#set($booleanResponse = $core_v2_authentication.CreateLoginAndRedirect($oAuthDataToken, $rememberUser, $redirectUrl, "%{AllowSitePartnersToContact = $allowSitePartnersToContactArg, AllowSiteToContact = $allowSiteToContactArg, Bio = $bioArg, Birthday = $birthdayArg, DisplayName = $displayNameArg, Email = $emailArg, Gender = $genderArg, Language = $languageArg, Location = $locationArg, PublicEmail = $publicEmailArg, RssFeeds = $rssFeedsArg, TimeZone = $timeZoneArg, WebUrl = $webUrlArg}"))

Parameters

NameTypeDescriptionRequiredDefaultOptions
oAuthDataTokenstringO Auth Data TokenRequired
rememberUserboolRemember UserRequired
redirectUrlstringRedirect UrlRequired
AllowSitePartnersToContactboolAllow Site Partners To ContactOptional
AllowSiteToContactboolAllow Site To ContactOptional
BiostringBioOptional
BirthdayDateTimeBirthdayOptional
DisplayNamestringDisplay NameOptional
EmailstringEmailOptional
GenderstringGenderOptional
LanguagestringLanguageOptional
LocationstringLocationOptional
PublicEmailstringPublic EmailOptional
RssFeedsIList<string>Rss FeedsOptional
TimeZonedoubleTime ZoneOptional
WebUrlstringWeb UrlOptional

Return Type

bool

GetLastLoginType

Returns the last login type for the accessing user

Usage

#set($stringResponse = $core_v2_authentication.GetLastLoginType())

Return Type

string

GetOAuthData

Gets the available OAuthData delivered from an OAuth provider

Usage

#set($oAuthDataResponse = $core_v2_authentication.GetOAuthData($oAuthDataToken))

Parameters

NameTypeDescriptionRequiredDefaultOptions
oAuthDataTokenstringO Auth Data TokenRequired

Return Type

OAuthData

GetOAuthProvider

Gets an OAuth provider

Usage

#set($oAuthProviderResponse = $core_v2_authentication.GetOAuthProvider($clientType))

Parameters

NameTypeDescriptionRequiredDefaultOptions
clientTypestringClient TypeRequired

Return Type

OAuthProvider

Impersonator

Returns the user performing impersonation of the accessing user

Usage

#set($userResponse = $core_v2_authentication.Impersonator())

Return Type

User

IsImpersonated

Returns whether the accessing user is impersonated

Usage

#set($booleanResponse = $core_v2_authentication.IsImpersonated())

Return Type

bool

LinkLoginAndRedirect

Authenticates an existing user, links thie user to an OAuth account, and redirects to a redirectUrl

Usage

#set($booleanResponse = $core_v2_authentication.LinkLoginAndRedirect($oAuthDataToken, $userName, $password, $rememberUser, $redirectUrl))

Parameters

NameTypeDescriptionRequiredDefaultOptions
oAuthDataTokenstringO Auth Data TokenRequired
userNamestringUser NameRequired
passwordstringPasswordRequired
rememberUserboolRemember UserRequired
redirectUrlstringRedirect UrlRequired

Return Type

bool

ListOAuthProviders

Lists OAuth providers

Usage

#set($iListResponse = $core_v2_authentication.ListOAuthProviders())

Return Type

IList<OAuthProvider>

LoginAndRedirect

Logs a user in via credentials and redirects to a redirect URL

Usage

#set($booleanResponse = $core_v2_authentication.LoginAndRedirect($userName, $password, $rememberUser, $redirectUrl))

Parameters

NameTypeDescriptionRequiredDefaultOptions
userNamestringUser NameRequired
passwordstringPasswordRequired
rememberUserboolRemember UserRequired
redirectUrlstringRedirect UrlRequired

Return Type

bool

LoginAndRedirect

Logs a user in via OAuth and redirects a redirect URL

Usage

#set($booleanResponse = $core_v2_authentication.LoginAndRedirect($oAuthDataToken, $rememberUser, $redirectUrl))

Parameters

NameTypeDescriptionRequiredDefaultOptions
oAuthDataTokenstringO Auth Data TokenRequired
rememberUserboolRemember UserRequired
redirectUrlstringRedirect UrlRequired

Return Type

bool

Logout

Unauthenticates the accessing user

Usage

#set($stringResponse = $core_v2_authentication.Logout())

Return Type

string

RedirectToAuthenticationLink

Redirects the accessing user to an OAuth provider's authentication form

Usage

#set($booleanResponse = $core_v2_authentication.RedirectToAuthenticationLink($clientType, $callbackUrl, $oAuthDataTokenKeyName))

Parameters

NameTypeDescriptionRequiredDefaultOptions
clientTypestringOAuth client typeRequired
callbackUrlstringURL to return to after the OAuth process completesRequired
oAuthDataTokenKeyNamestringOAuth Data Token key name. The OAuth token will be available via this parameter after the OAuth process completesRequired

Return Type

bool

RedirectToLogin

Redirects to the Login Form

Usage

$core_v2_authentication.RedirectToLogin()

RequireOriginalPasswordWhenChangingPassword

Returns whether an original password is required to change a password based on the presence of a password reset token

Usage

#set($booleanResponse = $core_v2_authentication.RequireOriginalPasswordWhenChangingPassword())

Return Type

bool

ResetPassword

Resets the password for a user

Usage

#set($additionalInfoResponse = $core_v2_authentication.ResetPassword($userId))

Parameters

NameTypeDescriptionRequiredDefaultOptions
userIdintUser IdRequired

Return Type

AdditionalInfo

SendChangePasswordEmail

Sends a password change email

Usage

#set($additionalInfoResponse = $core_v2_authentication.SendChangePasswordEmail($userId))

Parameters

NameTypeDescriptionRequiredDefaultOptions
userIdintUser IdRequired

Return Type

AdditionalInfo