Difference between revisions of "Swivel Core V4 Messaging Menu"

From Swivel Knowledgebase
Jump to: navigation, search
(User Alerts)
(Provisioning)
Line 32: Line 32:
  
 
== Provisioning ==
 
== Provisioning ==
[[File: MessagingProvisioning.jpg]]
+
[[File: MessagingProvisioning_1.png]]
  
 
These headers are used during mobile app provisioning and on the updating keys process just if the policy 'Enforce HTTP Header Checking' on [[Swivel_Core_V4_Policy_Menu#Self-Reset|Self-Reset]] section is set to yes. These headers help to uniquely identify a particular mobile device.
 
These headers are used during mobile app provisioning and on the updating keys process just if the policy 'Enforce HTTP Header Checking' on [[Swivel_Core_V4_Policy_Menu#Self-Reset|Self-Reset]] section is set to yes. These headers help to uniquely identify a particular mobile device.

Revision as of 11:19, 4 March 2020

General

MessagingGeneral 1.png

For each configured messaging type:

  • Identifier: Friendly name to uniquely identify the messaging from others in the list.
  • Class: Name of the Java class that implements the messaging type.
  • Strings per message: Number of security strings that will be sent in each message. Copy to alert messaging This allows the security strings set using this Transport to be also copied to a users alert messaging. This is for deployments where users may need to be sent strings via one messaging in certain circumstances and another under other circumstances
  • Destination attribute: User repository attribute to be used as the destination for messages sent via the messaging type. The destination attributes are defined for each repository on the Transports-Attributes screen.
  • Strings Repository group: User repository group whose members will receive security strings messages via the messaging type. Users should only be a member of a single messaging repository group, as otherwise they may receive messages via different messaging types in an unpredictable manner.
  • Alert repository group: User repository group whose members will receive alert messages via the messaging type. This may be the same as the repository group if it desired that users receive security strings and alerts via the same messaging type. Users should only be a member of a single alert repository group, as otherwise they may receive alert message via different messaging types in an unpredictable manner.
  • Push repository group: User repository group whose members will receive Push messages via the messaging type.
  • Voice repository group: User repository group whose members will receive interact Voice messages via the messaging type.

Multiple messaging types using a single class can be created by cutting and pasting the class name (e.g. com.swiveltechnologies.transport.SmtpTransport) to another entry and filling the remaining fields.

Configuration for individual messaging types will only become available in the left hand menu once it has been associated with a repository group.

User Alerts

MessagingUserAlerts 1.png

  • PIN changed: Enable/disable the sending of alerts informing users that their PIN has been changed.
  • PIN change required: Enable/disable the sending of alerts informing a user that they must change their PIN before their next authentication.
  • PIN expiry warning: Enable/disable the sending of alerts informing a user that their PIN is about to expire.
  • Account locked: Enable/disable the sending of alerts informing a user that their account has been locked.
  • Account unlocked: Enable/disable the sending of alerts informing a user that their account has been unlocked.
  • Account inactive: Enable/disable the sending of alerts informing a user that their account has been inactive.
  • Account inactive warning(days): Enable/disable the sending of alerts informing a user that their account is going to get inactive in # days.
  • Device key allocated: Enable/disable the sending of alerts informing a user of the allocation of a PositiveID device key.
  • No transport is error: Normally, if a user has no transport attribute, it is logged as a warning. However, if that attribute is set to yes then it is logged as an error - mainly so it would trigger the audit report
  • Password changed: Enable/disable the sending of alerts informing users that their Password has been changed.

Provisioning

MessagingProvisioning 1.png

These headers are used during mobile app provisioning and on the updating keys process just if the policy 'Enforce HTTP Header Checking' on Self-Reset section is set to yes. These headers help to uniquely identify a particular mobile device.

Inbound STOP

MessagingInboundStop.jpg

  • Respond to STOP messages: Indicates if the platform needs to respond when it receives a message with the keyword indicated on the next attribute.
  • Keywords to respond to: Allows to define the keyword by default is set to STOP.
  • Message sent to sender: Message that will be sent as a respond of those kind of messages
  • Transport used to send message: SMTP

Messaging Common Attributes

Once a messaging type has been allocated to a group, the specific messaging can be configured. Configuration items will be specific for each transport but some are common across most or all transports and those are related to how the messages will be formatted.

  • Credentials alert message: Text to use for new credential alert messages sent to users. If the text contains "%NAME" this will be replaces with the user's username. If the text contains "%PASSWORD" this will be replaced with the user's new password. If the text contains "%PIN" this will be replaced with the user's new PIN.
  • App Provision Message: Text to use for provisioning the mobile app sent to users. If the text contains "%CODE" this will be replaces with the provisioning code. If the text contains "%URL_COMPLETE%SITE_ID/%NAME/%CODE" this will be replaced with URL to provision the device automatically.
  • Security string message header: Text to use as the header at the beginning of security string messages. If the text contains "%NUMBER" this will be replaced with the number of the security string message, which is useful for user identification of the most recent message received from Swivel.
  • String Delimeter: An optional character or characters that can be used to separate the individual characters within a security string, for example "->"
1->2->3->4->5->6->7->8->9->0
4->9->1->2->8->6->0->7->3->5
  • Vertical Strings: Allows strings to be displayed vertically, this makes them easier to read on certain smart phones
  • PIN expiry alert message: Text to use for PIN expiry alert messages. If the text contains "%DAYS" this will be replaces with the number of days until the PIN will expiry.
  • PIN change required alert message: Text to use for PIN change required alert messages.
  • PIN changed alert message: Text to use for PIN changed alert messages. If the text contains "%TIME" this will be replaced with the time and date at which the change occured.
  • Account locked alert message: Text to use for account locked alert messages. If the text contains "%TIME" this will be replaced with the time and date at which the lock occured.
  • Account inactive alert message: Text to use for account inactive alert messages.
  • Account lock warning: Text to use for account lock warning alert messages. If the text contains "%DAYS" this will be replaced with the days when the user account will get inactive.
  • Reset code alert message: Text to use for reset code alert messages. If the text contains "%CODE" this will be replaced with the self-reset code.

SMTP

MessagingSMTP.jpg

Please go to Messaging Common Attributes section to revised the different kind of messages that can be sent. SMTP also allows you to specify the email subject and the email from address. In addition it allows to indicate if the format is HTML. Credential and Provisioning App messages for SMTP have been defined with HTML templates by default so that attribute needs to be set to yes to be able to display them correctly. The images used on the SMTP templates can be updated from the Upload Email Images menu. To link a image on the SMTP template the attribute %BASE_URL is used. This attribute will be replaced by the value defined on the Base URL attribute on Server > Name section.

PNA

MessagingPNA.jpg

  • Timeout (ms): Notification timeout. If the notification is pressed or arrives after the specified time, a message will be shown to the user to indicate that the Authentication Request has expired.
  • Notification title: Text displayed on the device notification.
  • Notification body: Text displayed on the authentication screen of the Swivel Mobile App.
  • iOS cert password: iOS certificate password which should correspond with the kind of certificate that is being used: production or development. The certificate used will depend of the attribute 'Production environment'.
  • BB URL: Push URL for BB10 Swivel Mobile App.
  • BB application id: BB10 Swivel Mobile App's identifier.
  • BB password: Push password for BB.
  • Android key: Key related with the Swivel Mobile app used.
  • Production environment: Indicates if the current environment is development or production. Depending of this value the certificate used to send the notification to the device will be the production one or the development one.