SMS Event Subscriber (Loginapp)
Description
An event subscriber that sends an SMS to notify a user.
May be used by
Properties
SMS Settings (
smsSettings) Description
Settings to send a SMS to the notified user.
Attributes
Plugin-Link
Mandatory
Assignable plugins
Phone Number Providers (
phoneNumberProviders) Description
Provides the phone numbers to which the notification will be sent.
Attributes
Plugin-List
Mandatory
Assignable plugins
Message Resource Key (
messageResourceKey) Description
The resource key under which the localized template for the sms message can be found. The following syntax can be used to include data in the template.
- ${valueMapKey} for the value of valueMapKey provided by any of the configured Value Map Providers.
- ${event.createdAt,date,format} to include the date/time at which the event was created, where "format" is a date pattern like "yyyy-MM-dd HH:mm:ss".
- event.createdAt
- event.data.airlock2FAAccountId
- event.data.airlock2FADeviceId
- event.data.activeAuthenticationMethod
- event.data.authenticationMethods
- event.data.browser
- event.data.city
- event.data.contextDataChanged.%s.newValue (where "%s" is replaced by the context-data field name).
- event.data.contextDataChanged.%s.oldValue (where "%s" is replaced by the context-data field name).
- event.data.countryCode
- event.data.crontoDeviceId
- event.data.device
- event.data.deviceTokenId
- event.data.fidoCredentialId
- event.data.fidoPublicKeyCredentialId
- event.data.oauth2.authorizationServerId
- event.data.fidoRelyingPartyId
- event.data.lockReason
- event.data.mtanNewPhoneNumber
- event.data.mtanNumberId
- event.data.mtanOldPhoneNumber
- event.data.newEmailAddress
- event.data.newRealm
- event.data.oauth2.acceptedScopes
- event.data.oauth2.alwaysGrantedScopes
- event.data.oauth2.clientId
- event.data.oauth2.deniedScopes
- event.data.oldEmailAddress
- event.data.oldRealm
- event.data.operatingSystem
- event.data.previousAuthenticationMethod
- event.data.stepResult.attributes.<attribute-name> (where <attribute-name> ist the name of the additional attribute, could be nested.)
- event.data.stepResult.errorCode
- event.data.stepResult.nextAction
- event.data.stepResult.type
- event.data.userId
- event.id
- event.metadata.requestIp
- event.metadata.userAgent
- event.source.applicationId
- event.source.configurationContext
- event.source.flowId
- event.source.stepId
Attributes
String
Optional
Default value
sms.notification.message
Language (
language) Description
A String Value Provider which provides the language of the message. It is recommended to use a context data field and not the display language, as latter could be misused by an attacker to confuse the victim with an unknown language.
Attributes
Plugin-Link
Mandatory
Assignable plugins
Changed Email Address Provider Display Language String Provider Fallback String Value Provider Generic Session Attribute String Provider HTTP Request Cookie Value Provider HTTP Request Header Value Provider Identity Value Provider OAuth 2.0/OIDC Authorization Request Parameter Value Provider OAuth2 Access Token String Value Provider Realm String Provider Static String Value Provider String Context Data Value Provider String From Map Value Provider Template-based String Provider Ticket String Provider Transforming String Value Provider Translated String Provider User Principal Name Provider mTAN Registration Label Provider mTAN Registration Number Provider
Value Map Providers (
valueMapProviders) Description
Mappings that are used to replace the variables in the localized templates for the notification's content. The value map providers are called in the configured order and their values are added to a map. Later added values will overwrite earlier ones if they have the same key.
Attributes
Plugin-List
Optional
Assignable plugins
Additional Password Check Attribute Map Airlock 2FA Authentication Data Map Airlock 2FA Login ID Parameter Authentication Data Map Conditional Value Map Provider Context Data Map Edited Context Data Map Generic Session Attribute Value Map Provider HTTP Request Information Map OAuth 2.0 Credential Context Data Map OAuth 2.0 Tokens Map Roles Provider SSI Verification Data Provider SSO Ticket Context Data Provider Script Execution Result Value Map Provider Transaction Approval Parameters Map Transforming Value Map Provider User Identity Map User Passwords Map User Statistics Map Value Provider Map mTAN Token Flow Value Map
Event (
event) Description
The general Loginapp event about which the subscriber should be notified.
Attributes
Plugin-Link
Mandatory
Assignable plugins
Airlock 2FA Device Activated Airlock 2FA Device Deleted Airlock 2FA Device In Cooldown Used Authentication Flow Successfully Completed Authentication Method Changed Context Data Changed Cronto Device Activated Cronto Device Deleted Cronto Letter Ordered Device Token Deleted Device Token Registered Email Address Added Email Address Changed Email Address Deleted FIDO Credential Deleted FIDO Credential Registered Filtered Flow Event Generic Step Result Generic Step Result With Identified User Logged in from new Device MTAN Token Deleted MTAN Token Phone Number Changed MTAN Token Registered OATH OTP Secret Added OATH OTP Secret Viewed OAuth 2.0 User Consent Processed Password Changed Password Letter Ordered User Created User Locked User Realm Changed User Unlocked
YAML Template (with default values)
type: LoginappSmsEventSubscriber
id: LoginappSmsEventSubscriber-xxxxxx
displayName:
comment:
properties:
event:
language:
messageResourceKey: sms.notification.message
phoneNumberProviders:
smsSettings:
valueMapProviders: