Features

>What Is a Feature?

>Prerequisites for Creating a Feature

>Lifecycle Stages of 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 a license model when creating or editing a feature, or when adding a feature to a product.

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

> Supported for Sentinel RMS Supported for Sentinel Fit Supported for Services Supported for third-party license enforcements 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.

> Supported for Sentinel LDK 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.

Prerequisites for Creating a Feature

>A role that includes Catalog (Namespace) permissions for the relevant namespace. (You cannot move an entity from one namespace to another.) At minimum, the vendor user needs the Add permission. For details, see Roles.

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.

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.

Important

Some points to remember when defining the feature attributes:

>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.

4. Supported for Sentinel RMS Supported for Sentinel Fit Supported for Services Supported for third-party license enforcements Associate and configure the feature's license models.

5.Click Save.

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 ! # % ^ [ ] < > & > 1 to 50 characters > 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 NiL, which is a reserved string 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 > 0 to 11 characters > Cannot contain: spaces and ! # % [ ] < > & $ "
Identifier	Unique identifier for the feature. During runtime, the Sentinel Licensing API call uses the Feature Identifier. Always ensure that the Feature Identifier 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 + Identifier combination must be unique across Sentinel EMS. (In other words, the same Name + Identifier 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 uniquely identifies the feature user 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

Supported for Sentinel LDK 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 RMS, Sentinel 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. If you do not want to associate a specific license model at this stage, you can configure the license model as Define in Entitlement while creating a product. This enables the order taker to set the license model when creating an entitlement.

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.

	Sentinel RMS example
	Sentinel Fit example

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.2 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	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 Identifier, and version*.
	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	Duplicates an existing feature to create an identical copy. Edit the attributes as needed and save to create the new feature.

Action

Description

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.

> Supported for Sentinel RMS Supported for Sentinel Fit Supported for Services Supported for third-party license enforcements 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 Identifier, and version*.

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

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