LinkOne Webview Setup Guide

Size: px

Start display at page:

Download "LinkOne Webview Setup Guide"

Eleanore Tyler
5 years ago
Views:

1 LinkOne Webview Setup Guide

2 LinkOne Webview - Integration with Ellipse 8 Contents LinkOne Webview - Integration with Ellipse 8 2 Commercial In Confidence 3 Preface 4 Summary information 4 Confidentiality 4 Document Control 4 Who should use this guide? 4 How use this guide 4 Purpose 4 Scope 4 Setup Procedure 5 Web View Installation 5 Web View Configuration 5 IIS Setup for Https Connections 7 User Setup 7 Advanced 9

3 Commercial In Confidence Copyright 2018 ABB All Rights Reserved Confidential and Proprietary Legal Disclaimer The product described in this documentation may be connected, and/or communicate information and data via, a network interface, which should be connected a secure network. It is your sole responsibility ensure a secure connection the network and establish and maintain appropriate measures (such as but not limited the installation of firewalls, application of authentication measures, encryption of data, installation of antivirus programs, etc.) protect the product, the network, your systems, and the interface against any kind of security breach, unauthorised access, interference, intrusion, leakage, damage, or corruption or theft of data. We are not liable for damages or losses related any such security breach, unauthorised access, interference, intrusion, leakage, damage, or corruption or theft of data.

4 Preface This Guide is part of the Ellipse Technical Documentation Library. This documentation library comprises a number of guides that provide information for the implementation, administration, and operation of the Ellipse application in a networked environment. Summary information Confidentiality The contents of this document are confidential between ABB and its cusmers. The parties must keep the information herein confidential at all times and not disclose it, or permit it be disclosed, any third party, apart from any of their officers, employees, agents or advisers who have a specific need access the information herein and have agreed be bound by the terms of confidentiality. Document Control Once the project is completed or terminated, this document will revert an uncontrolled document status. No further advice will be provided, and each recipient may either destroy the document or mark it as obsolete and retain it for future personal reference. All copies of this document will be issued electronically. Who should use this guide? This guide provides information for System Administrars installing LinkOne Webview. How use this guide This guide describes the Web View installation, configuration and IIS setup. Purpose This document is a guide Technical Consultants involved with installing LinkOne Webview. Scope The following is in scope and covered in a section of this document. Webview installation Webview configuration IIS Setup for Https Connections User Setup

5 Setup Procedure This section documents the steps required install Web View with support for Ellipse integration. Web View Installation Install WebView and license LinkOne WebView according the LinkOne WebView Getting Started Guide. First install the current version of Web View. Versions 3.4 and above support Ellipse integration. 1. Run the Web View installer. 2. Follow the steps in the Setup Wizard. 3. Once Web View is installed, use a web browser access the Web View URL. 4. Log in as an administrar (default is admin with matching password). 5. From the Web View menu, select Configuration->Site Licenses 6. Copy and paste your license details in the license box provided and press the butn. Web View Configuration Next setup the Web View web.config file support Ellipse integration. The ellipse server connects the WebView installation over the HTTPS procol using a transport mechanism called JSON, the web.config file needs be modified add this facility. The relevant sections within the web.config file are prefixed with the comment <! Ellipse 8 HTTPS MSELNK support > The instructions are applicable IIS 7 only. Note The IIS web server will need be configured for HTTPS/SSL before completing this step. 1. Make a backup of the default web.config in case anything goes wrong it is located under the installed direcry for webview (Usually c:inetpubwwwrootlinkone by default) 2. Open the web.config file located under the installed direcry for webview (Usually c:inetpubwwwrootlinkone by default) in a text edir. 3. Locate the <appsettings> tag and modify the line that starts with  read: <add key="basicauthenticationpages" value="~/viewer/picture.aspx,~/print.ashx,~/viewer/resource.aspx,~/viewer/graphic.aspx,~/services/bookservice.svc,~/services/searchservice.svc,~/services/printservice.svc,~/services/picturecontrolservice.svc" /> That is remove the <! from before the TAG and > from after 4. Locate the <httpmodules> tag and modify the following lines:

