core_v2_authentication Script API

Ben Tiedt — Wed, 20 Nov 2019 14:53:16 GMT

Current Revision posted to API Documentation by Ben Tiedt on 11/20/2019 14:53:16

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

ChangePassword
CreateLoginAndRedirect
GetLastLoginType
GetOAuthData
GetOAuthProvider
Impersonator
IsAuthorizationRequest
IsImpersonated
LinkLoginAndRedirect
ListOAuthProviders
LoginAndRedirect
Logout
RedirectToAuthenticationLink
RedirectToLogin
RequireOriginalPasswordWhenChangingPassword
ResetPassword
SendChangePasswordEmail

Methods

ChangePassword

Changes the password of the accessing user

Velocity

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

JavaScript

var additionalInfoResponse = core_v2_authentication.ChangePassword(oldPassword, newPassword);

Parameters

Name	Type	Description	Required	Default	Options
oldPassword	`String`	Current Password	Required
newPassword	`String`	New Password	Required

Returns

[[AdditionalInfo Script API Type|AdditionalInfo]]

CreateLoginAndRedirect

CreateLoginAndRedirect Overload 1

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

Velocity

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

JavaScript

var booleanResponse = core_v2_authentication.CreateLoginAndRedirect(username, password, privateEmail, rememberUser, redirectUrl, { AcceptTermsOfService: acceptTermsOfServiceArg, AllowSitePartnersToContact: allowSitePartnersToContactArg, AllowSiteToContact: allowSiteToContactArg, Bio: bioArg, Birthday: birthdayArg, DisplayName: displayNameArg, EnableEmail: enableEmailArg, EnableHtmlEmail: enableHtmlEmailArg, Gender: genderArg, Language: languageArg, Location: locationArg, PublicEmail: publicEmailArg, RssFeeds: rssFeedsArg, TimeZone: timeZoneArg, WebUrl: webUrlArg });

Parameters

Name	Type	Description	Required
username	`String`	Username	Required
password	`String`	Password	Required
privateEmail	`String`	Private Email	Required
rememberUser	`Boolean`	Remember User	Required
redirectUrl	`String`	Redirect Url	Required
AcceptTermsOfService	`Boolean`	Registers that a user has accepted the terms of service for this community when applicable. The default is false.	Optional
AllowSitePartnersToContact	`Boolean`	Allow Site Partners To Contact	Optional
AllowSiteToContact	`Boolean`	Allow Site To Contact	Optional
Bio	`String`	Bio	Optional
Birthday	`DateTime`	Birthday	Optional
DisplayName	`String`	Display Name	Optional
EnableEmail	`Boolean`	Allow user to receive emails.	Optional
EnableHtmlEmail	`Boolean`	Allow user to receive emails in the HTML format.	Optional
Gender	`String`	Gender	Optional
Language	`String`	Language	Optional
Location	`String`	Location	Optional
PublicEmail	`String`	Public Email	Optional
RssFeeds	`IList of String`	Rss Feeds	Optional
TimeZone	`Double`	Time Zone	Optional
WebUrl	`String`	Web Url	Optional

CreateLoginAndRedirect Overload 2

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

Velocity

#set($booleanResponse = $core_v2_authentication.CreateLoginAndRedirect($oAuthDataToken, $rememberUser, $redirectUrl, "%{ AcceptTermsOfService = $acceptTermsOfServiceArg, 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 }"))

JavaScript

