> ## 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.

# Connecting to SharePoint Online

export const CommonAuthSchemeAzureserviceprincipal = () => {
  return <>
      <p>To connect with an Azure service principal and client secret, set the following properties:</p>
      <ul>
        <li><strong>Auth Scheme:</strong> Select <strong>AzureServicePrincipal</strong>.</li>
        <li><strong>Azure Tenant:</strong> Enter the Microsoft Online tenant to which you want to connect.</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>
      <p>To obtain the OAuth client Id and client secret for your application:</p>
      <ol>
        <li>Log in to the <a href="https://portal.azure.com" target="_blank" rel="noopener noreferrer">Azure portal</a>.</li>
        <li>In the left navigation pane, select <strong>All services</strong>. Then, search for and select <strong>App registrations</strong>.</li>
        <li>Click <strong>New registrations</strong>.</li>
        <li>Enter an application name and select <strong>Any Azure AD Directory - Multi Tenant</strong>.</li>
        <li>After you create the application, copy the application (client) Id value that is displayed in the <strong>Overview</strong> section. Use this value as the OAuth client Id.</li>
        <li>Navigate to the <strong>Certificates & Secrets</strong> section and select <strong>New Client Secret</strong> for the application.</li>
        <li>Specify the duration and save the client secret. After you save it, the key value is displayed.</li>
        <li>Copy this value because it is displayed only once. You will use this value as the OAuth client secret.</li>
        <li>On the <strong>Authentication</strong> tab, make sure to select <strong>Access tokens (used for implicit flows)</strong>.</li>
      </ol>
    </>;
};

export const CommonAuthSchemeAzuremsi = ({siteName = "CData Sync"}) => {
  return <>
      <p>
        To leverage Azure Managed Service Identity (MSI) when {siteName} is running on an Azure
        virtual machine, select <strong>Azure MSI</strong> for <strong>Auth Scheme</strong>. No
        additional properties are required.
      </p>
    </>;
};

export const CommonAuthSchemeAzuread = ({siteName = "CData Sync"}) => {
  return <>
      <p>
        To connect with an Azure Active Directory (AD) user account, select <strong>AzureAD</strong>{' '}
        for <strong>Auth Scheme</strong>. {siteName} provides an embedded OAuth application with
        which to connect, so no additional properties are required.
      </p>
    </>;
};

export const siteName = "CData Sync";

## SharePoint Online REST

In {siteName}, you can connect to SharePoint Online REST in several ways. Select your authentication method below, then proceed to the relevant section and follow those instructions.

* [**Azure Active Directory**](#azure-active-directory)
* [**Azure Managed Service Identity**](#azure-managed-service-identity)
* [**Azure Service Principal**](#azure-service-principal)

### Azure Active Directory

<CommonAuthSchemeAzuread siteName={siteName} />

After you complete this section, go to *Complete Your Connection* on the connection page to finish setting up the connection.

### Azure Managed Service Identity

<CommonAuthSchemeAzuremsi siteName={siteName} />

After you complete this section, go to *Complete Your Connection* on the connection page to finish setting up the connection.

### Azure Service Principal

<CommonAuthSchemeAzureserviceprincipal siteName={siteName} />

After you complete this section, go to *Complete Your Connection* on the connection page to finish setting up the connection.

## SharePoint Online SOAP

In {siteName}, you can connect to SharePoint Online SOAP in several ways. Select your authentication method below, then proceed to the relevant section and follow those instructions.

* [**Basic**](#basic)
* [**ADFS**](#adfs)
* [**Okta**](#okta)
* [**OneLogin**](#onelogin)

### Basic

To connect with user credentials, specify the following settings:

* **Auth Scheme:** Select **Basic**.
* **User:** Enter the username that you use to authenticate to your SharePoint account.
* **Password:** Enter the password that you use to authenticate to your SharePoint account.

After you complete this section, go to *Complete Your Connection* on the connection page to finish setting up the connection.

### ADFS

To connect with single sign-on (SSO) via ADFS, set the following properties:

* **Auth Scheme:** Select **ADFS**.
* **User:** Enter the username that you use to authenticate to your ADFS account.
* **Password:** Enter the password that you use to authenticate to your ADFS account.
* **SSO Login URL:** Enter the login URL that is used by your SSO provider.
* (Optional) **SSO Properties:** Enter a comma-separated list of the single sign-on (SSO) properties that you want to use.

After you complete this section, go to *Complete Your Connection* on the connection page to finish setting up the connection.

### Okta

To connect with single sign-on (SSO) via Okta, set the following properties:

* **Auth Scheme:** Select **Okta**.
* **User:** Enter the username that you use to authenticate to your Okta account.
* **Password:** Enter the password that you use to authenticate to your Okta account.
* **SSO Login URL:** Enter the login URL that is used by your SSO provider.
* (Optional) **SSO Properties:** Enter a comma-separated list of the single sign-on (SSO) properties that you want to use.

After you complete this section, go to *Complete Your Connection* on the connection page to finish setting up the connection.

### OneLogin

To connect with single sign-on (SSO) via OneLogin, set the following properties:

* **Auth Scheme:** Select **OneLogin**.
* **User:** Enter the username that you use to authenticate to your OneLogin account.
* **Password:** Enter the password that you use to authenticate to your OneLogin account.
* (Optional) **SSO Properties:** Enter a comma-separated list of the single sign-on (SSO) properties that you want to use.

After you complete this section, go to *Complete Your Connection* on the connection page to finish setting up the connection.