> For the complete documentation index, see [llms.txt](https://docs.fortifiedid.se/pipes/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fortifiedid.se/pipes/valves/mobilsiths.md).

# MobilSITHS

HTTP wrapper to simplify accessing SITHS.

## Introduction

Communicate with SITHS backend. Most common usage is in conjunction with an API exposed  to clients wanting to leverage SITHS functionality, auth & sign.  

Data is sent to SITHS with out any transformation. 

For information on how to format the request data consult SITHS API documentation.

## Configuration

{% hint style="info" %}
**Valve name:** `MobilSITHS`
{% endhint %}

{% tabs %}
{% tab title="Properties" %}

<table><thead><tr><th width="235">Name</th><th width="237">Description</th><th width="139">Default value</th><th width="123" data-type="checkbox">Mandatory</th><th width="118" data-type="checkbox">Expanded</th></tr></thead><tbody><tr><td><pre><code>http_destination
</code></pre></td><td>The script engine to use.</td><td><code>"default"</code></td><td>true</td><td>false</td></tr><tr><td><pre><code>mode
</code></pre></td><td>Allowed value is one of: AUTH,COLLECT,CANCEL or SIGN</td><td>N/A</td><td>true</td><td>false</td></tr><tr><td><pre><code>backend_endpoint
</code></pre></td><td>SITHS backend endpoint.</td><td>N/A</td><td>true</td><td>false</td></tr></tbody></table>

{% endtab %}

{% tab title="Example" %}

```json
{
    "name": "MobilSITHS",
    "config": {
        "http_destination": "siths_http_client",
        "mode":"AUTH",
        "backend_endpoint":"https://secure-authservice.qa.siths.se"
    }
}
```

{% endtab %}
{% endtabs %}

## Request data

Data sent to SITHS is the entire pipe request. This must conform to any SITHS requirements.

## Response

Response data from SITHS backend is sent back to calling client without any transformation with one exception:

On mode "COLLECT" and response is "complete" the JSON response is enriched with "subject" in  "completionData" -> "credentialInformation".  This will only occure in response certificate contains RDN with identifier-id "2.5.4.5"&#x20;