Concepts and general settings

Overview

The Business Partner License tool is a web application delivered with the setup. It allows you to create, edit, and display policy and license files.

A policy file describes an application, the content, as well as what should be controlled. It is linked to a product and can be versioned.

A license file is granted to a customer. It is based on a policy file, and it stores the information that you have decided to control in the policy, for example, the number of authorized badges.

You can download any license file and it will include the policy and partner files. All files will automatically be signed digitally with your private key.

Management of policies and licenses will be locked until you upload the partner file digitally signed by Sage X3. The procedure to obtain the file is explained in the previous chapter Delivery and installation.

Partner file

An RSA key pair will be generated for the business partner during installation of the tool. The public key must be sent to Sage X3, who will then create and digitally sign a partner file that will be sent back to the business partner.

It is not possible to create or edit any policy or license files before the tool has obtained the partner file.

The partner file can be uploaded in the General section. The partner file will influence the rules for badge naming. A badge name may start with Y, or with one of the prefixes declared in the dictionaryPrefix property. For example, when the value for the dictionaryPrefix is XNB-XND,XX01-XX02,XZ the badge name can be: XNB*, XNC*, XND*, XX01*, XX02*, XZ*, or Y*. The asterisk represents an arbitrary number of characters of the set A-Z and 0-9.

  1. Click the General section to get the public key.

  2. Click the Download public key button:

  3. The following file will display:

  4. You will receive a JSON file, which is signed with your Sage X3 private key:

  5. You must import the file into the application:

  6. After the import, the signed partner file containing all the functions will become available. Click + Create to create policy and license files:

User management

To use the tool, you must enter a login and password in the browser. The following should be entered:

  • Login

  • Name

  • Password

  • Administrative user flag set to Y/N

After logging in, the name of the user will be displayed in the application. Administrative users can create and delete other users, and set passwords. Non-administrative users can just view and change their own data, including setting a new password for themselves. There are no other difference between administrative and non-administrative users.

You will remain logged in if you do not close your browser.

Locales

A policy file may contain many items with different localizations. To be able to enter data for a policy file easier and faster, you can enter standard locales which always display.

Technical information

This tool uses JavaScript in the browser, but not cookies. You have to complete the browser program, not just a tab, to log out or change a user, as the browser will continue to store the authentication information.

This tool utilizes files stored in the license tool directory and sub-directories, and does not use a database.