The REST API is a new method to administer the SafeNet Network HSM appliance. For years, the only way to administer SafeNet Network HSM was through a shell interface (SSH). The shell is Luna Shell – LunaSH for short. SafeNet Network HSM continues to support LunaSH along with the REST API. Long-standing customers familiar with LunaSH may want to migrate to the REST API. A set of cross reference tables summarize the mapping between LunaSH commands and REST API resources.

NOTE: What LunaSH presents in "show" and other status commands may not match the information obtained via the REST API. The principal reason for the variance is the use of different utilities on the appliance. Therefore, as a general rule, rely on one of either LunaSH or the REST API to administer the appliance. If you use both, the information reported may not be consistent between the two facilities. For example, you will see the following flags show up in LunaSH output after initializing a PSO partition via the REST API.

  Partition SO PIN to be Changed
  Partition SO Challenged to be Changed
  
Before partition initialization:
[myLuna] lunash:>partition show
Partition Name: John2
Partition SN: 894069516
Partition Label:
Partition SO is not initialized.
Crypto Officer is not initialized.
Crypto User is not initialized.
Legacy Domain Has Been Set: no
Partition Storage Information (Bytes): Total=20480, Used=0, Free=20480
Partition Object Count: 0

After partition initialization via the REST API:
[myLuna] lunash:>partition show
Partition Name: John2
Partition SN: 894069516
Partition Label: Johnny2
Partition SO PIN To Be Changed: no
Partition SO Challenge To Be Changed: no
Partition SO Zeroized: no
Partition SO Login Attempts Left: 10
Crypto Officer is not initialized.
Crypto User is not initialized.
Legacy Domain Has Been Set: no
Partition Storage Information (Bytes): Total=20480, Used=0, Free=20480
Partition Object Count: 0

They have no meaning for the PSO role. Because the utility that manages roles for the REST API changes flags that LunaSH does not manage, these new flags appear in the LunaSH output.

Refer to the following cross reference tables for the mapping between LunaSH and REST API resources.