Card Webservice

Collectors are usually connecting directly to the card REST web service in the Cloud. In some infrastructures this might not be always feasible. Based on this you can install an on premise web service which can talk to the Cloud web service. The Card Webservice is a SOAP and REST based web service, which can be used as a kind of relay between the onpremise world and the ONE cloud. The Card Webservice often gets installed on the same machine where the Hub is installed, because that machine has already outbound connectivity to the Cloud.

Your internal system (e.g. SharePoint, SAP) can now connect to the Card Webservice which is installed internally and the Card Webservice simply passed the data through to the Cloud.

One example where this is used is the SAP collector. SAP doesn't connect directly to the internet in most cases and often doesn't allow to connect to REST services, like the ONE card service in the cloud is build for. The Card Webservice in this case takes an XML extract from SAP and converts it into JSON to pass it to the Cloud's REST endpoint.

The other example is when a SharePoint isn't allowed to connect straight to the internet, you can simply use the build in REST webservice of this Card Webservice as your internal proxy. The REST endpoint of the Card Webservice simply passes the incoming JSON to the Cloud's REST endpoint.

Before installing, please make sure, the machine meets the Prerequisites.

The Card Webservice ("Collector Proxy") can be downloaded in the "Get Started" section of the admin portal on one.sitrion.com.

Install the Card Webservice

The following screen shows the Setup program of the Card Webservice

Click Next to continue.

Destination Folder

Choose the folder for the Card Webservice to be installed in.

Click Next to continue.

User Settings

Configure the user for the Application Pool. If not changed, it will install with the Network Service account on the installed machine.

Click Next to continue.

Website Settings

Configure the Website Name and the port which is used in the IIS for the Card Webservice

Click Next to continue.

Company Id / Shared Key / Environment Name

The Company Id and Shared Key are the identifieres of your tenant. You can retrieve your own company Id on one.sitrion.com.

The environment name should by default target to https://one.sitrion.com.

Ready to install

Click Install to start the installation of the Card Webservice on your machine

Finish

The Card Webservice is now installed.

Click Finish to exit the setup.

Validate

To validate if the card webservice is hosted you can check if the WSDL is accessible

The service should be accessed via the following URL if you used the default settings http://localhost:8095/CardService.svc?singleWsdl

You may have to adjust "localhost:8095" to your corresponding name and port.

FYI: The REST endpoint of the webservice is hosted straight on the base URL, which would be in the default installation "http://localhost:8095". Reflecting this e.g. for the SharePoint collector: Instead of using https://one.sitrion.com as the environment name, you would configure "http://mycardwebservicemachine:8095" (where mycardwebservicemachine is the name of the place where you installed the Card webservice and of course the corresponding port).

Proxy Configuration

The proxy configuration itself needs to be configured manually in the config file of the Card Webservice. The config file is by default located in the folder "C:\Program Files\Sitrion\Sitrion ONE Card Webservice\Web.config". The file itself is a default .NET configuration file where a proxy can be configured with .NET defaults, like described in this MSDN article.

Share this page
X
Tell your colleagues and friends about Sitrion. Choose a social channel below to share this page.