Please note : This help page is not for the latest version of Enterprise Architect. The latest help can be found here.

Prev Next

Cloud Service using IIS (Optional)

For most users, the built-in web server provided with the Cloud Service provides all the functionality they require. It is also the easiest method to set up and use.

However, the Cloud Service also provides the option of integrating with Internet Information Services (IIS). This is recommended only for users for whom the built-in authentication methods are insufficient, and who want to use Windows Active Directory or certificate-based authentication (see the Import User IDs from Active Directory Help topic). Note that the use of IIS does not eliminate the login process, and users must still enter their user IDs and passwords.

To configure IIS to host the Cloud Service, you must first set the SparxCloudLink.sseap file to refer to the Cloud Service, and then in Windows open the Internet Information Services (IIS) Manager and configure it to send requests to the appropriate module. Depending on your preferences you can choose either an HTTP Module or an ISAPI module.

Prior to setting up HTTP or ISAPI, these settings must be made in IIS:

  • Application Pool settings
  • Feature Settings

For a secure HTTPS setup (optional):

  • Set up a Certificate
  • Set up HTTPS

Configuration Settings

Before setting up your HTTP module or ISAPI module, you must first check that the sscloudservices.config file for the service is configured as required, and note the port used so that you can specify it when you go on to set the SparxCloudLink.sseap file to refer to the Cloud Service.

The directory path containing the ISAPI dll also contains the SparxCloudLink.sseap configuration file.

The path should resemble this example:

     “C:\Program Files (x86)\Sparx Systems\Cloud Services\ISAPI”

Edit this file in a text editor, running as an Administrator.

The default contents are:

    [cloud]

    server=localhost

    port=803

server:

The address to look up the machine running the Cloud Service. In most circumstances it is best to run the HTTP module and the Cloud Service on the same machine. In this case, the default value of localhost can be used. If the Cloud Service is running on a different machine, use the IP address or server name where the service is running.

port:

The port the Cloud Service is listening on for admin requests. By default this takes the value of 803, but this should be cross-referenced against your service configuration in the sscloudservices.config file.

Optional settings

These points are optional. For testing purposes you might prefer to leave these changes until any issues with IIS are resolved.

  1. In the SSCloudServices.config file, remove all the references to ports other than the administration port (default 803). In other words, remove the bracketed entries (…) from the config file.
  2. Save the SSCloudService.config file.
  3. Restart the Service.

Application Pool Settings

HTTP or ISAPI will require an Application pool that is 32-bit and not managed code. This illustration shows the settings for 32-bit applications in the IIS Application Pools Advanced Settings view.

The settings for 32-bit applications in the IIS Application Pools Advanced Settings view.

Feature Permissions

This illustration shows the access path and the 'Default Web Site | Handler' mappings to permit Script Execution.

This illustration shows the access path and the 'Default Web Site | Handler' mappings to permit Script Execution.

Setting up a Certificate

In order to run the HTTPS service you must set up a security certificate in IIS.

In the IIS Manager:

  1. Under 'Connections', select the root connection (machine name).
  2. Double-click on the 'Server Certificates' icon.
  3. Click on 'Create Self Signed Certificate'.
  4. Specify a simple, user-friendly name for the certificate.

In order to run the HTTPS service you must set up a security certificate in IIS.

Setting up HTTPS

To set the bindings through which HTTPS will operate, you must include a port and a certificate in the site bindings.

In the IIS Manager:

  • Under 'Connections', select the 'Default Web Site' option
  • Under 'Actions' click on the 'Bindings' option
  • In the Site Bindings window click on 'Add'

To set the bindings through which HTTPS will operate, you must include a port and a certificate in the site bindings.

This will open the Add Site Binding window.

Set these parameters:

  • Type: HTTPS
  • Port: 443
  • SSL Certificate: select the certificate created in Setting up a Certificate

To set the bindings through which HTTPS will operate, you must include a port and a certificate in the site bindings.

HTTP Module

To set up the HTTP module in the Internet Information Services (IIS) Manager:

  1. In the 'Connections' panel, select the machine properties (top of the tree).
  2. Double-click on the 'Modules' icon in the middle panel.
    Setting up the HTTP module in the Internet Information Services (IIS) Manager
    This returns the 'Modules' list and the 'Actions' view.
  3. In the 'Actions' list, click on the 'Configure Native Modules…' option.
    Setting up the HTTP module in the Internet Information Services (IIS) Manager
    This opens the 'Configure Native Modules' view.
  4. Click on the Register button to open the 'Register Native Module' dialog.
    Setting up the HTTP module in the Internet Information Services (IIS) Manager
    Type in the name and the path of the SSCSIISHttpLink.dll file.
  5. Click on the OK button. The 'SSCloudServices' checkbox will now be selected.
    Setting up the HTTP module in the Internet Information Services (IIS) Manager
  6. Click on the OK button to close the 'Configure Native Modules' dialog.
  7. In the 'Connections' panel (see Step 1), click on your web site.
  8. Double-click on the 'Handler Mappings' in the middle pane.
    Setting up the HTTP module in the Internet Information Services (IIS) Manager
    This opens the Handler Mappings view:
    Setting up the HTTP module in the Internet Information Services (IIS) Manager
  9. In the 'Actions' list, click on the 'Add Module Mapping' option to open the 'Add Module Mapping' dialog.
  10. As illustrated, set the 'Request path' and 'Name'.
  11. In the 'Module' field, click on the drop-down arrow and select the module added in step 4.
    Setting up the HTTP module in the Internet Information Services (IIS) Manager
  12. Click on the Request Restrictions button. On the 'Request Restrictions' dialog, select the 'Access' tab. Select the 'Execute' radio button to enable Execute permission.
    Setting up the HTTP module in the Internet Information Services (IIS) Manager
  13. Select the 'Mappings' tab and deselect the 'Invoke Handler only if request is mapped to' checkbox.
  14. Click on the OK button.
  15. Close the 'Add Module Mapping' dialog by clicking on the OK button again.

To complete this HTTP module set up, see the Configuration Settings section at the start of this topic. You should then be able to connect to a model using Enterprise Architect via your IIS server using the HTTP module.

ISAPI Module

To configure an ISAPI module instead of the HTTP module:

  1. In the 'Connections' panel, select the machine properties:
    Configuring an ISAPI module
  2. Double-click on the 'Handler Mappings' icon:
    Cloud IIS Mappings Icon
  3. In the 'Actions' list, click on the 'Add Module Mapping' option.
  4. In the 'Add Module Mapping' dialog, set 'Request path' to 'sparxCloudLink.sseap', 'Module' to 'IsapiModule', and 'Executable' to 'SSCSIISIsapiLink.dll', as shown.
    Configuring an ISAPI module
  5. Click on the OK button to close the dialog. You should now be able to connect to a model using Enterprise Architect via your IIS server using ISAPI.

Learn more