var booleanResponse = core_v2_authentication.CreateLoginAndRedirect(oAuthDataToken, rememberUser, redirectUrl, { AcceptTermsOfService: acceptTermsOfServiceArg, 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

Name	Type	Description	Required
oAuthDataToken	`String`	O Auth Data Token	Required
rememberUser	`Boolean`	Remember User	Required
redirectUrl	`String`	Redirect Url	Required
AcceptTermsOfService	`Boolean`	Registers that a user has accepted the terms of service for this community when applicable. The default is false.	Optional
AllowSitePartnersToContact	`Boolean`	Allow Site Partners To Contact	Optional
AllowSiteToContact	`Boolean`	Allow Site To Contact	Optional
Bio	`String`	Bio	Optional
Birthday	`DateTime`	Birthday	Optional
DisplayName	`String`	Display Name	Optional
Email	`String`	Email	Optional
Gender	`String`	Gender	Optional
Language	`String`	Language	Optional
Location	`String`	Location	Optional
PublicEmail	`String`	Public Email	Optional
RssFeeds	`IList of String`	Rss Feeds	Optional
TimeZone	`Double`	Time Zone	Optional
WebUrl	`String`	Web Url	Optional

Returns

Boolean

GetLastLoginType

Returns the last login type for the accessing user

Velocity

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

JavaScript

var stringResponse = core_v2_authentication.GetLastLoginType();

Returns

String

GetOAuthData

Gets the available OAuthData delivered from an OAuth provider

Velocity

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

JavaScript

var oAuthDataResponse = core_v2_authentication.GetOAuthData(oAuthDataToken);

Parameters

Name	Type	Description	Required	Default	Options
oAuthDataToken	`String`	O Auth Data Token	Required

Returns

[[OAuthData Script API Type|OAuthData]]

GetOAuthProvider

Gets an OAuth provider

Velocity

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

JavaScript

var oAuthProviderResponse = core_v2_authentication.GetOAuthProvider(clientType);

Parameters

Name	Type	Description	Required	Default	Options
clientType	`String`	Client Type	Required

Returns

[[OAuthProvider Script API Type|OAuthProvider]]

Impersonator

Returns the user performing impersonation of the accessing user

Velocity

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

JavaScript

var userResponse = core_v2_authentication.Impersonator();

Returns

[[User Script API Type|User]]

IsAuthorizationRequest

Returns whether the current request is an authorization request by an OAuth client

Velocity

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

JavaScript

var booleanResponse = core_v2_authentication.IsAuthorizationRequest();

Returns

Boolean

IsImpersonated

Returns whether the accessing user is impersonated

Velocity

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

JavaScript

var booleanResponse = core_v2_authentication.IsImpersonated();

Returns

Boolean

LinkLoginAndRedirect

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

Velocity

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

JavaScript

var booleanResponse = core_v2_authentication.LinkLoginAndRedirect(oAuthDataToken, userName, password, rememberUser, redirectUrl);

Parameters

Name	Type	Description	Required
oAuthDataToken	`String`	O Auth Data Token	Required
userName	`String`	User Name	Required
password	`String`	Password	Required
rememberUser	`Boolean`	Remember User	Required
redirectUrl	`String`	Redirect Url	Required

Returns

Boolean

ListOAuthProviders

Lists OAuth providers

Velocity

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

JavaScript

var iListResponse = core_v2_authentication.ListOAuthProviders();

Returns

IList of [[OAuthProvider Script API Type|OAuthProvider]]

LoginAndRedirect

LoginAndRedirect Overload 1

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

Velocity

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

JavaScript

var booleanResponse = core_v2_authentication.LoginAndRedirect(userName, password, rememberUser, redirectUrl);

Parameters

Name	Type	Description	Required
userName	`String`	User Name	Required
password	`String`	Password	Required
rememberUser	`Boolean`	Remember User	Required
redirectUrl	`String`	Redirect Url	Required

LoginAndRedirect Overload 2

Logs a user in via OAuth and redirects a redirect URL

Velocity

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

JavaScript

var booleanResponse = core_v2_authentication.LoginAndRedirect(oAuthDataToken, rememberUser, redirectUrl);

Parameters

Name	Type	Description	Required
oAuthDataToken	`String`	O Auth Data Token	Required
rememberUser	`Boolean`	Remember User	Required
redirectUrl	`String`	Redirect Url	Required

Returns

Boolean

Logout

Unauthenticates the accessing user

Velocity

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

JavaScript

var stringResponse = core_v2_authentication.Logout();

Returns

String

RedirectToAuthenticationLink

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

Velocity

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

JavaScript

var booleanResponse = core_v2_authentication.RedirectToAuthenticationLink(clientType, callbackUrl, oAuthDataTokenKeyName);

Parameters

Name	Type	Description	Required
clientType	`String`	OAuth client type	Required
callbackUrl	`String`	URL to return to after the OAuth process completes	Required
oAuthDataTokenKeyName	`String`	OAuth Data Token key name. The OAuth token will be available via this parameter after the OAuth process completes	Required

Returns

Boolean

RedirectToLogin

Redirects to the Login Form

Velocity

$core_v2_authentication.RedirectToLogin()

JavaScript

core_v2_authentication.RedirectToLogin();

Returns

Nothing

RequireOriginalPasswordWhenChangingPassword

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

Velocity

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

JavaScript

var booleanResponse = core_v2_authentication.RequireOriginalPasswordWhenChangingPassword();

Returns

Boolean

ResetPassword

Resets the password for a user

Velocity

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

JavaScript

var additionalInfoResponse = core_v2_authentication.ResetPassword(userId);

Parameters

Name	Type	Description	Required	Default	Options
userId	`Int32`	User Id	Required

Returns

[[AdditionalInfo Script API Type|AdditionalInfo]]

SendChangePasswordEmail

Sends a password change email

Velocity

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

JavaScript

var additionalInfoResponse = core_v2_authentication.SendChangePasswordEmail(userId);

Parameters

Name	Type	Description	Required	Default	Options
userId	`Int32`	User Id	Required

Returns

[[AdditionalInfo Script API Type|AdditionalInfo]]