WebDav module

iKnowBase comes with a WebDav server serving iKnowBase documents to WebDav Clients. The WebDav server is implemented as a java module in the iknowbase-webapp application.

Due to client requirements, the WebDav Server must be available at context root / (the root), and it must therefore also be deployed using a separate hostname (e.g. using webdav.example.com, while other applications are deployed on intranet.example.com) to avoid conflict with the other modules also deployed at root.

The Webdav module does not support clustering.

Installation

The WebDav Server is required to be available at context root / and will typically require a separate WebDav specific hostname.

Authentication to a WebDav resource is done using BASIC authentication (SSL is strongly recommended) or SPNEGO authentication if you have Windows Single Sign on with Kerberos. See the troubleshooting section for accessing WebDav resources without SSL support.

The WebdavConfiguration accepts these configuration properties:

Configuring the FTP Service

The WebDAV-module also supports FTP-access to development studio templates, which may be useful during periods of heavy development.

The FtpServiceConfiguration accepts these configuration properties:

Client configuration

To set up direct editing of Microsoft Office documents, do the following:

• Using Administration Console, configure the “WebDAV Path” in the relevant Domain configuration with the proper value, e.g. “https://webdav.example.com/”.
• In relevant content viewers, configure an “Edit using WebDAV” action.
• From a supported web browser, click the “Edit using WebDAV” icon.

Troubleshooting

For troubleshooting, do this:

• Find a suitable document in your iKnowBase installation, making note of the document ID. For this example, we assume a document ID of “2804”.
• Using a web browser, go to the url “https://webdav.example.com/ikb$content/2804/document.docx” (using the proper hostname and a suitable extension). Open (or save + open) this document, and verify that it opens properly in e.g. Microsoft Word.
• Using Microsoft Word directly, go to the “Open Document” dialog (Ctrl+F12 will often do the trick). Here, enter the same full URL, including the https-prototcol and all (“https://webdav.example.com/ikb$content/2804/document.docx”) and click “Open”. Verify that it opens properly.
• Make sure that the plugin is not blocked by the browser (in such case you will be prompted)

Microsoft Office on Mac requires SSLv3 protocol support

Microsoft Office 2011 for Mac requires that the old SSLv3 protocol is enabled. Web sites will typically want to remove support for SSLv3 due to the SSLv3 vulnerability “POODLE”, but this will result in the message “No connectivity with the server” when opening a document using WebDAV.

The WebDAV web site must support SSLv3 until this issue is resolved.

iKnowBase reference: IKB-2867
h1. WebServices module

iKnowBase comes with a WebServices server that provides SOAP-access to the Service API. This is disabled by default, but can be enabled when needed.

The WebServicesConfiguration accepts these configuration properties: