OS X Server: Allowing custom URL protocols in links via wiki service

Summary

Learn how to enable custom URL protocols for the Lion Server Wiki service (so they become clickable links on a wiki page).

Products Affected

Lion Server, OS X Server (Mountain Lion)

By default, links in a wiki page that use common URL protocols such as http, ftp, and so forth are already clickable.

If you wish to create links containing a custom protocol, such as irc or scp, follow the directions below.

  1. Create whitelist_file per the version of OS X Server you're using.
    On Lion Server, whitelist_file refers to /etc/collabd/filter_whitelist.plist.
    On OS X Server (Mountain Lion), whitelist_file refers to /Library/Server/Wiki/Config/whitelist.plist.
     
  2. Use the guidelines in How to edit configuration files to add this content to the file:
  3. <?xml version="1.0" encoding="UTF-8"?>
    <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
    <plist version="1.0">
    <dict>
    	<key>protocols</key>
    	<array>
    		<string>irc</string>
    		<string>scp</string>
    	</array>
    </dict>
    </plist>
  4. Verify that the file's syntax is correct. An easy way to do so is by using the plutil(1) command:
  5. plutil whitelist_file
  6. Ensure that the permissions on the file are such that it will be accessible to the wiki service:
  7. sudo chown _teamsserver:_teamsserver whitelist_file
    sudo chmod 644 whitelist_file

 

Important: Information about products not manufactured by Apple is provided for information purposes only and does not constitute Apple’s recommendation or endorsement. Please contact the vendor for additional information.
Not helpful Somewhat helpful Helpful Very helpful Solved my problem
Ask other users about this article
in Apple Support Communities
See all questions on this article See all questions I have asked