Intel Security

Improve this doc

The App Security API enables the use of security properties and capabilities on the platform, using a new set of API defined for application developers. You are not required to be a security expert to make good use of the API. Key elements, such as encryption of data and establishments of capabilities, is abstracted and done by the API implementation, for you.

For example:

• Use the API to store (E.g. cache) data locally, using the device non-volatile storage. Data protection/encryption will be done for you by the API implementation
• Establish a connection with remote server (E.g. XHR) using a protected channel. SSL/TLS establishment and usage will be done for you by the API implementation

For more information please visit the API documentation.

Repo: https://github.com/AppSecurityApi/com-intel-security-cordova-plugin

Installation

1. Install the Cordova and Ionic Native plugins:
   

   $ ionic cordova plugin add com-intel-security-cordova-plugin
   $ npm install --save @ionic-native/intel-security@4
   

2. Add this plugin to your app's module

Supported platforms

• Android
• iOS
• Windows
• Windows Phone 8

Usage

import { IntelSecurity } from '@ionic-native/intel-security';
...
constructor(private intelSecurity: IntelSecurity) { }
...

let storageID = 'id';

this.intelSecurity.data.createFromData({ data: 'Sample Data' })
  .then((instanceID: Number) => this.intelSecurity.storage.write({ id: storageId, instanceID: instanceID }))
  .catch((error: any) => console.log(error));

this.intelSecurity.storage.read({id: storageID })
  .then((instanceID: number) => this.intelSecurity.data.getData(instanceID))
  .then((data: string) => console.log(data)) // Resolves to 'Sample Data'
  .catch((error: any) => console.log(error));

this.intelSecurity.storage.delete({ id: storageID })
  .then(() => console.log('Deleted Successfully'))
  .catch((error: any) => console.log(error));

Instance Members

storage

returns an IntelSecurityStorage object

data

Returns an IntelSecurityData object

IntelSecurityData

Instance Members

createFromData(options)

This creates a new instance of secure data using plain-text data.

createFromSealedData(options, options.sealedData)

This creates a new instance of secure data (using sealed data)

getData(instanceID)

This returns the plain-text data of the secure data instance.

getSealedData(instanceID)

This returns the sealed chunk of a secure data instance.

getTag(instanceID)

This returns the tag of the secure data instance.

getPolicy(instanceID)

This returns the data policy of the secure data instance.

getOwners(instanceID)

This returns an array of the data owners unique IDs.

getCreator(instanceID)

This returns the data creator unique ID.

getWebOwners(instanceID)

This returns an array of the trusted web domains of the secure data instance.

changeExtraKey(options, options.instanceID, options.extraKey)

This changes the extra key of a secure data instance. To successfully replace the extra key, the calling application must have sufficient access to the plain-text data.

destroy(instanceID)

This releases a secure data instance.

IntelSecurityStorage

Instance Members

delete(options, options.id, options.storageType)

This deletes a secure storage resource (indicated by id).

read(options, options.id, options.storageType, options.extraKey)

This reads the data from secure storage (indicated by id) and creates a new secure data instance.

write(options, options.id, options.instanceID, options.storageType)

This writes the data contained in a secure data instance into secure storage.

IntelSecurityDataOptions