Manuals / Black Box / Kitchen Appliance / Appliance Trim Kit

Black Box ET0100A, ET1000A, ET0010A, EncrypTight manual

Models: EncrypTight ET0100A ET0010A ET1000A

1 352

Download 352 pages 21.02 Kb

Page 259

Modifying the ETKMS Properties File

260	EncrypTight User Guide

Image 259

Black Box ET0100A, ET1000A, ET0010A, EncrypTight manual

Contents

EncrypTight User Guide Table of Contents Managing EncrypTight Users Provisioning Appliances Getting Started with EtemsManaging Appliances 117 Creating Vlan ID Ranges for Layer 2 Networks Managing Key Management SystemsManaging IP Networks Managing Network SetsPolicy Design Examples 211 Modifying the Etkms Properties File Using Enhanced Security FeaturesEtep Configuration 299 302 Index 343 About This Document PrefaceContacting Black Box Technical Support Part I EncrypTight Installation and Maintenance EncrypTight User Guide Distributed Key Topologies EncrypTight OverviewLayer 2 Ethernet topologies Network topologiesTopology Description Layer 3 IP topologiesRelated topics EncrypTight ElementsPolicy Manager EncrypTight Element Management SystemKey Management System Single Etkms for multiple sites Policy Enforcement PointShared keys Point-to-Point Negotiated TopologyLayer 2 Point-to-Point Deployment Security within EncrypTightSecure Key Storage within the Etkms Secure Communications Between DevicesEncrypTight Component Connections EncrypTight Deployment PlanningEtpm to Etkms Connections Management Station ConnectionsEtpm and Etkms on Different Subnetworks Etpm and Etkms on the Same SubnetworkEtpm and Etkms in Layer 3 IP Policies Out-of-band Etkms management in an Ethernet network External Etkms to Etkms Connections Connections for Backup ETKMSsEtkms to Etkms Connections in Ethernet Networks Connecting Multiple ETKMSs in an IP NetworkEtkms to PEP Connections in IP Networks Etkms to PEP ConnectionsIn-line Etkms to PEP communications in IP networks Etkms to PEP Connections in Ethernet NetworksIPv6 Address Support Network Clock SynchronizationIPv6 address representations Certificate SupportAddress Format Address Representation Network Addressing Options Network Addressing for IP NetworksAddressing Method Description Related topics Before You Start Installation and ConfigurationThird party management station software Hardware RequirementsSoftware Requirements EncrypTight management station requirementsFirewall Ports EncrypTight Software InstallationInstalling EncrypTight Software for the First Time To install the EncrypTight softwareStarting EncrypTight Uninstalling EncrypTight SoftwareTo uninstall EncrypTight Upgrading to a New Version of EncrypTightRelated topic Management Station ConfigurationExiting EncrypTight To start EtemsEtems communications options To enable the Microsoft FTP Server serviceSecuring the Management Interface Enabling the Microsoft FTP ServerEtkms server connections Installing ETKMSsConfiguring ETKMSs Configuring the Syslog ServerAbout Local ETKMSs Basic Configuration for Local ETKMSsAdding a Local Etkms To launch a local Etkms Launching and Stopping a Local EtkmsStarting the Local Etkms Automatically To add a local EtkmsMaintaining the start.bat file Configuring External ETKMSsPrior to configuring the batch file do the following To configure the batch fileTo log into the Etkms Changing the Admin PasswordTo change the admin password Logging Into the EtkmsTo change the root password Changing the Root PasswordIPv4 Configure the Network ConnectionTo configure the network connection and hostname Static IP Netmask Default Gateway IP addressIPv6 To configure the network interfaceTo set the hostname and IPv6 default gateway address To set the default DNS server and configure the hosts fileTo set up time synchronization Configure Time and Date PropertiesTo set the time zone Field Description Ntpq -p command outputTo restart the NTP daemon To check the time source connection statusCheck the Status of the Hardware Security Module Starting and Stopping the Etkms ServiceChecking the Status of the Etkms Configuring Syslog Reporting on the ETKMSsTo check the status of the Etkms service To configure syslog reporting on a EtkmsPolicy Enforcement Point Configuration Etep Throughput Speeds Default User Accounts and PasswordsPasswords to change Managing LicensesChoose Tools Put License Installing LicensesTo install a license on the Etep To enter EncrypTight licensesUpgrading Etep Licenses Next StepsUpgrading Licenses Upgrading the EncrypTight LicenseNext Steps Installation and Configuration EncrypTight User Guide Working with EncrypTight User Accounts Managing EncrypTight UsersTask Administrator User Configuring EncrypTight User AuthenticationEncrypTight account types and privileges Login Session Inactivity Timer Password Authentication and ExpirationCommon Access Card Authentication DoD Login Banner Parameter User Name Password Login preferences default settingsEncrypTight user name and password conventions Preference SettingTo modify an EncrypTight user account Changing an EncrypTight User PasswordTo change a password To add an EncrypTight user accountRelationship between EncrypTight users and Etep users Example 1 Default EncrypTight user and default Etep userExample 2 Setting up new EncrypTight and Etep users How EncrypTight Users Work with Etep UsersExample 3 Adding a new Etep user to EncrypTight Working with the EncrypTight Workspace Maintenance TasksAbout the EncrypTight Workspace To save a workspace to a new location Saving a Workspace to a New LocationOn the File menu, click Save Workspace To To load an existing workspace Loading an Existing WorkspaceTo delete a workspace Moving a Workspace to a New PCDeleting a Workspace To move a workspace to a new PCSchedule the Upgrade Installing Software UpdatesPrepare Etpm Status and Renew Keys Upgrade the EncrypTight SoftwareVerify Etkms Status and Deploy Policies To deploy policies Upgrade PEP SoftwareOn the Tools menu, click Upgrade Software To upgrade software on the PEPsFTP server site information for appliance software upgrades To check the status of the PEPs Click Edit Multiple Configurations Software VersionChange the PEP Software Version and Check Status To change the software version of the PEPsUpgrading External ETKMSs Return Status Refresh and Key Renewal to Original SettingsTo stop and remove the current Etkms software To start the Etkms software To install the new Etkms softwareTo configure the new Etkms software To mount the Cdrom driveMaintenance Tasks EncrypTight User Guide Etems Part II Working with Appliances usingEncrypTight User Guide Getting Started with Etems Defining Appliance ConfigurationsEtems Quick Tour Interface configuration for a new ET1000A appliance Pushing Configurations to AppliancesUpgrading Appliance Software Comparing ConfigurationsMaintenance and Troubleshooting Policy and Certificate Support Understanding the Etems WorkbenchEditors Appliance Manager perspective ViewsEtems toolbar ToolbarsPerspectives To open a perspectiveAppliance Manager toolbar Status IndicatorsCertificate Manager toolbar EncrypTight User Types Appliance status indicatorsStatus Indicator Description Understanding RolesTo change communication preferences Function Administrator OpsModifying Communication Preferences Appliance roles for ETEPsGeneral communication preferences Strict authentication communication preferencesPreference Description Policy Extensions Ignore CRL accessEnable Certificate CRL File LocationProvisioning Basics Provisioning AppliancesNew Appliance editor for the ET1000A To add a new appliance Adding a New ApplianceOn the Tools menu, click Put Configurations Saving an Appliance ConfigurationSaving appliance configurations To push Etems configurations to appliancesViewing Appliance Status Put configuration statusResult Description Appliances view To configure automatic status checkingEtems To apply a filter to the appliances in the Appliances view Filtering Appliances Based on AddressEtep User Roles Rebooting AppliancesTo reboot appliances Appliance User ManagementAppliance roles for ETEPs v 1.4 and later Configuring the Password Enforcement PolicyDefault user names and passwords on the Etep Role Default user name Default passwordStrong Password Policy Conventions Default Password Policy ConventionsUser Name Conventions Upgrading Software Removing ETEPs From ServiceOn the Tools menu, click Appliance User Add User Managing Appliance UsersAdding Etep Users To add a user to the EtepDefault password Strong password Parameter Policy Password policy valuesOn the Tools menu, click Appliance User Modify User Modifying Etep User CredentialsDeleting Etep Users To modify Etep user credentialsTo delete a user from the Etep Viewing Etep UsersOn the Tools menu, click Appliance User Delete User On the Edit menu, click Default Configuration Working with Default ConfigurationsCustomizing the Default Configuration To customize the default configurationProvisioning Large Numbers of Appliances Restoring the Etems Default ConfigurationsTo return the default values to factory settings On the Edit menu, click Default ConfigurationsImporting Configurations from a CSV File Creating a Configuration TemplateAttribute Description To import appliance configurations to EtemsRemote and local keywords and attributes Importing Remote and Local Interface AddressesChanging Configuration Import Preferences To shut down the Etep Shutting Down AppliancesChecking the Time on New Appliances Shutdown operational codesManaging Appliances Editing ConfigurationsChanging the Address on the Appliance Changing the Management IP AddressTo change the management IP address on the appliance Change Management IP window Related topics Changing the Address in EtemsOperation failed message in response to management IP change Changing the Date and TimeTo change the date and time Changing Settings on a Single ApplianceChanging Settings on Multiple Appliances To edit the configuration of a single applianceDeleting Appliances To update an appliance setting on multiple appliancesTo delete appliances Connecting Directly to an ApplianceConnecting to the Command Line Interface Upgrading Appliance Software124 EncrypTight User Guide On the Tools menu, click Upgrade Software To upgrade software126 EncrypTight User Guide Checking Upgrade Status Restoring the Backup File SystemCanceling an Upgrade What to do if an Upgrade is InterruptedTo restore the appliance file system from a backup copy Part III Using Etpm to Create Distributed Key Policies 130 EncrypTight User Guide To open Etpm Getting Started with EtpmOpening Etpm About the Etpm User InterfaceEtpm perspective Component Chapter EncrypTight Components ViewEditors EditorsTo edit an element from the policy view Etpm Status IndicatorsStatus indicators Policy ViewRelated topic Sorting and Using Drag and DropEtpm toolbar To enable or disable automatic status checkingEtpm Toolbar Etpm Status Refresh IntervalIP Policies About Etpm PoliciesEthernet Policies Policy generation and distribution Policy Generation and DistributionKey generation with one Etkms Key generation with multiple ETKMSs Creating a Policy An OverviewNetwork Set B Network aNetwork B Network Set aTo create a policy 144 EncrypTight User Guide EncrypTight User Guide 145 146 EncrypTight User Guide Provisioning PEPs Managing Policy Enforcement PointsConfiguration Description EncrypTight PEP configurationAdding a New PEP in Etems On the Advanced tab, select Enable Sntp Client On the Features tab, select Enable passing TLS trafficTo add a new PEP using Etpm Adding a New PEP Using EtpmAdding Large Numbers of PEPs Editing PEPs Pushing the ConfigurationTo push Etems configurations to PEPs To edit a PEP’s configurationEditing PEPs From Etpm To change the NTP settings for multiple PEPsSelect Edit Multiple Configurations Sntp Client Editing Multiple PEPsTo change the IP address of a PEP Deleting PEPsChanging the IP Address of a PEP Changing the PEP from Layer 3 to Layer 2 EncryptionTo delete PEPs Etkms connections Managing Key Management SystemsTo add an Etkms Adding ETKMSsTo edit an existing Etkms Editing ETKMSsDeleting ETKMSs Etkms entriesTo delete an existing Etkms Adding Networks Managing IP NetworksAddress Network Mask To add a networkNetwork entries Network IPGrouping Networks into Supernets Advanced Uses for Networks in PoliciesUsing Non-contiguous Network Masks IP Address Network Mask Networks definitionsDeleting Networks Editing NetworksTo edit an existing network To delete a network Managing IP Networks 166 EncrypTight User Guide Network Sets Managing Network SetsIP address Mask 40.32.21.0 255.255.255.0 Types of Network SetsIP address Mask 40.55.11.0 255.255.255.0 IP address Mask Network set for a collection of networksTo add a Network Set Adding a Network SetNetwork Set fields Mode Key ManagementSystem Network AddressingNetwork Set editor Importing Networks and Network SetsNetworks and network sets import document format in Excel To edit a Network Set Editing a Network SetDeleting a Network Set To import networks and network sets into EtpmTo delete an existing network set Managing Network Sets 176 EncrypTight User Guide Adding a Vlan ID Range Creating Vlan ID Ranges for Layer 2 NetworksTo add a new Vlan ID Range Lower Vlan ID Vlan ID range entriesUpper Vlan ID To delete an existing Vlan ID range Editing a Vlan ID RangeDeleting a Vlan ID Range To edit a Vlan ID range180 EncrypTight User Guide Policy Concepts Creating Distributed Key PoliciesSchedule for Renewing Keys and Refreshing Policy Lifetime Policy PriorityEncapsulation Policy Types and Encryption MethodsLayer 2 Ethernet payload encryption Aria Encryption Encryption and Authentication AlgorithmsTo use Aria in an encryption policy, do the following Using Encrypt All Policies with Exceptions Addressing ModeKey Generation and ETKMSs Encrypt all policy with exceptions Policy Size and Etep Operational LimitsPolicy Policy Type Priority Action Protocol Covered Minimizing Policy Size To add a new Layer 2 mesh policy Adding Layer 2 Ethernet PoliciesLayer 2 Mesh policy entries Layer 2 Mesh policy editor Adding a Hub and Spoke Policy Adding Layer 3 IP PoliciesHub and spoke policy entries To add a new hub and spoke policySize IPSecAddressing Minimize PolicyHub and spoke policy editor To add a new mesh policy Adding a Mesh PolicyField Description Mesh policy entriesSpecifies a method for reducing the policy size Mesh policy editor Multicast network example Adding a Multicast PolicyMulticast policy entries To add a multicast policyNetwork MulticastMulticast policy editor To add a point-to-point policy Adding a Point-to-point PolicyField Description Point-to-point policy entriesPoint B Point aNetwork Set Point a PortsPoint-to-point policy editor Adding Layer 4 PoliciesVerifying Policy Rules Before Deployment Policy DeploymentTo create a new Layer 4 policy To verify policies Setting Deployment Confirmation PreferencesTo enable or disable the deployment warning Deploying PoliciesEditing policies Editing a PolicyDeleting Policies To edit an existing policyTo delete all policies To delete an existing policySelect Tools Clear Policies Basic Layer 2 Point-to-Point Policy Example Policy Design ExamplesSetting PEP Layer 2 Ethernet Policy Using Vlan IDsPoint-to-point Layer 2 encryption policy Policy 3 Discard All Other Policy 2 Partner and Partner Portal ServerEncrypt Traffic Between Regional Centers Complex Layer 3 Policy ExampleNetwork sets for mesh policy Encrypt Traffic Between Regional Centers and BranchesEncrypt all mesh policy Region a hub and spoke policy Network sets for the hub and spoke policiesField Region B hub and spoke policyRegion C hub and spoke policy Region D hub and spoke policyPass protocol 88 in the clear mesh policy Passing Routing ProtocolsEncrypTight User Guide 219 Policy Design Examples 220 EncrypTight User Guide Part IV Troubleshooting 222 EncrypTight User Guide Possible Problems and Solutions Etems TroubleshootingPreferences Symptom Explanation and possible solutionsConfig to Appliance Appliance UnreachableDisable-trusted-hosts CLI command Appliance ConfigurationAppliance Tools Reboot Pushing ConfigurationsCompare Config to Appliance . Do one of the following To ping the management port Software UpgradesAbout upgrades show system-log and show upgrade Status Pinging the Management PortRetrieving Appliance Log Files Tools preferences To change the default ping toolOn the Tools menu, click Retrieve Appliance Logs To retrieve log files from an applianceFTP server site information for log retrieval Viewing Statistics Viewing Diagnostic DataStatistic Description Etep StatisticsExporting SAD and SPD Files Viewing Port and Discard StatusTo access the appliance CLI CLI Diagnostic CommandsViewing the Application Log from within EncrypTight Working with the Application LogTo view the log information Sending Application Log Events to a Syslog Server Setting Log FiltersExporting the Application Log Log File Actions Other Application Log ActionsIcon Description Learning About Problems Etpm and Etkms TroubleshootingMonitoring Status Etpm status problems and solutions Symptoms and SolutionsEtep PEPs, see the EncrypTight User Guide Policy ErrorsRenew Key Errors Status ErrorsEtpm Log Files Viewing Log FilesEtkms Log Files Etkms Server Operation Etkms Troubleshooting ToolsLinux Commands Command DescriptionShutting Down or Restarting an External Etkms PEP Troubleshooting ToolsResetting the Admin Password Optimizing Time SynchronizationTo view statistics To disable the Sntp client on multiple PEPsStatistics Etep PEP Policy and Key InformationTo export SAD or SPD files from Etep PEPs Troubleshooting PoliciesReplacing Licensed ETEPs Checking Traffic and Encryption StatisticsPlacing PEPs in Bypass Mode Solving Policy ProblemsViewing Policies on a PEP Expired Policies Allowing Local Site Exceptions to Distributed Key PoliciesCannot Add a Network Set to a Policy Solving Network Connectivity ProblemsModifying EncrypTight Timing Parameters Certificate Implementation ErrorsCannot Communicate with PEP Invalid Certificate Error Etkms Boot ErrorInvalid Parameter in Function Call Enter strict-client-authentication disable To disable strict authentication on ETEPsEtpm and Etkms Troubleshooting 252 EncrypTight User Guide Part V Reference 254 EncrypTight User Guide About the Etkms Properties File Modifying the Etkms Properties FileDigital Certificate Configuration Hardware Security Module ConfigurationLogging Setup Peer Etkms and Etpm Communications Timing Base Directory for Storing Operational State DataPEP Communications Timing Policy Refresh TimingPEP Communications Timing Page About Enhanced Security Features Using Enhanced Security FeaturesAbout Strict Authentication Order of Operations Prerequisites for Using Certificates with EncrypTightHow to Reference PrerequisitesCertificate Information Setting DescriptionDistinguished name information Usage, you type this string as follows Using Certificates in an EncrypTight SystemTo change the EncrypTight keystore password Changing the Keystore PasswordChanging the EncrypTight Keystore Password Changing the Etkms Keystore PasswordChanging the Keystore Password on a Etkms Restart the Etkms Service To start the Etkms service Changing the Keystore Password on a Etkms with an HSMChanging the Password Used in the Etkms Properties File To change the password listed in the Etkms properties fileTo configure the certificate policies extension for ETEPs Configuring the Certificate Policies ExtensionClick Enable Policy Extensions Parameter Description To configure certificate policy extensions for ETKMSsClick Enable Certificate Policy Extensions Etkms Certificate Policies EntriesEncrypTight User Guide 271 Generating a Key Pair Working with Certificates for EncrypTight and the ETKMSsTo create the certificate request Keytool genkeypair CommandRequesting a Certificate To generate a key pairKeytool Parameters for Importing a CA Certificate To install a CA certificateImporting a CA Certificate Importing a CA Certificate ReplyWorking with Certificates and an HSM Configuring the HSM for KeytoolExporting a Certificate Generating a Key Pair for use with the HSM Importing CA Certificates into the HSMGenerating a Certificate Signing Request for the HSM Working with Certificates for the ETEPsImporting Signed Certificates into the HSM To start the Certificate Manager do one of the following Understanding the Certificate Manager PerspectiveWorking with External Certificates Certificate Manager WorkflowObtaining External Certificates To install an external certificate Installing an External CertificateTo obtain a CA certificate from a CA Requesting a Certificate Working with Certificate Requests282 EncrypTight User Guide To view a pending certificate signing request Installing a Signed CertificateViewing a Pending Certificate Request Certificate usageTo set certificate request preferences Canceling a Pending Certificate RequestSetting Certificate Request Preferences To cancel a pending certificate requestCertificate request preference fields Managing Installed CertificatesViewing a Certificate To export an installed certificateExporting a Certificate To delete an external certificate Validating Certificates Using CRLsValidating Certificates Deleting a CertificateTo use CRLs with the Etkms Configuring CRL Usage in EncrypTight and the ETKMSsConfiguring CRL Usage on ETEPs To use CRLs with the EncrypTight softwareTo view CRLs Validating Certificates Using OcspTo install a CRL on the Etep Handling Revocation Check FailuresOptions Description To set up Ocsp in EncrypTightClick Enable Online Certificate Status Protocol Ocsp EncrypTight Ocsp OptionsOcsp Settings To set up Ocsp in the EtkmsTo set up Ocsp on the ETEPs Click Enable OcspTo enable strict authentication on PEPs Enabling and Disabling Strict AuthenticationTo enable strict authentication in the EncrypTight software To enable strict authentication on the EtkmsRemoving Certificates To disable strict authenticationClear the Enable Strict Client Authentication box To disable strict authentication from the command lineTo remove certificates Using a Common Access CardSelect Tools Clear Certificates Enabling Common Access Card Authentication Configuring User Accounts for Use With Common Access CardsTo add common names to the Etkms To enable CAC Authentication in EncrypTight To enable CAC Authentication on the EtepClick XML-RPC Certificate Authentication To enable CAC Authentication on the EtkmsHandling Common Name Lookup Failures To specify how to handle common name failuresUsing Enhanced Security Features 298 EncrypTight User Guide Etep Configuration Product Family and Software Version Identifying an ApplianceAppliance Name To configure appliance interfaces Interface ConfigurationThroughput Speed Management Port Addressing ET0100A interfaces configuration Related topicsIPv4 management port addressing IPv4 AddressingIPv6 management port addressing IPv6 AddressingLink speeds on the management port Auto-negotiation All PortsTransparent Mode Remote and Local Port SettingsLink speeds on the local and remote ports Policy Type Mode of operation When to use transparent modeLocal and Remote Port IP Addresses Default Gateway Transmitter EnableIP Address and Subnet Mask Dhcp Relay IP Address Transmitter Enable settings on the EtepIgnore DF Bit Reassembly ModeIgnore DF Bit settings Reassembly mode settingsTrusted host list Trusted HostsOutbound host Appliance Editor Tab Inbound trusted host protocols used by EncrypTightTo add a trusted host ProtocolSystem Information Snmp ConfigurationUnder Community Strings, click Add Community StringsSnmp system information To define a community nameTraps reported on the Etep TrapsTrap Description SNMPv2 Trap Hosts To configure a trap hostSNMPv3 SNMPv3 Configuration Related topics Retrieving and Exporting Engine IDs Generating the Engine IDTo retrieve engine IDs Viewing SNMPv3 Engine IDs Related topics Configuring the SNMPv3 Trap Host UsersSNMPv3 trap host users SNMPv3 Trap Host configuration To configure a trap host userEtep Logging tab Logging ConfigurationLog facilities Log Event SettingsFacility Description Under Syslog Servers, click Add Defining Syslog ServersLog priorities To define a syslog serverInternals logs Log File ManagementLog file sizes Log name File sizeLog files extracted from the Etep Related topics Advanced ConfigurationPacket Payload Size Layer 2 Etep Layer 3 Etep Path Maximum Transmission UnitValid Pmtu ranges on Etep appliances Pmtu and fragmentation behavior on the EtepNon IP Traffic Handling CLI Inactivity TimerPassword Strength Policy Non IP traffic handling configurationXML-RPC Certificate Authentication IKE Vlan Tags SSH Access to the EtepSntp Client Settings To configure the NTP clientIKE Vlan Tags Features ConfigurationOcsp Settings Certificate Policy ExtensionsEncryption algorithms Authentication algorithms Fips ModeEnabling Fips Mode Fips approved encryption and authentication algorithmsOperational Notes Policy Type Action upon entering Fips modeDisabling Fips Verifying Fips Status on the EtepEncrypTight settings EncrypTight SettingsSetting Definition Encryption policy settings Encryption Policy SettingsWorking with Policies Creating Layer 2 Point-to-Point Policies Using EncrypTight Distributed Key PoliciesTo launch Etpm from Etems Etep Policy tab Using Group IDs Using Preshared Keys for IKE AuthenticationSelecting a Role Parameter Value Selecting the Traffic Handling ModeHow the Etep Encrypts and Authenticates Traffic IKE Phase 2 ParametersInterfaces Factory DefaultsInterfaces defaults Interfaces Default SettingSnmp defaults Trusted hosts defaultsTrusted Hosts Policy LoggingAdvanced Features Default Setting FeaturesHard-coded Settings Features defaultsNumerics IndexIndex EncrypTight User Guide 345 Etpm See also HSM Https TLS 348 EncrypTight User Guide EncrypTight User Guide 349 350 EncrypTight User Guide See also TLS trap configuration 352 EncrypTight User Guide Black Box Tech Support FREE! Live /7