SoftSIM
      Back to home
      1. Help Center
      2. Setting up
      3. SoftSIM

      SoftSIM CLI tool for provisioning SoftSIM

      The SoftSIM CLI tool helps with provisioning your SoftSIM-enabled device before and during production.

      What is a CLI tool?

      A command-line interface (CLI) is a text-based user interface (UI) used to run programs, manage files, and interact with operating systems.

      In this case, the CLI tool will help you with provisioning your SoftSIM-enabled device before and during production.

      How to get access to our CLI tool?

      You can access the CLI tool in our public GitHub repository here, where you can download the CLI tool. You can find more details in the "ReadMe" file.

      How does it work?

      For detailed information, we advise you to explore our GitHub repository here.

      With the CLI tool, provisioning is split in two distinct steps before and during production:

      1. Pre-production: Fetch n profiles from the Onomondo API to avoid excessive load on API and to remove any dependencies on stable internet. The profiles are encrypted using your public key.
      2. During production: Continuously get a new unique profile correctly formatted to specifications.

      These steps correspond one-to-one with the available commands in the CLI tool:

      • Command: Fetch

        • This command fetches the specified number of profiles from the Onomondo API. To get access, you can use the SoftSIM API generated in our platform.

      • Command: Next

        • This command finds the next unused profile on your local system. The profile is decrypted using the private key pointed to by the - -key argument. After decryption and encoding, the file is prepended with __ to invalidate the profile.

      FAQs

      Issues decrypting the SoftSIM profiles fetched using the Onomondo SoftSIM CLI tool:

      The profiles fetched using a API key are encrypted and can only be decrypted using the private key matching the public key used when creating the SoftSIM API key. Changing keys will require you to create a new SoftSIM API key.

      The Onomondo SoftSIM CLI tool does not support keys, that are password protected. Therefore, you should enter an empty password when generating your key pair.