As of the 5.2 release of the Machina Console, users will be able to generate and download a Secure Enrollment Profile (SEP). A downloadable SEP allows users to bypass the historic enrollment process which results in a SEP and get started quickly with Machina. In this iteration of the feature, the downloadable SEP is only available as a plaintext file. Here the SEP is stored as a JSON file on disk. For more details, please refer to the Ionic Developer environment articles below:
- https://dev.ionic.com/sdk_docs/ionic_platform_sdk/python/version_1.8.0/classionicsdk_1_1common_1_1_device_profile_persistor_plaintext_file.html
- https://dev.ionic.com/sdk_docs/ionic_platform_sdk/java/version_2.6.0/index.html
- https://dev.ionic.com/sdk/tasks/initialize-agent-with-plaintext-persistor?language=python
There must be as least one keyspace associated with the current Machina Instance in order to take advantage of the downloadable SEP feature. A SEP can be downloaded by navigating to either the Profiles or Devices tab on the Machina Console.
Accessing Downloadable SEP via Profiles
To access Downloadable SEPs via the Profiles tab:
- Navigate to the Users tab on the Machina Console and select a User Account.
- On the User Account Page, click Download SEP to begin to the download process.
- Once the download process has completed the .pt file can be used in conjunction with the Machina CLI or other SDKs.
*Note: The name of the .pt file will be <CurrentKeyspaceName>.pt
Accessing Downlodable SEP via Devices
To access Downlodable SEPs via the Devices tab:
- Navigate to the Devices tab on the Machina Console and select the Manage tab.
- On the Manage tab, click Download SEP to begin the download process.
- Once the download process has completed the .pt file can be used in conjunction with the Machina CLI or other SDKs.
Using a Downloaded SEP
After a SEP has been downloaded, it will be named in the format "<keyspaceName>.pt" for example: "E16E.pt". Using the Machina CLI you can reference this downloaded profile to create keys with the following command:
machina -f /path/to/E16E .pt -t plaintext key create |
No additional setup is needed.
Best Practices
While no additional actions are required to get going with the downloadable SEP, we do have some best practices that will enhance your workflow and improve your experience.
- We recommend that you rename each downloaded SEP to reflect the purpose, device, application etc that the SEP will be utilized for to avoid potential confusion in the future as you download additional SEPs.
- We recommend that you import your downloaded plaintext SEP into your default persistor. Below are instructions on how to do this with the Machina CLI tool:
Note: This requires Machina CLI 2.0
$ machina -f ~
/Downloads/E1IV
.pt -t plaintext profile move -d $deviceid
# Example
$ machina -f ~
/Downloads/E1IV
.pt -t plaintext profile move -d E1IV.H.1bb7ac93-f98d-4514-519f-bef63300fc49
For more information regarding the Machina Tools, like our CLI Tool, please see https://dev.ionic.com/tools
Comments
0 comments
Article is closed for comments.