The SharePoint Online Connector can be configured using the Rest API. It requires the following entities to be created:
Bellow are the examples of how to create the Credentials, the Connection and the Seed. For the Connector please check this page.
Field | Optional | Default | Multiple | Notes | Example |
---|---|---|---|---|---|
type | No | - | No | The value must be "sharepoint-online". | "sharepoint-online" |
description | No | - | No | Short description or name for the credential. | "SPO_Prod_Credentials" |
throttlePolicy | Yes | - | No | Throttle policy ID that will affect all seeds that use this credential. | "4f07e6c5-d2e9-48d8-a55d-094917508c0f" |
properties.useAzureAuthentication | No | - | No | Whether credentials are Azure AD Application (true) credentials or User account credentials (false). | true |
properties.tenantDomain | No | - | No | Only required if useAzureAuthentication is true. Tenant domain the Azure AD Application is part of. | "contoso.onmicrosoft.com" |
properties.clientId | No | - | No | Only required if useAzureAuthentication is true. Azure AD Application ID. | "1a1a-2b2b2-2cc22-aaa456" |
properties.certificatePath | No | - | No | Only required if useAzureAuthentication is true. Path to the certificate file. This path has to be accesible by all worker nodes that will use these credentials. | "${dist.data.dir}/${app.name}/certificates/certificate.cer" |
properties.privateKeyPath | No | - | No | Only required if useAzureAuthentication is true. Path to the certificate private key file. This path has to be accesible by all worker nodes that will use these credentials. | "${dist.data.dir}/${app.name}/keys/key.key" |
properties.username | No | - | No | Only required if useAzureAuthentication is false. Username for the crawl account when using user/password credentials. | "[email protected]" |
properties.password | No | - | No | Only required if useAzureAuthentication is false. Password for the crawl account when using user/password credentials. This field can also be sent as an encrypted string. Check the encryption API for more information on how to encrypt. | "password" |
$action.getHelper().renderConfluenceMacro("$codeS$body$codeE")
Field | Optional | Default | Multiple | Notes | Example |
---|---|---|---|---|---|
id | No | - | No | Id of the credential to update | "d42e1872-02c8-4a90-a714-44f15577389a" |
type | No | - | No | The value must be "sharepoint-online". | "sharepoint-online" |
description | Yes | - | No | Short description or name for the credential. | "SPO_Prod_Credentials" |
throttlePolicy | Yes | - | No | Throttle policy ID that will affect all seeds that use this credential. | "4f07e6c5-d2e9-48d8-a55d-094917508c0f" |
properties.useAzureAuthentication | Yes | - | No | Whether credentials are Azure AD Application (true) credentials or User account credentials (false). | true |
properties.tenantDomain | Yes | - | No | Only required if useAzureAuthentication is true. Tenant domain the Azure AD Application is part of. | "contoso.onmicrosoft.com" |
properties.clientId | Yes | - | No | Only required if useAzureAuthentication is true. Azure AD Application ID. | "1a1a-2b2b2-2cc22-aaa456" |
properties.certificatePath | Yes | - | No | Only required if useAzureAuthentication is true. Path to the certificate file. This path has to be accesible by all worker nodes that will use these credentials. | "${dist.data.dir}/${app.name}/certificates/certificate.cer" |
properties.privateKeyPath | Yes | - | No | Only required if useAzureAuthentication is true. Path to the certificate private key file. This path has to be accesible by all worker nodes that will use these credentials. | "${dist.data.dir}/${app.name}/keys/key.key" |
properties.username | Yes | - | No | Only required if useAzureAuthentication is false. Username for the crawl account when using user/password credentials. | "aspire_crawl_account@contoso.onmicrosoft.com" |
properties.password | Yes | - | No | Only required if useAzureAuthentication is false. Password for the crawl account when using user/password credentials. This field can also be sent as an encrypted string. Check the encryption API for more information on how to encrypt. | "password" |
$action.getHelper().renderConfluenceMacro("$codeS$body$codeE")
$action.getHelper().renderConfluenceMacro("$codeS$body$codeE")