Support site for Simplebim users
Simplebim archive

Simplebim archive (.sba) is a ZIP container that can be used for packaging together, signing and encrypting different files used by Simplebim.

Signing and encrypting Simplebim templates

Signing and encrypting a template creates a Simplebim archive with a signature file and the template file.

The purpose of signing is to capture who has created the template and to make sure the template is not modified by the user.

The template file is encrypted with either a system password or a user defined password

How to install a signature

Installing a signature is done via a settings file that is copied into the installation folder of Simplebim. This allows the signature to be installed as a post-process to installing Simplebim either by simply copying the file or via a dedicated installer.

The signature file must be copied into a sub-folder of the Configuration sub-folder of the Simplebim installation folder. Please create the Configuration sub-folder if needed. The name of the sub-folder can for example be the name of your company. The name of the configuration file must have the .config extension, but otherwise the name can be anything. The example below is for a company called Acme and the default Simplebim 7 installation folder.

C:\Program Files\Datacubist\simplebim 7\Configuration\Acme\TemplateSignature.config

The signature files are different for the user signing the template and the user using the signed template.

The following is an example of a signature file used for signing templates. Please note that the password is optional.

<?xml version="1.0" encoding="utf-8"?>
<Settings xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://www.datacubist.com/simplebim.developer/settings/1.0">
  <Values>
    <StringValue Name="MergeType" Value="Installed" />
    <StringValue Name="MergePath" Value="" />
    <StringValue Name="MergeLink" Value="Installed.ArchiveSignature" />
  </Values>
  <Nodes>
   <Node Key="ArchiveSignature">
    <Values>
      <StringValue Name="Signer" Value="Acme Inc." />
      <StringValue Name="Signature" Value="XXX" />
      <StringValue Name="Password" Value="YYY" />
    </Values>
   </Node>
  </Nodes>
</Settings>

 

The following is an example of a signature file used by the user of signed templates. Please note that Required Signature and Password are both optional. This means that if you do not want to limit the use of templates to templates signed by your organization and if you do not wish to use a user defined password, then there is no need to install a signature file of the user's computer.

<?xml version="1.0" encoding="utf-8"?>
<Settings xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://www.datacubist.com/simplebim.developer/settings/1.0">
  <Values>
    <StringValue Name="MergeType" Value="Installed" />
    <StringValue Name="MergePath" Value="" />
    <StringValue Name="MergeLink" Value="Installed.ArchiveSignature" />
  </Values>
  <Nodes>
   <Node Key="ArchiveSignature">
    <Values>
      <StringValue Name="RequiredSignature" Value="XXX" />
      <StringValue Name="Password" Value="YYY" />
    </Values>
   </Node>
  </Nodes>
</Settings>

How to sign templates

  1. Start Simplebim 7.0 SR3 or later
  2. In the Simplebim startup screen, click on the gear icon in the lower left hand corner. If you have a signature file installed you can sign templates in the dialog that opens
  3. Select the template to sign
  4. Optionally check the checkbox for encrypting with a cuer password. NOTE: this option is not visible if your signature file does not define a password
  5. Click on Sign and select a folder into which to save the signed template

How to use a signed template

Signed templates can be used just like any other templates. If you copy a signed template (.sba) into the user template folder it will be loaded by Simplebim and shown in the menus. You can also apply a signed template by browsing it from the file system.

If you browse for a template you must type in *.* in the file name field in order to choose the signed template (.sba)

If you use signed templates that are encrypted with a user defined password, a signature file with the password must be installed on the computer.

Using a signed template does not succeed if