Proxy Service

The DATA UNIT Portal provides a Proxy Functionality. Because we store all information, like Port and Endpoint Information (IP-Address or Domain) we can forward any calls (as long they are XML or JSON Body) to the configured Endpoint.

To protect the Endpoint, we provide three different possibilities:

1. No Auth
   If required, the user can configure on a specific Tenant, that the Endpoint does not requires any Authentication. This should only be used for testing purpose.

2. API Token
   On the Tenant, the user can generate a API Token. It is possible to generate n-Tokens on a specific Tenant. There is no Limit

3. OAuth 2.0
   A special Endpoint also provides a OAuth 2.0 implementation. This is only available on a specific Route

Routes

The Route with Authentication (No Auth and API Token) is accessible under:

https://api.portal.dataunit.ch/proxy/{{proxyName}}

The Proxy Name must be configured in the Portal on the specific Tenant using the “Generate Proxy Endpoint” button. It will use a combination of the System- and Tenantname and will be unique in the System.

The Route with OAuth 2.0 is accessible under:

https://api.portal.dataunit.ch/proxy-auth/{{proxyName}}

API Token

To generate an API Token, navigate to the Tenant Detail Page and select the API Token Tab. Then Click on the Generate API Token Button.

Provide a proper name.

Optional: provide a Valid Until Date. The Token will be deleted if its older than the provided Date.

Optional: change the default length of the API Token

1. Navigate to Systems and click on the System you want to add an API Token
   

   

2. Click on the Tenant you want to add API Token
   

   

3. Click on the API Tokens Tab and then press Generate Token

4. Provide a Service Name. Choose a Name, which represents the Service which will use the API Token. Something like webshop-api-token
   

   

5. Copy and add the API Token to the HTTP Header. The Key in the Header must be x-api-key