Step 1. Define Security Labels - Required
To define your security labels and specify their display names and descriptions, complete the following steps:
1. Navigate to the following source file:
<Windchill>/src/wt/access/accessModelRB.rbInfo
where <Windchill> is the installed location of your Windchill solution. If you are using a different locale, find the corresponding RBINFO file for that locale.
2. Copy the accessModelRB.rbInfo file to the following location:
<Windchill>/wtCustom/wt/access
|
|
If the <Windchill>/wtCustom directory does not already exist in your installation, and your site has not already implemented a parallel directory structure for site specific files, complete the following steps to implement it:
a. Create the following directory:
<Windchill>/wtCustom
By default this is the directory root recognized by Windchill for custom directories, as specified in the wt.generation.custom.dir property in tools.properties. For more information see the Windchill Customization Guide.
b. Create additional subdirectories within the <Windchill>/wtCustom directory as needed.
|
3. Open the <Windchill>/wtCustom/wt/access/accessModelRB.rbInfo file in a text editor.
4. For each security label, add the following lines, making sure not to include any spaces except in the <DISPLAY_NAME> or the <LONG_DESCRIPTION>:
WCTYPE|wt.access.SecurityLabeled~SCA|<SECURITY_LABEL>.value=<DISPLAY_NAME>
WCTYPE|wt.access.SecurityLabeled~SCA|<SECURITY_LABEL>.dataType=java.lang.String
WCTYPE|wt.access.SecurityLabeled~SCA|<SECURITY_LABEL>.serverFunction=
com.ptc.core.foundation.security.server.impl.SACFSecurityLabel
WCTYPE|wt.access.SecurityLabeled~SCA|<SECURITY_LABEL>.serverFunction.arg1=
PID{<SECURITY_LABEL>}
WCTYPE|wt.access.SecurityLabeled~SCA|<SECURITY_LABEL>.longDescription=
<LONG_DESCRIPTION>
where:
◦ <SECURITY_LABEL> is the security label name. This value should use only alphanumeric characters and the underscore character. The string
WCTYPE|wt.access.SecurityLabeled~SCA|<SECURITY_LABEL> is the value that will be specified for the
SecurityLabelResourceKey element for the security label in
Edit the Security Labels Configuration File. While there is no requirement for the
<SECURITY_LABEL> value to match the
name attribute specified for the
SecurityLabel element in the security labels configuration file, that is the convention used in this guide.
|
|
A security label name is stored as a server-calculated attribute (SCA). Each SCA must have a unique name. The Logical Attributes Report provides a list of all current SCAs. You can access this report from <Windchill>/netmarkets/jsp/lwcType/logicalAttributesReport.jsp.
|
◦ <DISPLAY_NAME> is the name of the security label as it will display in the user interface.
◦ <LONG_DESCRIPTION> is the long description of the security label. The long description is displayed in the automatically generated description for the security label, accessed by clicking the view security label information icon
from the
Security Labels table.
For example, add the following lines to the end of the file for configuring the example security labels. (These lines have been formatted to fit the page; enter each WCTYPE definition on one line.)
WCTYPE|wt.access.SecurityLabeled~SCA|CORPORATE_PROPRIETARY.value=
Corporate Proprietary
WCTYPE|wt.access.SecurityLabeled~SCA|CORPORATE_PROPRIETARY.dataType=
java.lang.String
WCTYPE|wt.access.SecurityLabeled~SCA|CORPORATE_PROPRIETARY.serverFunction=
com.ptc.core.foundation.security.server.impl.SACFSecurityLabel
WCTYPE|wt.access.SecurityLabeled~SCA|CORPORATE_PROPRIETARY.serverFunction.arg1=
PID{CORPORATE_PROPRIETARY}
WCTYPE|wt.access.SecurityLabeled~SCA|CORPORATE_PROPRIETARY.longDescription=
The "Corporate Proprietary" label indicates the business object's level
of corporate sensitivity
WCTYPE|wt.access.SecurityLabeled~SCA|EXPORT_CONTROL.value=Export Control
WCTYPE|wt.access.SecurityLabeled~SCA|EXPORT_CONTROL.dataType=java.lang.String
WCTYPE|wt.access.SecurityLabeled~SCA|EXPORT_CONTROL.serverFunction=
com.ptc.core.foundation.security.server.impl.SACFSecurityLabel
WCTYPE|wt.access.SecurityLabeled~SCA|EXPORT_CONTROL.serverFunction.arg1=
PID{EXPORT_CONTROL}
WCTYPE|wt.access.SecurityLabeled~SCA|EXPORT_CONTROL.longDescription=
The "Export Control" label indicates the business object's level
of export sensitivity
WCTYPE|wt.access.SecurityLabeled~SCA|LEGAL_INFORMATION.value=Legal Information
WCTYPE|wt.access.SecurityLabeled~SCA|LEGAL_INFORMATION.dataType=java.lang.String
WCTYPE|wt.access.SecurityLabeled~SCA|LEGAL_INFORMATION.serverFunction=
com.ptc.core.foundation.security.server.impl.SACFSecurityLabel
WCTYPE|wt.access.SecurityLabeled~SCA|LEGAL_INFORMATION.serverFunction.arg1=
PID{LEGAL_INFORMATION}
WCTYPE|wt.access.SecurityLabeled~SCA|LEGAL_INFORMATION.longDescription=
The "Legal Information" label indicates whether the business
object contains legally sensitive information
WCTYPE|wt.access.SecurityLabeled~SCA|THIRD_PARTY_PROPRIETARY.value=
Third Party Proprietary
WCTYPE|wt.access.SecurityLabeled~SCA|THIRD_PARTY_PROPRIETARY.dataType=
java.lang.String
WCTYPE|wt.access.SecurityLabeled~SCA|THIRD_PARTY_PROPRIETARY.serverFunction=
com.ptc.core.foundation.security.server.impl.SACFSecurityLabel
WCTYPE|wt.access.SecurityLabeled~SCA|THIRD_PARTY_PROPRIETARY.serverFunction.arg1=
PID{THIRD_PARTY_PROPRIETARY}
WCTYPE|wt.access.SecurityLabeled~SCA|THIRD_PARTY_PROPRIETARY.longDescription=
The "Third Party Proprietary" label indicates the business
object's level of third party corporate sensitivity
| Do not delete or alter the existing lines that begin with: • WCTYPE|wt.access.SecurityLabeled~SCA|ALL_SECURITY_LABELS • WCTYPE|wt.access.SecurityLabeled~SCA|ALL_STANDARD_SECURITY_LABELS • WCTYPE|wt.access.SecurityLabeled~SCA|ALL_CUSTOM_SECURITY_LABELS |
5. Save and close.
6. From within a windchill shell, run one of the following commands to build the resource bundle. With the <Windchill>/wtCustom directory created, the system automatically builds the RBINFO files found in the <Windchill>/wtCustom directory, rather than the files found in the <Windchill>/src directory.
◦ For a Windows system:
ResourceBuild wt.access.accessModelRB
◦ For a UNIX system:
ResourceBuild.sh wt.access.accessModelRB
