Skip to main content
All CollectionsSoftSIMGetting started with Onomondo SoftSIM
SoftSIM CLI tool for provisioning SoftSIM
SoftSIM CLI tool for provisioning SoftSIM

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

Jakub Kubinski avatar
Written by Jakub Kubinski
Updated over a month ago

Useful links:

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 and download the CLI tool in our public GitHub repository here. You can find more detailed instructions in the "ReadMe" file.

How does it work?

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 Key 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 an API key are encrypted and can only be decrypted using the private key matching the public key used when creating the SoftSIM API key on the Onomondo platform. Changing your keypair 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 RSA key pair.

If you encounter any issues during the process or have any questions around SoftSIM, please contact us at [email protected].

Did this answer your question?