---
sourceDocument: Brazil Workflow Data Fabric
sourceDocumentLink: https://www.servicenow.com/docs/r/integrate-applications

 Release :

    - brazil

ft:locale :

    - en-US

ft:publication_title :

    - Brazil Workflow Data Fabric

ft:clusterId :

    - crint

bundleId :

    - crint

workflow :

    - Creator


---

# Set up the SAP S4 HANA IDoc spoke

# Set up the SAP S4 HANA IDoc
spoke {#ariaid-title1}

Release version: Brazil  
Updated March 12, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 minutes to read  
Integrate the ServiceNow instance and SAP S4 HANA IDoc spoke by using
the Basic Auth credentials to authenticate ServiceNow
requests.

## Before you begin

* Request an Integration Hub subscription.
* Activate the SAP S4 HANA IDoc spoke.
* Role required: admin.

{#setup-sap-s4-hana-idoc__ul_agy_qfxd_rlb}  
Note:  
To retrieve information, use the Execute RFC spoke action in the [SAP S4 HANA RFC Spoke](https://www.servicenow.com/docs/0PYjGw18wHKqalp7vilcTg "The SAP S4 HANA RFC spoke is built by Bristlecone, Inc. Manage procurement, records, journals, and others, in SAP S4 HANA RFC account from your ServiceNow instance.").

## Procedure

1. Configure MID Server using the SAP proprietary JAR files.
   1. **Optional:** Navigate to System PropertiesSecurity.  
      Note:  
      This is applicable only if your MID Server is installed on a Linux machine
   2. **Optional:** Disable the MIME type validation for file attachments.  
      Note:  
      This is applicable only if your MID Server is installed on a Linux machine.
   3. Navigate to MID ServerJAR Files.
   4. Upload the required SAP proprietary files (JAR, SO, or DLL) obtained after contacting your SAP S4 HANA IDoc admin.  
      For more information, see [Synchronize a JAR file to MID Servers](https://www.servicenow.com/docs/access?context=t_SynchronizeAJARFiletoMIDServers&version=brazil&pubname=brazil-servicenow-platform&ft:locale=en-US).

   {#setup-sap-s4-hana-idoc__substeps_ggr_tv5_f4b}  
   Note:  
   Ensure that the files are synchronised in the \<MID-Server-root-directory\>/agent/extlib directory. If the files aren't synchronised, restart the MID Server.
2. Create a credential record for the SAP S4 HANA IDoc account.
   1. Navigate to Connections \& CredentialsCredentials.
   2. Click New.  
      The system displays this message: What type of Credentials would you like to create?
   3. Select Basic Auth Credentials.
   4. On the form, fill these values.  
      {#setup-sap-s4-hana-idoc__table_q3d_tjd_ymb__entry__2}

      | Field | Description |
      |-|-|
      | Name | Name to uniquely identify the record. For example, <kbd class="ph userinput">SAP S4 HANA IDoc Cred</kbd>. |
      | User name | User name to log in to your SAP S4 HANA IDoc account. |
      | Password | Password to authenticate and log in to your SAP S4 HANA IDoc account. |
      | Active | Option to actively use the credential record. |
      | Order | Order to apply this credential. For example, <kbd class="ph userinput">100</kbd>. |
      | Credential alias | Credential alias associated with the spoke. |
      [Table 1. Basic Auth Credentials form]

      {#setup-sap-s4-hana-idoc__table_q3d_tjd_ymb}
   5. Click Submit.
   {#setup-sap-s4-hana-idoc__substeps_pqb_3w5_f4b}
3. Create a connection record for your SAP S4 HANA IDoc account.
   1. Navigate to Connections \& CredentialsConnections \& Credentials Aliases.
   2. Open the alias record for SAP S4 HANA IDoc.
   3. From the Connections tab, click New.
   4. On the form, fill these fields.  
      {#setup-sap-s4-hana-idoc__table_vp2_3ld_ymb__entry__2}

      | Field | Description |
      |-|-|
      | Name | Name to uniquely identify the record. For example, <kbd class="ph userinput">SAP S4 HANA IDoc Connection</kbd>. |
      | Credential | Credential record created for SAP S/4 HANA IDoc spoke. For example, <kbd class="ph userinput">SAP S4 HANA IDoc Cred</kbd>. |
      | Connection alias | Alias record associated with this connection. |
      | Host | Fully qualified domain name of the target host where the SAP S4 HANA IDoc server is installed. |
      | Active | Option to actively use the connection record. |
      | Domain | Domain that the action runs in. |
      | Override default port | Target port used by the connection. If blank, the system uses the default port. |
      | Use MID server | Option to use a MID Server for this connection. Select the check box and define the fields in the Advanced MID Server Configuration tab. |
      [Table 2. Connection form]

      {#setup-sap-s4-hana-idoc__table_vp2_3ld_ymb}
   5. In the Advanced MID Server Configuration tab, provide these details.  
      {#setup-sap-s4-hana-idoc__table_mqc_3yd_ymb__entry__2}

      | Field | Description |
      |-|-|
      | Capabilities | Capabilities the MID Server must support to be eligible for selection. The system runs the action or activity from a MID Server that supports the selected capabilities. Required capabilities determine which MID Server is selected at runtime. To learn more about how a MID Server is selected during runtime, see [MID Server selection](https://www.servicenow.com/docs/access?context=c_MIDServerSelector&version=brazil&pubname=brazil-servicenow-platform&ft:locale=en-US). |
      | MID Application | Application the MID Server must support to be eligible for selection. The system runs the action from a MID Server that supports the selected application. To learn more about how a MID Server is selected during runtime, see [MID Server selection](https://www.servicenow.com/docs/access?context=c_MIDServerSelector&version=brazil&pubname=brazil-servicenow-platform&ft:locale=en-US). |
      [ ]

      {#setup-sap-s4-hana-idoc__table_mqc_3yd_ymb}
   6. In the Attributes tab, provide these details.  
      {#setup-sap-s4-hana-idoc__table_eq2_ccq_xmb__entry__2}

      | Field | Description |
      |-|-|
      | Client | Client value of the target host where the SAP S4 HANA IDoc server is installed. |
      | u_system_number | System number of the target host where the SAP S4 HANA IDoc server is installed. |
      | u_lang | Language selected in the target host where the SAP S4 HANA IDoc server is installed. |
      [ ]

      {#setup-sap-s4-hana-idoc__table_eq2_ccq_xmb}
   7. Click Submit.
   {#setup-sap-s4-hana-idoc__substeps_qrr_4w5_f4b}

*[\>]: and then