Configuring the Agentry Server Public/Private Key Length

Configure the Agentry Server public/private key length.

This procedure defines the process for setting the Agentry Server public/private key length. The default key length is 512. In many environments this must be increased to meet security requirements. This procedure describes the process for changing this behavior.

  1. If the SAP Mobile Server is currently running, shut it down.
  2. Navigate to the installation directory of the Agentry Server and open the Agentry.ini file in a standard text editor.
  3. Locate the section within the file named [Server]. Here, either modify the setting publicKeyLength by setting the value to the desired key length; or if the setting is not present add it to the this section with the value of the desired key length.
    The following is an example of how this setting might appear:
    [Server]
    publicKeyLength=2048
  4. Save and close the Agentry.ini file. At this point, if the Agentry Server has never before been started, there are not further actions necessary. If the Agentry Server has been started previously, or if you are unsure as to whether or not it has been started previously, continue with this procedure.
  5. Open a Windows command prompt as an administrator and navigate to the installation directory of the SAP Mobile Server.
  6. Run the following command:

    SMP_HOME\Servers\AgentryKeyUtility -deleteKey

    This command deletes any public/private key pair created by the Agentry Server. The next time the Agentry Server is started the Agentry Server creates a new public/private key with a key length matching the one set earlier in this procedure.

The Agentry Server has been configured to generate its public/private key pair using the new key length.
Next
If this change has been made to a live production environment, mobile users must reset the Agentry Clients, including the removal of all data stored locally on the client device, and perform a full transmit with the Agentry Server.