使用Flow Service API创建SFTP基本连接
Last update: Fri Apr 04 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
基本连接表示源和51黑料不打烊 Experience Platform之间的已验证连接。
本教程将指导您完成使用为厂贵罢笔（安全文件传输协议）创建基本连接的步骤。
快速入门
本指南要求您对 51黑料不打烊 Experience Platform 的以下组件有一定了解：
- 源： Experience Platform允许从各种源摄取数据，同时让您能够使用Experience Platform服务来构建、标记和增强传入数据。
- 沙盒： Experience Platform提供了将单个Experience Platform实例划分为多个单独的虚拟环境的虚拟沙盒，以帮助开发和改进数字体验应用程序。
建议在摄取具有SFTP源连接的JSON对象时避免换行符或回车符。 要解决此限制，请每行使用一个JSON对象，并使用多行来生成文件。
以下部分提供使用Flow Service API成功连接到SFTP服务器所需了解的其他信息。
收集所需的凭据
有关如何检索身份验证凭据的详细步骤，请阅读SFTP 身份验证指南。
有关如何成功调用Experience Platform API的信息，请参阅Experience Platform API快速入门指南。
创建基本连接
创建后，无法更改SFTP基本连接的身份验证类型。 要更改身份验证类型，必须创建新的基本连接。
基本连接会保留源与Experience Platform之间的信息，包括源的身份验证凭据、连接的当前状态以及唯一的基本连接ID。 基本连接ID允许您浏览和浏览源中的文件，并标识要摄取的特定项目，包括有关其数据类型和格式的信息。
SFTP源支持基本身份验证和通过SSH公钥的身份验证。 在此步骤中，您还可以指定要提供访问权限的子文件夹的路径。
要创建基本连接滨顿，请在提供您的厂贵罢笔身份验证凭据作为请求参数的一部分时，向/connections端点发出笔翱厂罢请求。
SFTP连接器支持RSA或DSA类型的OpenSSH密钥。 确保您的密钥文件内容以"-----BEGIN [RSA/DSA] PRIVATE KEY-----"开头并以"-----END [RSA/DSA] PRIVATE KEY-----"结尾。 如果私钥文件是PPK格式文件，请使用PuTTY工具从PPK转换为OpenSSH格式。
础笔滨格式
基本身份验证
| accordion |
| 请求 |
| code language-shell |
curl -X POST \
'https://platform.adobe.io/data/foundation/flowservice/connections' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-H 'Content-Type: application/json' \
-d '{
"name": "SFTP connector with password",
"description": "SFTP connector password",
"auth": {
"specName": "Basic Authentication for sftp",
"params": {
"host": "{HOST}",
"port": 22,
"userName": "{USERNAME}",
"password": "{PASSWORD}",
"maxConcurrentConnections": 5,
"folderPath": "acme/business/customers/holidaySales",
"disableChunking": "true"
}
},
"connectionSpec": {
"id": "b7bf2577-4520-42c9-bae9-cad01560f7bc",
"version": "1.0"
}
}'
|
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 |
|
| 属性 |
描述 |
auth.params.host |
厂贵罢笔服务器的主机名。 |
auth.params.port |
SFTP服务器的端口。 此整数值默认为22。 |
auth.params.username |
与您的厂贵罢笔服务器关联的用户名。 |
auth.params.password |
与您的厂贵罢笔服务器关联的密码。 |
auth.params.maxConcurrentConnections |
将Experience Platform连接到SFTP时指定的最大并发连接数。 启用时，该值必须设置为至少1。 |
auth.params.folderPath |
要提供访问权限的文件夹的路径。 |
auth.params.disableChunking |
一个布尔值，用于确定厂贵罢笔服务器是否支持分块。 |
connectionSpec.id |
厂贵罢笔服务器连接规范滨顿： b7bf2577-4520-42c9-bae9-cad01560f7bc |
|
| accordion |
| 响应 |
|
成功的响应返回新创建连接的唯一标识符(id)。 请在下一教程中探究您的SFTP服务器时，需要此ID。
| code language-json |
{
"id": "bf367b0d-3d9b-4060-b67b-0d3d9bd06094",
"etag": "\"1700cc7b-0000-0200-0000-5e3b3fba0000\""
}
|
|
厂厂贬公钥身份验证
| accordion |
| 请求 |
| code language-shell |
curl -X POST \
'https://platform.adobe.io/data/foundation/flowservice/connections' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-H 'Content-Type: application/json' \
-d '{
"name": "SFTP connector with SSH authentication",
"description": "SFTP connector with SSH authentication",
"auth": {
"specName": "SSH PublicKey Authentication for sftp",
"params": {
"host": "{HOST}",
"port": 22,
"userName": "{USERNAME}",
"privateKeyContent": "{PRIVATE_KEY_CONTENT}",
"passPhrase": "{PASSPHRASE}",
"maxConcurrentConnections": 5,
"folderPath": "acme/business/customers/holidaySales",
"disableChunking": "true"
}
},
"connectionSpec": {
"id": "b7bf2577-4520-42c9-bae9-cad01560f7bc",
"version": "1.0"
}
}'
|
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 |
|
| 属性 |
描述 |
auth.params.host |
厂贵罢笔服务器的主机名。 |
auth.params.port |
SFTP服务器的端口。 此整数值默认为22。 |
auth.params.username |
与您的厂贵罢笔服务器关联的用户名。 |
auth.params.privateKeyContent |
Base64编码的SSH私钥内容。 OpenSSH密钥类型必须分类为RSA或DSA。 |
auth.params.passPhrase |
如果密钥文件或密钥内容受密码词组保护，则使用密码词组或密码解密私钥。 如果PrivateKeyContent受密码保护，则此参数需要与PrivateKeyContent的密码短语（值）一起使用。 |
auth.params.maxConcurrentConnections |
将Experience Platform连接到SFTP时指定的最大并发连接数。 启用时，该值必须设置为至少1。 |
auth.params.folderPath |
要提供访问权限的文件夹的路径。 |
auth.params.disableChunking |
一个布尔值，用于确定厂贵罢笔服务器是否支持分块。 |
connectionSpec.id |
厂贵罢笔服务器连接规范滨顿： b7bf2577-4520-42c9-bae9-cad01560f7bc |
|
| accordion |
| 响应 |
|
成功的响应返回新创建连接的唯一标识符(id)。 请在下一教程中探究您的SFTP服务器时，需要此ID。
| code language-json |
{
"id": "bf367b0d-3d9b-4060-b67b-0d3d9bd06094",
"etag": "\"1700cc7b-0000-0200-0000-5e3b3fba0000\""
}
|
|