Features

>What is a Feature?

>Lifecycle Stages of a Feature

>Prerequisites for Creating a Feature

>Creating a Feature

>Actions for Features

New to Sentinel EMS?
See How to Use Sentinel EMS?

What is a Feature?

A feature is a distinct functionality in a software application that can be independently licensed. Features are the basic building blocks of a product. You can bundle one or more features into a product according to your product monetization model. This lets you charge your customers per feature, giving your customers the flexibility to purchase only those features and capabilities that they actually need.

A feature can represent anything from a module to specific functionality such as Print, Save, or Draw, or an entire application.

For example, suppose you want to create a product called MySampleCalculator. You might include the following features:

F1 Add
F2 Subtract
F3 Multiply
F4 Divide

As part of your product monetization model, you might roll out the following flavors of the same product to the market:

>MySimpleCalculator (Add, Subtract)

>MyAdvancedCalculator (Add, Subtract, Multiply, Divide)

This lets you charge different prices according to feature usage.

Licensing Features

Sentinel EMS provides you the flexibility to apply a license model to each feature in a product. This helps to secure each feature and enables you to generate different types of licenses for a product according to your requirements.

You apply license models at different stages, depending on the enforcement:

> If you plan to secure a feature with Sentinel RMS, Sentinel Fit, Services, or a third-party enforcement, you can apply the license model when creating or editing the feature, when adding the feature to a product, or when adding the product to an entitlement.

> If you plan to secure a feature with Sentinel LDK, you can apply the license model when creating or editing the product that contains the feature, or when adding the product to an entitlement.

Lifecycle Stages of a Feature

When you create a feature, the current system date is automatically stored as the Creation Date attribute. The Deployed attribute defines the lifecycle stage of a feature.

>Deployed: The feature is included in a product that is part of an entitlement.

>Not Deployed: The feature is not deployed if:

The feature is not included in any product, OR

The feature is included in a product that is marked as a draft, OR

None of the products containing the feature are included in any entitlements.

Prerequisites for Creating a Feature

The following are the prerequisites for creating a feature:

>Permission (role) to create a feature must be available to the user.

> If you want to place the feature in a specific workspace, make sure that the relevant namespace is available.

Creating a Feature

You create a feature from the Features page.

To create a feature:

1.From the navigation pane, select Catalog > Features to view the Features page.

2.Click the Add Feature button.

3.Fill in the feature attributes.

4. Associate and configure the feature's license models.

Important

Some points to remember when creating a feature:

>Duplicate "name + version" combination is not allowed for features within the same namespace in Sentinel EMS.

>For cloud-served licenses, it is recommended not to have the same "name + version" combination for features across multiple namespaces.

Feature Attributes

The following table explains the feature attributes:

Attribute Description Required/Optional Valid Values
Namespace (Visible only if more than one namespace is available.)

The namespace in which the feature is stored.

The namespace allotted by Thales. (In Sentinel LDK, this is known as batch code.)

Required

>Any namespace in the list that is allocated for the required workspace (or enforcement if multiple enforcements are available)
For example, if you plan to use this feature with Sentinel Fit, select the appropriate enforcement.

Name

Name of the feature.

The validity of the feature name depends on the enforcement in use.

Required

> 1 to 24 characters

> Must be unique in a namespace

> Cannot contain: spaces and ! # % ^ [ ] < > & $

> Cannot be set to: 011, Ni, or NiL, which are reserved strings in Sentinel RMS

> 1 to 50 characters

> Cannot contain: < >

> 1 to 50 characters, case sensitive

> Cannot contain: spaces and ! # % ^ [ ] < > &

Version

Version of the feature.

Optional

> 0 to 11 characters

> Cannot contain: non-English characters, spaces, and ! # $

For cloud-served and cloud-connected entitlements, cannot contain: spaces and ! # % ^ [ ] < > & $

> Cannot be set to: 011 or NiL, which are reserved strings in Sentinel RMS

> The Name + Version combination must be unique in a namespace.

> For cloud-served licenses, it is recommended to use unique Name + Version combination in every namespace.

> 0 to 11 characters, case sensitive

ID

Unique identifier for the feature.

During runtime, the Sentinel Licensing API call uses the feature ID. Always ensure that the feature ID is the same in both Sentinel EMS and the Sentinel LDK application you are using to protect your application (Sentinel LDK Envelope or Sentinel Licensing API).

Required for:

> Cloud-based license models

> Sentinel LDK

> Sentinel Fit

  

Optional for:

> non-cloud-based license models

>Must be unique

> Number from 0 to 999999999

> Number from 1 to 65471

> The Name + ID combination must be unique across Sentinel EMS. (In other words, the same Name + ID combination cannot be used in multiple namespaces.)

> Number from 1 to 999999999

Description Additional information about the feature. Optional

>0 to 500 characters

Additional Attributes

External ID External reference identifier that identifies the feature in an external system. Optional

>Unique across Sentinel EMS for all features.

>0 to 60 characters

Ref ID 1

Reference identifier that identifies the feature in an external system.

For example, a feature code in your company's ERP system.

Optional

>0 to 100 characters

Ref ID 2 Reference identifier that identifies the feature in an external system. Optional

>0 to 100 characters

License Models

NOTE FOR SENTINEL LDK: Although you may see the Associate License Models pane when creating a feature, this pane is relevant only for features that use Sentinel RMSSentinel Fit, Services, and third-party enforcements. For features that use Sentinel LDK enforcement, you specify the license model when you create a product (or when you create an entitlement, if you select Define in Entitlement when creating a product).

After providing the attribute details, you can use the Associate License Models pane displayed below to associate one or more license models with the feature you are creating.

You must associate at least one license model with a feature to include that feature in a product. You can apply a license model when creating or editing a feature, or when adding a feature to a product.

When creating entitlements, only associated license models are available. Associating multiple license models with a feature provides the flexibility of selecting the relevant license model later when creating entitlements for your customers.

 
 

NOTE   Enforcement Type is displayed only if more than one enforcement type is available.

The following table describes the associated license model attributes:

Item Description
License Model Name

The name of the associated license model.

Enforcement Name

The name of the enforcement, for example Sentinel RMS or Sentinel Fit.

Enforcement Version The version of the enforcement, for example 10.1 or 1.5.
Default

The default license model for this feature.

When you create a product or entitlement, the default license model is automatically applied to the associated feature, simplifying the product and entitlement creation process. If needed, you can select another license model from the list of associated license models (instead of the default license model).

Required: Yes, if more than one license model is associated with a feature. If only one license model is selected, changing this value has no effect.

Possible values: Yes or No

Actions The actions you can perform on the license model line item.

Actions for Features

The following table lists the actions available for features:

Action Description
Edit button Edit

Updates information for an existing feature.

Note:

>Modifying a download definition requires appropriate permissions. For details, see Roles.

>You can modify details for features that are not deployed.

> For deployed features:

In a product, you cannot remove the default associated license model.

In an entitlement, you cannot remove any associated license model.

>For deployed features that have been activated, you cannot modify the feature name, feature ID, and version*.

Delete button Delete

Deletes a feature. Available only for non-deployed features and features that are included in a product that is not marked as "completed".

Copy button Copy
Duplicates an existing feature to create an identical copy. Edit the attributes as needed and save to create the new feature.