> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sync.cdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# SAP Gateway

export const CommonAuthSchemeBasic = ({siteName = "CData Sync", siteNameShort = "Sync", datasource = "the data source"}) => {
  return <>
      <p>To connect with your user credentials, set the following properties:</p>
      <ul>
        <li><strong>Auth Scheme:</strong> Select <strong>Basic</strong>.</li>
        <li><strong>User:</strong> Enter the username that you use to authenticate to your {datasource} account.</li>
        <li><strong>Password:</strong> Enter the password that you use to authenticate to your {datasource} account.</li>
      </ul>
    </>;
};

export const CommonAuthSchemeOauthCustom = ({siteName = "CData Sync", siteNameShort = "Sync", datasource = "the data source"}) => {
  return <>
      <p>To connect with OAuth custom credentials, specify the following properties:</p>
      <ul>
        <li><strong>Auth Scheme:</strong> Select <strong>OAuth</strong>.</li>
        <li><strong>OAuth Client Id:</strong> Enter the client Id that you were assigned when you registered your application with an OAuth authorization server.</li>
        <li><strong>OAuth Client Secret:</strong> Enter the client secret that you were assigned when you registered your application with an OAuth authorization server.</li>
      </ul>
    </>;
};

export const CommonDatasourceMoreInformation = ({datasource = "the data source", advancedurl = "", siteName = "CData Sync", driverVersion = ""}) => {
  return <>
      <p>
        For more information about interactions between {siteName} and {datasource}, see{' '}
        <a href={`https://cdn.cdata.com/help/${advancedurl}${driverVersion}/synch/default.htm`}>
          {datasource} Connector for {siteName}
        </a>.
      </p>
    </>;
};

export const CommonDatasourceAddConnector = ({datasource = "the data source", title = "the connector", destination = false, siteNameShort = "Sync"}) => {
  return <>
      <p>
        To enable {siteNameShort} to use data from {datasource}, you first must add the
        connector, as follows:
      </p>
      <ol>
        <li>Open the <strong>Connections</strong> page of the {siteNameShort} dashboard.</li>
        <li>Click <strong>Add Connection</strong> to open the <strong>Select Connectors</strong> page.</li>
        <li>
          Click the <strong>{destination ? "Destinations" : "Sources"}</strong> tab and locate
          the <strong>{title}</strong> row.
        </li>
        <li>
          Click the <strong>Configure Connection</strong> icon at the end of that row to open
          the <strong>New Connection</strong> page. This action opens the{' '}
          <strong>Add Connection</strong> dialog box.
          <br />
          <strong>Note:</strong> If the <strong>Configure Connection</strong> icon is not
          available, click the <strong>Download Connector</strong> icon to install
          the {title} connector.
        </li>
        <li>Enter a name for your connection in the <strong>Add Connection</strong> dialog box.</li>
        <li>Click <strong>Add</strong> to open the <strong>Settings</strong> tab for your connector.</li>
      </ol>
      <p>
        For more information about installing new connectors, see{' '}
        <a href="../connections">Connections</a>.
      </p>
    </>;
};

export const CommonDatasourceIntroSource = ({datasource = "the data source", siteName = "CData Sync"}) => {
  return <p>
      You can use the {datasource} connector from the {siteName} application to capture data
      from {datasource} and move it to any supported destination. To do so, you need to add
      the connector, authenticate to the connector, and complete your connection.
    </p>;
};

export const driverVersion = "M";

export const siteNameShort = "Sync";

export const siteName = "CData Sync";

export const datasource = "SAP Gateway";
export const pageTitle = "SAP Gateway";
export const advancedurl = "GC";
export const oauthschemes = "OAuth or OAuthPKCE";

<CommonDatasourceIntroSource datasource={datasource} siteName={siteName} />

## Add the SAP Gateway Connector

<CommonDatasourceAddConnector datasource={datasource} title={pageTitle} destination={false} siteNameShort={siteNameShort} />

## Authenticate to SAP Gateway

After you add the connector, you need to set the required properties.

**URL:** Enter the URL either for your environment (for example, [https://sapes5.sapdevcenter.com/](https://sapes5.sapdevcenter.com/)) or to the full URL of the service. For example, your environment URL might be simliar to [https://sapes5.sapdevcenter.com](https://sapes5.sapdevcenter.com), and the full URL to your service might be similar to [https://sapes5.sapdevcenter.com/sap/opu/odata/IWBEP/GWSAMPLE\_BASIC/](https://sapes5.sapdevcenter.com/sap/opu/odata/IWBEP/GWSAMPLE_BASIC/).

{siteName} supports authenticating to {pageTitle} in several ways. Select your authentication method below to proceed to the relevant section that contains the authentication details.

* [**OAuth**](#oauth) (default)
* [**Basic**](#basic)
* [**Token**](#token)
* [**OAuth PKCE**](#oauth-pkce)
* [**SAS BTP Destination Service**](#sap-btp-destination-service)

### OAuth

<CommonAuthSchemeOauthCustom siteName={siteName} siteNameShort={siteNameShort} datasource={datasource} />

* **Scope:** Enter space-separated values for the permission scopes. These scopes are required when you authenticate via an OAuth2.0 flow.

### Basic

<CommonAuthSchemeBasic siteName={siteName} siteNameShort={siteNameShort} datasource={datasource} />

### Token

To connect with an access token, specify the following properties:

* **Auth Scheme:** Select **Token**.
* **API Key:** Enter the API key of the application that you created.

### OAuth PKCE

To connect with the OAuth PKCE extension, specify the following properties:

* **Auth Scheme:** Select **OAuthPKCE**.
* **OAuth Client Id:** Enter the client Id that you were assigned when you registered your application with an OAuth authorization server.

### SAP BTP Destination Service

To connect via the SAP BTP Destination Service, select **SAPBTP** for **Auth Scheme**. No additional properties are required.

## Complete Your Connection

To complete your connection:

1. Specify the following properties:
   * (Optional) **Namespace:** Enter the service namespace from which you want to retrieve data.

     <Note>You must specify the namespace if the service is not specified in the URL.</Note>

   * (Optional) **Service:** Enter one or more services (separated by commas) from which you want to retrieve data.

     <Note>If the service or services is set in the URL, this property is ignored. If the services are not set either in the URL or via this property, the {datasource} catalog service is used to discover all the available services.</Note>

   * **Custom Url Params:** Enter any additional required properties that you need to include with the HTTP request (for example, **sap-client=001\&sap-language=EN**).
2. Define advanced connection settings on the **Advanced** tab. (In most cases, though, you should not need these settings.)
3. {oauthschemes ? `If you authenticate with ${oauthschemes}, click` : "Click"} **Connect to {datasource}** to connect to your {pageTitle} account.
4. Click **Create & Test** to create your connection.

## More Information

<CommonDatasourceMoreInformation datasource={datasource} advancedurl={advancedurl} siteName={siteName} driverVersion={driverVersion} />