6 That is: <remove name="formsauthentication" /> <add name="basicauthenticationmodule" type="mincom.linkone.webview.webserver.modules.basicauthenticationmodule" /> <add name="formsauthentication" type="system.web.security.formsauthenticationmodule" /> Leave the line <! Ellipse 8 HTTPS MSELNK support > Remove the <! from before the TAG and > from after 5. Locate the <httphandlers> tag and modify the lines:  <add name="ellipseprinthandler" verb="*" path="print.ashx" type="mincom.linkone.webview.webserver.handlers.printhandler" /> 6. Find the <modules tag and modify the following lines:  <remove name="formsauthentication" /> <add name="basicauthenticationmodule" type="mincom.linkone.webview.webserver.modules.basicauthenticationmodule" /> <add name="formsauthentication" type="system.web.security.formsauthenticationmodule" /> 7. Locate the <handlers> tag and modify :  <add name="ellipseprinthandler" verb="*" path="print.ashx" type="mincom.linkone.webview.webserver.handlers.printhandler" /> 8. Now we need add the secure JSON endpoint each of the services Ellipse will use. Locate the <services> tag and modify the following lines  <endpoint contract="mincom.linkone.webview.webserver.webservices.ipicturecontrolservice" address="jsons" binding="webhttpbinding" bindingconfiguration="webbindings" behaviorconfiguration="jsonbehavior" bindingnamespace="urn:mincom.linkone.webview.webserver.webservices" /> Configuration="webBindings" behaviorconfiguration="json Behavior" bindingnamespace="urn:mincom.linkone.webview. WebServer.WebServices"/> 9. Now Locate the line  <endpoint contract="mincom.linkone.webview.webserver.webservices.ibookservice" address="jsons" binding="webhttpbinding" bindingconfiguration="webbindings" behaviorconfiguration="jsonbehavior" bindingnamespace="urn:mincom.linkone.webview.webserver.webservices" /> 10. Now Locate the line  <endpoint contract="mincom.linkone.webview.webserver.webservices.iselectionlistservice" address="jsons" binding="webhttpbinding" bindingconfiguration="webbindings" behaviorconfiguration="jsonbehavior" bindingnamespace="urn:mincom.linkone.webview.webserver.webservices" /> 11. Now Locate the line  <endpoint contract="mincom.linkone.webview.webserver.webservices.isecurityservice" address="jsons" binding="webhttpbinding" bindingconfiguration="webbindings" behaviorconfiguration="jsonbehavior" bindingnamespace="urn:mincom.linkone.webview.webserver.webservices" /> 12. Now Locate the line

7  <service name="mincom.linkone.webview.webserver.webservices.searchservice" behaviorconfiguration="servicebehavior"> <endpoint contract="mincom.linkone.webview.webserver.webservices.isearchservice" address="jsons" binding="webhttpbinding" bindingconfiguration="webbindings" behaviorconfiguration="jsonbehavior" bindingnamespace="urn:mincom.linkone.webview.webserver.webservices"/> </service> <service name="mincom.linkone.webview.webserver.webservices.printservice" behaviorconfiguration="servicebehavior"> <endpoint contract="mincom.linkone.webview.webserver.webservices.iprintservice" address="jsons" binding="webhttpbinding" bindingconfiguration="webbindings" behaviorconfiguration="jsonbehavior" bindingnamespace="urn:mincom.linkone.webview.webserver.webservices"/> </service> 13. WebView should now be configured, if you encounter problems when logging in or viewing, check the web.config for errors and ensure all XML tags are closed off correctly. Note It may be necessary edit the web.config as an administrar in order be able write the file. IIS Setup for Https Connections Web View uses https support Ellipse data requests. This requires that the Web View server machine must have a valid server certificate. This may be a self-signed certificate. The specific setup steps may vary depending on the installed version of Windows. The following steps most closely match setup under Windows Open the start menu or an explorer shell. 2. Right click on Computer or My Computer. 3. Select Manage. 4. Find and select Internet Information Services (IIS) Manager. 5. From the root of IIS manager, find the Server Certificates feature and open it. 6. Select Create Self-Signed Certificate. 7. Name the certificate and click Ok. 8. Under Sites find the LinkOne web site. 9. Select the parent node of LinkOne. This is normally Default Web Site. 10. On the Actions panel, click Bindings. 11. Click Add. 12. Setup the https binding as pictured below, where SSL certificate is set the certificate created above: 13. Click OK. 14. Click Close. User Setup At this time, the Link One/Ellipse integration requires a special Web View user be created. The username is l1http and in this example the password is also set l1http. This username and password, along with the WebView URL are used configure the LinkOne integration within Ellipse. Follow the steps below setup the user. 1. Enter the Link One web site URL in a web browser. 2. Log in Web View as an administrar (the default administration account is admin with matching password). 3. From the Web View menu, select Configuration->Users.

4. Configure the l1http user with matching password. 5.

Add the newly created user the Users role by selecting Users in

8 4. Configure the l1http user with matching password. 5. Press Enter or click the butn. The new user should appear as picture below. 6. Select the newly created user. 7. Add the newly created user the Users role by selecting Users in the Role combo box and clicking the butn. 8. By default the Users role does not have access any books. To configure the Users role, select Configuration->Roles.

9. Select the Users role from the list of users. 10. Select Allowed Books on the right hand panel. 11. Either select the All Books check box, or add the allowed books one, by one.

9 9. Select the Users role from the list of users. 10. Select Allowed Books on the right hand panel. 11. Either select the All Books check box, or add the allowed books one, by one. Books may be individually added by clicking, browsing the appropriate book, then clicking the butn. Advanced The Ellipse user may be configured access specific books. The steps above suggest adding the user the Users role. This allows this user access all books allowed by the Users role. The Ellipse user may instead be assigned a different role, or given explicit access certain books. For more details on Users, see the Mincom LinkOne WebView Getting Started Guide found in the Documentation direcry of the Web View install direcry. Once LinkOne is installed and a User set up for Ellipse there is a requirement provide Ellipse 8 with the access details. Refer the Operations Guide > First Steps > LinkOne for details.

Develop Java Webservice Client

Develop Java Webservice Client Develop Java Webservice Client Contents Develop Java Webservice Client 2 Commercial In Confidence 3 Preface 4 Summary information 4 Confidentiality 4 Document Control 4 Who