This article has been archived and is no longer updated by Apple.

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

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

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:

    <?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>

  3. Verify that the file's syntax is correct. An easy way to do so is by using the plutil(1) command:

    plutil whitelist_file

  4. Ensure that the permissions on the file are such that it will be accessible to the wiki service:

    sudo chown _teamsserver:_teamsserver whitelist_filesudo chmod 644 whitelist_file

Information about products not manufactured by Apple, or independent websites not controlled or tested by Apple, is provided without recommendation or endorsement. Apple assumes no responsibility with regard to the selection, performance, or use of third-party websites or products. Apple makes no representations regarding third-party website accuracy or reliability. Contact the vendor for additional information.
Published Date: