Pre-Configuring Mac For ClaroRead Use In A Site Environment

Published by Claro Software on

If you are an Admin you can create a Configuration Profile containing entries for ClaroRead and other Claro apps Accessibility and Automation and push out to target Macs using the MDM.

Apple’s documentation on configuration profiles is available here: https://developer.apple.com/enterprise/documentation/Configuration-Profile-Reference.pdf

Page 65 of this document has information that is relevant to ClaroRead in regards to Accessibility and AppleEvents.

To create a configuration profile to work with ClaroRead, this will require a mobileconfig file that is controlled via a MDM server.

For ClaroRead, the mobile config file will require 2 keys in the Services dictionary (example below):

  • Accessibility
  • AppleEvents
    • This requires 7 dictionaries one for each of the following:
      • System Events
      • System Preferences
      • Microsoft Word
      • Dictionary
      • Pages
      • Safari
      • TextEdit

The generated mobileconfig file will need deployed to the target machines via an MDM.

Please see below an example of the ClaroRead config file:

<key>Services</key>
<dict>
	<key>Accessibility</key>
	<array>
		<dict>
			<key>Allowed</key>
			<true/>
			<key>CodeRequirement</key>
			<string>****Obtained via the command "codesign –display -r -" for the ClaroRead.app installed****</string>
			<key>Comment</key>
			<string>Allow ClaroRead access to the accessibility APIs</string>
			<key>Identifier</key>
			<string>com.clarosoftware.ClaroRead</string>
			<key>IdentifierType</key>
			<string>bundleID</string>
		</dict>
	</array>
	<key>AppleEvents</key>
	<array>
		<dict>
			<key>AEReceiverCodeRequirement</key>
			<string>identifier "com.apple.systemevents" and anchor apple</string>
			<key>AEReceiverIdentifier</key>
			<string>com.apple.systemevents</string>
			<key>AEReceiverIdentifierType</key>
			<string>bundleID</string>
			<key>Allowed</key>
			<true/>
			<key>CodeRequirement</key>
			<string>****Obtained via the command "codesign –display -r -" for the ClaroRead.app installed****</string>
			<key>Comment</key>
			<string>Allow ClaroRead to send AppleEvents control to System Events</string>
			<key>Identifier</key>
			<string>com.clarosoftware.ClaroRead</string>
			<key>IdentifierType</key>
			<string>bundleID</string>
		</dict>
		<dict>
			<key>AEReceiverCodeRequirement</key>
			<string>identifier "com.apple.systempreferences" and anchor apple</string>
			<key>AEReceiverIdentifier</key>
			<string>com.apple.systempreferences</string>
			<key>AEReceiverIdentifierType</key>
			<string>bundleID</string>
			<key>Allowed</key>
			<true/>
			<key>CodeRequirement</key>
			<string>****Obtained via the command "codesign –display -r -" for the ClaroRead.app installed****</string>
			<key>Comment</key>
			<string>Allow ClaroRead to send AppleEvents control to System Preferences</string>
			<key>Identifier</key>
			<string>com.clarosoftware.ClaroRead</string>
			<key>IdentifierType</key>
			<string>bundleID</string>
		</dict>
		<dict>
			<key>AEReceiverCodeRequirement</key>
			<string>****Obtained via the command "codesign –display -r -" for the Microsoft Word.app installed****</string>
			<key>AEReceiverIdentifier</key>
			<string>com.microsoft.Word</string>
			<key>AEReceiverIdentifierType</key>
			<string>bundleID</string>
			<key>Allowed</key>
			<true/>
			<key>CodeRequirement</key>
			<string>****Obtained via the command "codesign –display -r -" for the ClaroRead.app installed****</string>
			<key>Comment</key>
			<string>Allow ClaroRead to send AppleEvents control Microsoft Word</string>
			<key>Identifier</key>
			<string>com.clarosoftware.ClaroRead</string>
			<key>IdentifierType</key>
			<string>bundleID</string>
		</dict>
		<dict>
			<key>AEReceiverCodeRequirement</key>
			<string>identifier "com.apple.Dictionary" and anchor apple</string>
			<key>AEReceiverIdentifier</key>
			<string>com.apple.Dictionary</string>
			<key>AEReceiverIdentifierType</key>
			<string>bundleID</string>
			<key>Allowed</key>
			<true/>
			<key>CodeRequirement</key>
			<string>****Obtained via the command "codesign –display -r -" for the ClaroRead.app installed****</string>
			<key>Comment</key>
			<string>Allow ClaroRead to send AppleEvents control Dictionary</string>
			<key>Identifier</key>
			<string>com.clarosoftware.ClaroRead</string>
			<key>IdentifierType</key>
			<string>bundleID</string>
		</dict>
		<dict>
			<key>AEReceiverCodeRequirement</key>
			<string>****Obtained via the command "codesign –display -r -" for the Pages.app installed****</string>
			<key>AEReceiverIdentifier</key>
			<string>com.apple.iWork.Pages</string>
			<key>AEReceiverIdentifierType</key>
			<string>bundleID</string>
			<key>Allowed</key>
			<true/>
			<key>CodeRequirement</key>
			<string>****Obtained via the command "codesign –display -r -" for the ClaroRead.app installed****</string>
			<key>Comment</key>
			<string>Allow ClaroRead to send AppleEvents control Pages</string>
			<key>Identifier</key>
			<string>com.clarosoftware.ClaroRead</string>
			<key>IdentifierType</key>
			<string>bundleID</string>
		</dict>
			<dict>
			<key>AEReceiverCodeRequirement</key>
			<string>identifier "com.apple.Safari" and anchor apple</string>
			<key>AEReceiverIdentifier</key>
			<string>com.apple.Safari</string>
			<key>AEReceiverIdentifierType</key>
			<string>bundleID</string>
			<key>Allowed</key>
			<true/>
			<key>CodeRequirement</key>
			<string>****Obtained via the command "codesign –display -r -" for the ClaroRead.app installed****</string>
			<key>Comment</key>
			<string>Allow ClaroRead to send AppleEvents control Safari</string>
			<key>Identifier</key>
			<string>com.clarosoftware.ClaroRead</string>
			<key>IdentifierType</key>
			<string>bundleID</string>
		</dict>
		<dict>
			<key>AEReceiverCodeRequirement</key>
			<string>identifier "com.apple.TextEdit" and anchor apple</string>
			<key>AEReceiverIdentifier</key>
			<string>com.apple.TextEdit</string>
			<key>AEReceiverIdentifierType</key>
			<string>bundleID</string>
			<key>Allowed</key>
			<true/>
			<key>CodeRequirement</key>
			<string>****Obtained via the command "codesign –display -r -" for the ClaroRead.app installed****</string>
			<key>Comment</key>
			<string>Allow ClaroRead to send AppleEvents control TextEdit</string>
			<key>Identifier</key>
			<string>com.clarosoftware.ClaroRead</string>
			<key>IdentifierType</key>
			<string>bundleID</string>
		</dict>
	</array>
</dict>

Other Claro Apps

ClaroCapture

For ClaroCapture (com.clarosoftware.ClaroCapture), the mobile config file will require 2 keys in the Services dictionary:

  • Accessibility
  • AppleEvents
    • This requires 7 dictionaries one for each of the following:
      • Microsoft Word com.microsoft.Word
      • Pages com.apple.iWork.Pages
      • TextEdit com.apple.TextEdit
      • Preview com.apple.Preview
      • Chrome com.google.Chrome
      • Microsoft Powerpoint com.microsoft.Powerpoint
      • Safari com.apple.Safari

Writing Helper

For Writing Helper (com.clarosoftware.WritingHelper), the mobile config file will require 1 key in the Services dictionary:

  • AppleEvents
    • This requires 1 dictionary for the following:
      • Microsoft Word com.microsoft.Word

ClaroView, ScreenRuler, Auto Converter

No config is required.

Thanks

Thanks to Amos Deane from arts.ac.uk for sending an example profile for us to work with, and to our parent company, Texthelp, for this original article.