Skip to main content
Version: 4.1 (2026 H2)

Http

The HttpSyncSource can be used to load data from any web API.

<HttpSyncSource name="Custom HTTP" queryKey="OneOffixxIdentifier">
  <Endpoint method="GET" url="http://127.0.0.1:8080/test/{queryKey}" />
  <Authentication type="Basic">
    <Username>Username</Username>
    <Password>Password</Password>
    <Domain>Domain</Domain>
  </Authentication>
  <ResultMapping>
    <Mapping Type="xml">
      <Map Source="//Identifikation[@Name='ID']" Target="PropertyX" />
      <If Condition="'1'=='1'">
        <Map SourceValue="Hans" Target="PropertyY" />
      </If>
      <Map Source="//Email" Target="PropertyZ" />
    </Mapping>
  </ResultMapping>
  <Claims>
    <Claim type="http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name" property="PropertyX" />
    <Claim type="http://schema.oneoffixx.com/ws/2011/01/identity/claims/displayName" property="PropertyY" />
    <Claim type="http://schema.oneoffixx.com/ws/2011/01/identity/claims/title" property="PropertyZ">
      <Regex match="0" group="0">(?:[\.a-z]+)</Regex>
    </Claim>
    <Claim type="http://schema.oneoffixx.com/ws/2011/01/identity/claims/domain" property="PropertyZ">
      <Regex match="1" group="0">(?:[\.a-z]+)</Regex>
    </Claim>
  </Claims>
</HttpSyncSource>

Endpoint​

The endpoint must be a valid URI, but may contain the placeholder {queryKey}. This will be replaced by the value of the queryKey parameter from the SyncSource before the call.

Authentication​

  • Type Authentication type. Possible are:
    • Basic Basic authentication
    • Windows Windows authentication
  • Username Username, always without domain
  • Password Password, can be in encrypted form or plain text
  • Domain Domain of the user, optional (only possible for type Windows).

ResultMapping​

The web API response can be evaluated as either XML or JSON. The format is controlled via the Type attribute of the Mapping element (Type="xml" or Type="json"); the example above uses Type="xml". The Target is a value that must correlate with the property parameter of a claim. Details and configuration examples for both formats can be found here: Mapping.