Data encryption parameters

When you enable data encryption for a wrapped app on an iOS device, you can use parameters to exclude specific files from encryption.

encryptFiles parameter

Parameter options Description
Values TRUE, FALSE
Description This is a mandatory parameter to enforce encryption for an enterprise app. Encryption is not enforced on a wrapped app if this flag is set to FALSE, even if other flags are set.
File restrictions The following files are excluded from encryption: nib, dat, version, storyboardc, log, xcdatamodelId, pb, xml, dcry, and decm.

excludedFileNames parameter

Parameter options Description
Values Any legal file name. Supports wildcards (*) and multiple file names that are separated by commas.
Description This parameter excludes (from encryption) files that are created at runtime that match a specified file name or name pattern.
Example If a file name value is sam*.txt, the files sample.txt, sampletest.txt, and samplefile.txt are not encrypted.

excludedFileTypes parameter

Parameter options Description
Values Any file name extension, including multiple file extensions separated by commas.
Description This parameter excludes (from encryption) files that are created at runtime that match a specified file type with a supported file extension.
Supported file types
  • Documents: This parameter supports the following file extensions for documents: txt, doc, docx, xls, xlsx, ppt, pptx, htm, html, zip, and pdf.
  • Video or audio: This parameter supports the following file extensions for video or audio files: m4v, mp4, mov (and any other video or audio files that are directly supported by iOS).
  • Images: This parameter supports the following file extensions for images: bmp, png, jpg, tiff, gif, jpeg (and any other image files that are directly supported by iOS).
Example The file type is set to txt. The wrapped app downloads or creates a TXT file in either the Documents or Downloads directory, and then an XLSX file in the same directory. The TXT file is plain text, and the XLSX file is fully encrypted.

staticResourceExcludedFileNames parameter

Parameter options Description
Values Any legal file name. Supports wildcards (*) and multiple file names that are separated by commas.
Description This parameter excludes (from encryption) matching resource files (such as documents or databases) that are inside the IPA bundle, all of which are normally encrypted at the time of wrapping.
Supported file extensions This parameter supports the following file extensions for documents: txt, doc, docx, xls, xlsx, ppt, pptx, htm, html, and pdf.
Example If a file name value is sam*.txt, the files sample.txt, sampletest.txt, and samplefile.txt are not encrypted inside the IPA resource bundle.

staticResourceExcludedFileTypes parameter

Parameter options Description
Values Any file name extension, including multiple file extensions that are separated by commas.
Description This parameter excludes (from encryption) matching resource file types (such as documents or databases) that are inside the IPA bundle, all of which are normally encrypted at the time of wrapping.
Supported file extensions This parameter supports the following file extensions for documents: txt, doc, docx, xls, xlsx, ppt, pptx, htm, html, and pdf.
Example The file type is set to txt. The wrapped app bundle contains a TXT file and an HTM file in the resources directory. The TXT file is plain text, and the HTM file is fully encrypted.

staticResourceIncludedImageNames parameter

Parameter options Description
Values Any legal file name. Supports wildcards (*) and multiple file names that are separated by commas.
Description This parameter includes (encrypts) the matching image resource files that are inside the IPA bundle, all of which normally remain decrypted at the time of wrapping.
Supported file extensions This parameter supports the following file extensions for images: bmp, png, jpg, tiff, gif, jpeg (and any other image files that are directly supported by iOS).
Example If an image file name value is sam*.jpg, the files sample.jpg, sampletest.jpg, and samplefile.jpg are encrypted inside the IPA resource bundle.