Install and Configure Web Services Gateway / CORS


The following configuration is required for both ProjectWise Web and ProjectWise Web View cloud services.

Install and Configure Bentley Web Services Gateway and the ProjectWise Plug-in

  1. You need to have a secure website in IIS (Internet Information Services) where you will deploy the latest versions of Bentley Web Services Gateway and the ProjectWise plug-in. Check with your IT administrator for help.

  2. Install the latest version of ProjectWise Explorer if you don’t already have it, and configure the ProjectWise network to provide Bentley Web Services Gateway with access to the datasource(s) on your ProjectWise Design Integration server or servers.


  3. Install Bentley Web Services Gateway (WSG) and the ProjectWise Plug-in.

    Starting with ProjectWise CONNECT Edition Update 3.3, the ProjectWise Plug-in for WSG is a separate download, and is no longer delivered with ProjectWise Server Setups.

    Bentley Web Services Gateway 02.06.08.09 is also available as a separate download. This is the same version that was delivered with ProjectWise CONNECT Edition Update 3.2. If you already have this version of WSG, then all you need to do is get the latest version of the plug-in. 

    Note: Normally, the version of the plug-in must match the version of ProjectWise Explorer. For example, ProjectWise Plug-in for WSG CONNECT Edition Update 3.3 requires ProjectWise Explorer CONNECT Edition Update 3.3. However, ProjectWise Plug-in for WSG CONNECT Edition Update 3.4 requires ProjectWise Explorer CONNECT Edition Update 3.3 and does not work with or support ProjectWise Explorer CONNECT Edition Update 3.4.
  4. Deploy Bentley Web Services Gateway and the ProjectWise Plug-in to the secure website mentioned in step 1.
  5. During deployment, make sure you configure the deployment to allow CORS (cross-origin resource sharing) requests coming from various services. To configure this, you need to enter the URL of each of the following services (separate each URL with a comma) in the Bentley Web Services Gateway deployment wizard. Note that ProjectWise Web and ProjectWise Web View require a different set of URLs (see the table below). 

For this service

Enter this URL  

Required for

ProjectWise Web

https://connect-projectwisewac.bentley.com

ProjectWise Web 

ProjectWise Web View

https://connect-projectwisewebview.bentley.com  

ProjectWise Web View

Integration with Microsoft Teams

https://connect-projectwiseteamshost.bentley.com
ProjectWise Web

Integration with Microsoft Office for the web 

https://connect-mswopiclient.bentley.com    

ProjectWise Web View

PDF Markup Service

https://connect-pdfmarkup.bentley.com  

ProjectWise Web 

Old work area connections (those created in old ProjectWise Web / ProjectWise Share)

https://projectshareportal.bentley.com  

ProjectWise Web

ProjectWise 365 

https://projectwise365.bentley.com

ProjectWise 365

  1. If you want to allow external users access to your datasource, or let users view Office documents online, you must configure your Bentley Web Services Gateway deployment to be public facing. There are two
    places you need to open port 443 (default). Your IT administrator will need to do this for you.
    • First - and this is required for both internal and external users - in the Windows Firewall on the Bentley Web Services Gateway computer
    • Second - and this is required only for external users - in your corporate firewall

Here are diagrams of how access is controlled: Here’s the link to the PowerPoint version with animations.

Adding Datasource Connections

Only cloud service administrators can add a connection to each datasource you want to make available to users in ProjectWise Web.

Open ProjectWise Web and click the Manage Connections button. In the Create New Connection window, configure the following:

  1. Connection Name- Enter a name for the connection.
  2. Repository type - Choose ProjectWise
  3. Server URL- Enter the URL address of where Bentley Web Services Gateway is deployed (for example, https://<server_name>/ws), where <server_name> is the name of the computer on which Bentley Web Services Gateway is installed (for example, bentley.com), and ws is the name that was given to the virtual directory that Bentley Web Services Gateway and the ProjectWise plug-in were deployed to.
  4. Get Datasource- Click Get Datasource after you enter the Bentley Web Services Gateway address. This populates the Datasource list mentioned in the next step.
  5. Datasource- Select the datasource that you want to make a connection to.
  6. Use Bentley IMS Authentication - (recommended) Turn this setting on if you want users to be automatically logged in with their Bentley IMS accounts when they click this work area connection in ProjectWise Web. Also, the Bentley IMS user that you are currently signed in as will automatically be used to create the connection. Users who do not have a Bentley IMS account in the datasource will be prompted to log in manually when they click this work area connection (they can enter their logical account or their Windows-based account).

    This setting does not display at all if BentIey IMS single sign-on is not enabled in the datasource, or if Bentley IMS single sign-on is enabled but there are no Bentley IMS accounts in the datasource. If the setting does not display, or if you turn the setting off, you will see a message that says, This type of connection is not federated and will prevent online editing of Microsoft Office documents.

    or

    User Name and Password - The User Name and Password fields are only used if the Use Bentley IMS Authentication setting is turned off or does not display at all. If either of these is true, then you must enter the user name and password of a ProjectWise user who has access to this work area which will be used to create the connection. When configuring a connection that does not use Bentley IMS authentication, any user who tries to open this work area in ProjectWise Web will be prompted to enter their user name and password, which can either be a logical account or a Windows-based account.

  7. Work Area - Select the work area from the selected datasource that you want to make a connection to.

    The Work Area list displays all of the work areas in the datasource that the user who is creating the connection has access to, and for which a connection does not already exist.

  8. Description- (Optional) Enter a description of this connection. The name of the datasource is used as the description if no description is entered.
  9. Sync Work Area Participants - (Optional) Turn this option on if you want the participants of the selected work area to be automatically added as members of the ProjectWise project the first time they log in to the work area connection from ProjectWise Web.

    This option is off by default. If you do not turn it on now, you can turn it on later by editing the work area connection.

    When this option is off, you can still manually add your work area participants to the ProjectWise project by going to the Project Team Management portal (https://connect-rbacportal.bentley.com/) of your project.

  10. When finished, click Connect.
  11. Authorized users will now see this datasource.

 

Adding Users

User permissions are set in ProjectWise Explorer. If a user has access to a datasource, then they will see the datasource when they log into ProjectWise Web.

Feature Overview

Want to see what you can do with ProjectWise Web? Visit our online Help file or Communities Page.

Supported Browsers

Latest versions of:

*Preferred browsers

Again, if you need more detailed instructions on setting up ProjectWise Web, see your ProjectWise Web documentation or ProjectWise Administrator Help.