Skip to content

Commit db1efc6

Browse files
committed
Update SPO SPN cert
1 parent 20871b2 commit db1efc6

File tree

1 file changed

+43
-4
lines changed

1 file changed

+43
-4
lines changed

articles/data-factory/connector-sharepoint-online-list.md

Lines changed: 43 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ author: jianleishen
66
ms.subservice: data-movement
77
ms.custom: synapse
88
ms.topic: conceptual
9-
ms.date: 01/05/2024
9+
ms.date: 08/29/2024
1010
ms.author: jianleishen
1111
---
1212
# Copy data from SharePoint Online List by using Azure Data Factory or Azure Synapse Analytics
@@ -104,12 +104,17 @@ The following properties are supported for a SharePoint Online List linked servi
104104
| type | The type property must be set to: **SharePointOnlineList**. | Yes |
105105
| siteUrl | The SharePoint Online site url, e.g. `https://contoso.sharepoint.com/sites/siteName`. | Yes |
106106
| servicePrincipalId | The Application (client) ID of the application registered in Microsoft Entra ID. Refer to [Prerequisites](#prerequisites) for more details including the permission settings.| Yes |
107-
| servicePrincipalKey | The application's key. Mark this field as a **SecureString** to store it securely, or [reference a secret stored in Azure Key Vault](store-credentials-in-key-vault.md). | Yes |
107+
| servicePrincipalCredentialType | Specify the credential type to use for service principal authentication. Allowed values are `ServicePrincipalKey` and `ServicePrincipalCert`. | No |
108+
| ***For ServicePrincipalKey*** | | |
109+
| servicePrincipalKey | The application's key. Mark this field as a **SecureString** to store it securely, or [reference a secret stored in Azure Key Vault](store-credentials-in-key-vault.md). | No |
110+
| ***For ServicePrincipalCert*** | | |
111+
| servicePrincipalEmbeddedCert | Specify the base64 encoded certificate of your application registered in Azure Active Directory. | No |
112+
| servicePrincipalEmbeddedCertPassword | Specify the password of your certificate if your certificate has a password and you are using AadServicePrincipal authentication. | No |
113+
| | | |
108114
| tenantId | The tenant ID under which your application resides. | Yes |
109115
| connectVia | The [Integration Runtime](concepts-integration-runtime.md) to use to connect to the data store. If not specified, the default Azure Integration Runtime is used. | No |
110116

111-
112-
**Example:**
117+
**Example 1: Using service principal key authentication**
113118

114119
```json
115120
{
@@ -119,11 +124,45 @@ The following properties are supported for a SharePoint Online List linked servi
119124
"typeProperties": {
120125
"siteUrl": "<site URL>",
121126
"servicePrincipalId": "<service principal id>",
127+
"servicePrincipalCredentialType": "ServicePrincipalKey",
122128
"servicePrincipalKey": {
123129
"type": "SecureString",
124130
"value": "<service principal key>"
125131
},
126132
"tenantId": "<tenant ID>"
133+
},
134+
"connectVia": {
135+
"referenceName": "<name of Integration Runtime>",
136+
"type": "IntegrationRuntimeReference"
137+
}
138+
}
139+
}
140+
```
141+
142+
**Example 2: Using service principal certificate authentication**
143+
144+
```json
145+
{
146+
"name": "SharePointOnlineList",
147+
"properties": {
148+
"type": "SharePointOnlineList",
149+
"typeProperties": {
150+
"siteUrl": "<site URL>",
151+
"servicePrincipalId": "<service principal id>",
152+
"servicePrincipalCredentialType": "ServicePrincipalCert",
153+
"servicePrincipalEmbeddedCert": {
154+
"type": "SecureString",
155+
"value": "<base64 encoded string of (.pfx) certificate data>"
156+
},
157+
"servicePrincipalEmbeddedCertPassword": {
158+
"type": "SecureString",
159+
"value": "<password of your certificate>"
160+
},
161+
"tenantId": "<tenant ID>"
162+
},
163+
"connectVia": {
164+
"referenceName": "<name of Integration Runtime>",
165+
"type": "IntegrationRuntimeReference"
127166
}
128167
}
129168
}

0 commit comments

Comments
 (0)