Skip to main content

Ionic Reference Guide

Create a profile

To enable the Privacy Platform to access the Ionic system, a profile (or device credentials) needs to be created for the platform in Ionic. A profile acts in a similar way to a user account and once set up it enables the platform to access the Ionic system.

Profiles are stored in encrypted files called persistors (or profile persistors). They store the device credentials required to connect a new device (such as the Privacy Platform) to the Ionic system. There are different types of persistors that can be created in Ionic. The Privacy Platform supports password persistors. This is a password protected file that can store a profile or a group of profiles - in effect one or more sets of device credentials.

The process of creating a profile in Ionic for a new device is called enrollment. For more information about enrolling a new device in Ionic, refer to https://dev.ionic.com/getting-started/create-ionic-profile.

Example 1. Example of profile creation with Ionic Machina

The following command will create a new password persistor, called "profiles.pw". This file will be password protected with the value "myPassword". This profile is created for email "my_email@domain.com", and uses keyspace identified "Keyspace_Id".

You can find more details about this command here: https://dev.ionic.com/tools/machina/profile_enroll

machina \
    --devicetype password \
    --devicepw myPassword \
    --devicefile $HOME/.ionicsecurity/profiles.pw \
    profile enroll \
    —keyspace Keyspace_Id \
    --email my_email@domain.com \
    --type idc


Following the creation of the profile, you should have two items:

  • A password persistor file containing the profile for the Privacy Platform. The default location is $HOME/.ionicsecurity/profiles.pw.

  • A password for the persistor.

In this section: