2.2 Create Custom Activity

In addition to the out-of-the-box User Authentication, you can create your own user activity, which is known as the Custom Activity. You can create rules customized to your business needs.

You can create a custom activity using either of the following methods.

Method 1

To create a custom activity, perform the following steps:

  1. Click the Application Navigation hamburger menu on top-left and click Adaptive Risk Management.
  2. On the Monitored User Activities page, click Create Custom Activity.
  3. On the What is a Custom Activity page, click Create Custom Activity.

Method 2

To create a custom activity, perform the following steps:

  1. Click the Application Navigation hamburger menu on top-left and click Custom Activities.
  2. Click Create.

Describe Activity

Elements Description
Enter a name for this Activity Specify a unique name for the custom activity.
Description Specify a description for the custom activity.

Create New Actor

An actor is a data structure that you can reuse in multiple custom activities. For example, an address actor could be used as a shipping address, billing address, home address, and so on.

To add an actor to a custom activity, click Next, and then do one of the following:

  • Click Select an Actor to add an existing actor provided out-of-the-box.
  • Click Create New Actor.

Select an Actor

Elements Description
Select Select an actor provided out-of-the-box. You now need to provide the following details for the selected actor:
  • Source Data: It refers to client data that is coming from a protected application as part of a transaction. For example, src.country.
  • Mapping Type: Mapping is a way to connect the source data to destination data and to actor. Select the mapping type as follows:
    • Select Direct if you want a one-to-one mapping of the source data element to the destination data element.
Provide instance name for this actor Specify the name of the instance for the actor.

Create New Actor

Elements Description
Name Specify a unique name of the actor. For example, for the Address actor, enter Address in the Name field.
Description Specify the description of the actor. For example, you can enter Address of customer.
Add Data Use the Add Value page to specify the data elements that are part of that actor.

For an actor like Address, the attributes could be Address Line1, Address Line2, Address Line3, City, State, Zipcode, and Country.

Define the data elements for each attribute of an actor by following these instructions:

  • Name: Specify a name for the attribute. For example, Address Line1.
  • Description: Specify a description for the attribute. For example, the address of the customer logging in.
  • Required: Use the toggle button to specify whether the element is required in the Required field.

    Some attributes are not required all the time because the actor can function without this data. For example, "Address Line2" in an address is not required since many addresses do not have this attribute.

  • Data Type: Specify the data type of the attribute.

    A data type is an attribute that specifies the type of data that the attribute can take: Boolean, String, Numeric, and Date.

  • Encrypted: Use the toggle button to specify whether the element should be encrypted.

    If Encrypted is set toTrue, data is encrypted so that it can be stored securely in the database to protect sensitive data.

    Encryption is used for string data fields only; other data fields are not required to be encrypted.

Activity Details

Details are unique for each monitored activity and therefore not reusable across different user activities. For example, the total dollar amount for a purchase activity would not be reused in multiple activities, so it should be custom data and not actor.

Example of custom data are as follows:

  • Dollar Amount
  • Coupon Code
  • Item Number

After you create an actor, click Next, and then click Add Details.

Elements Description
Name Specify a name for the activity detail.
Description Specify a description for the activity detail.
Required Use the toggle button to specify whether the element is required in the Required field.
Data Type Specify the data type of the attribute.

A data type is an attribute that specifies the type of data that the attribute can take: Boolean, String, Numeric, and Date.

Encrypted Use the toggle button to specify whether the element should be encrypted.

Encryption is used for string data fields only; other data fields are not required to be encrypted.

You must bear the following points in mind:

  • You can enable a custom activity only when you have defined the mapping of all the actors or custom data that you have added in the custom activity.
  • You cannot delete an enabled custom activity. You must first disable the custom activity, and then delete it.