Unable to edit the SharePoint documents through browser or word via NetScaler.

Unable to edit the SharePoint documents through browser or word via NetScaler.

book

Article ID: CTX230802

calendar_today

Updated On:

Description

" File Could not be found" error in MAC while trying to edit the document in Word.

" Unable to open the document"  error in Windows machine while trying to edit the document in Word.

Resolution

Thus follow the below steps to mitigate the issue:
=====================================
  • Configure another Non-addressable LBVserver without Authentication and bind the SharePoint Server IPaddress as a LBVservice through which the documents are getting edited.
  • Go to the Content Switching Vserver and create a Content Switching policy as mentioned in the below configuration section:
  • Bind the above created LBVserver to Content Switching Vserver through the Content Switching Policy and place the policy with Top priority.
  • Thus when the user clicks on Any documents and click edit, the OPTION request will be sent from Client machine to NetScaler with the User-Agent as "Microsoft Office Word".
  • As per the Content Switching policy configuration mentioned in the below configuration section, the request will be redirected to the LB Vserver where Authentication is disabled.
  • The LB Vserver forwards the OPTION request to SharePoint server and receives 401 authentication prompt from SharePoint Server.
  • The LB Vserver forwards the 401 authentication prompt to the user. 

NOTE: SSO cannot be performed by NetScaler to this second authentication prompt and User has to enter the credentials for the second time to edit the documents. Even if user edit the documents without NetScaler, they will get the second Authentication Prompt.

Configuration:
===============

LB virtual server and CS virtual server configuration

add lb vserver lb_auth_ON HTTPS 0.0.0.0 0 -AuthenticationHost <Domain name> -Authentication ON -authnVsName av1
add lb vserver lb_auth_OFF HTTPS 0.0.0.0 0
add service sp X.X.X.5 HTTPS 443
bind lb vserver lb_auth_ON sp
bind lb vserver lb_auth_OFF sp

add cs action act_auth_ON -targetLBVserver lb_auth_ON
add cs action act_auth_OFF -targetLBVserver lb_auth_OFF
add cs policy pol_auth_ON -rule "http.req.hostname.contains(\"SharePointServer hostname\")" -action act_auth_ON
add cs policy pol_auth_OFF -rule "HTTP.REQ.HEADER(\"User-Agent\").CONTAINS(\"Microsoft Office Word\")" -action act_auth_OFF
add cs vserver cs1 HTTP X.X.X.165 443 -cltTimeout 180 -Listenpolicy None
bind cs vserver cs1 -policyName pol_auth_OFF -priority 10
bind cs vserver cs1 -policyName pol_auth_ON -priority 20r.

Problem Cause

Issue is with NetScaler Handling the OPTION request