SFTP连接器

Last update: Tue Jun 24 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：

创建对象：

开发人员

Adobe Experience Platform允许从外部源摄取数据，同时让您能够使用Experience Platform服务来构建、标记和增强传入数据。您可以从各种源(如Adobe应用程序、基于云的存储、数据库和许多其他源)中摄取数据。

请阅读本文档，了解成功将SFTP帐户连接到Experience Platform所需的先决步骤。

TIP

在连接之前，必须在SFTP服务器配置中禁用键盘交互式身份验证。禁用设置将允许手动输入密码，而不是通过服务或程序输入。

先决条件 prerequisites

请阅读本节内容，了解成功将SFTP源连接到Experience Platform所必须完成的先决步骤。

IP地址允许列表

在使用源连接器之前，必须将IP地址列表添加到允许列表。未能将特定于地区的IP地址添加到允许列表中，可能会导致使用源时出现错误或性能不佳。列入允许列表有关详细信息，请参阅IP地址页。

文件和目录的命名约束

以下是命名云存储文件或目录时必须考虑的约束列表。

目录和文件组件名称不能超过255个字符。
目录和文件名不能以正斜杠(/)结尾。如果提供，它将自动删除。
以下保留URL字符必须正确转义： ! ' ( ) ; @ & = + $ , % # [ ]
不允许使用以下字符： " \ / : | < > * ?。
不允许使用非法的URL路径字符。诸如\uE000之类的代码点虽然在NTFS文件名中有效，但不是有效的Unicode字符。此外，不允许使用某些ASCII或Unicode字符，如控制字符（0x00到0x1F、\u0081等）。有关HTTP/1.1中Unicode字符串的规则，请参阅RFC 2616，第2.2节：基本规则和RFC 3987。
不允许使用以下文件名：LPT1、LPT2、LPT3、LPT4、LPT5、LPT6、LPT7、LPT8、LPT9、COM1、COM2、COM3、COM4、COM5、COM6、COM7、COM8、COM9、PRN、AUX、NUL、CON、CLOCK$、点字符(.)和两个点字符(…)。

为SFTP设置Base64编码的OpenSSH私钥

SFTP源支持使用Base64编码的OpenSSH私钥进行身份验证。有关如何生成Base64编码的OpenSSH私钥并将SFTP连接到Experience Platform的信息，请参阅以下步骤。

Windows

Windows用户

如果您使用的是Windows计算机，请打开开始菜单，然后选择设置。

从出现的设置菜单中，选择 应用程序。

个应用

接下来，选择 可选功能。

可选功能

将显示可选功能列表。如果您的计算机上已预安装了 OpenSSH客户端，则它将包含在 可选功能 下的 已安装的功能 列表中。

open-ssh

如果未安装，请选择安装，然后打开 Powershell 并运行以下命令来生成私钥：

code language-shell

code language-shell
PS C:\Users\lucy> ssh-keygen -t rsa -m pem Generating public/private rsa key pair. Enter file in which to save the key (C:\Users\lucy/.ssh/id_rsa): Enter passphrase (empty for no passphrase): Enter same passphrase again: Your identification has been saved in C:\Users\lucy/.ssh/id_rsa. Your public key has been saved in C:\Users\lucy/.ssh/id_rsa.pub. The key fingerprint is: SHA256:osJ6Lg0TqK8nekNQyZGMoYwfyxNc+Wh0hYBtBylXuGk lucy@LAPTOP-FUJT1JEC The key's randomart image is: +---[RSA 3072]----+ \|.=.+B.o. \| \|=.O.O + \| \|+o+= B \| \|+o +E . \| \|.o=o . S \| \|+... . . \| \| o . \| \|o.B. \| \|=O.. \| +----[SHA256]-----+

PS C:\Users\lucy> ssh-keygen -t rsa -m pem
Generating public/private rsa key pair.
Enter file in which to save the key (C:\Users\lucy/.ssh/id_rsa):
Enter passphrase (empty for no passphrase):
Enter same passphrase again:
Your identification has been saved in C:\Users\lucy/.ssh/id_rsa.
Your public key has been saved in C:\Users\lucy/.ssh/id_rsa.pub.
The key fingerprint is:
SHA256:osJ6Lg0TqK8nekNQyZGMoYwfyxNc+Wh0hYBtBylXuGk lucy@LAPTOP-FUJT1JEC
The key's randomart image is:
+---[RSA 3072]----+
|.=.*+B.o.        |
|=.O.O +          |
|+o+= B           |
|+o +E .          |
|.o=o  . S        |
|+... . .         |
| *o .            |
|o.B.             |
|=O..             |
+----[SHA256]-----+

接下来，在提供私钥的文件路径时运行以下命令，以在Base64中编码您的私钥：

code language-shell
`C:\Users\lucy> [convert]::ToBase64String((Get-Content -path "C:\Users\lucy\.ssh\id_rsa" -Encoding byte)) > C:\Users\lucy\.ssh\id_rsa_base64`

上述命令将Base64编码的私钥保存在您指定的文件路径中。然后，您可以使用该私钥对SFTP进行身份验证并连接到Experience Platform。

Mac

Mac用户

如果您使用的是Mac，请打开终端并运行以下命令来生成私钥（在这种情况下，私钥将保存在/Documents/id_rsa中）：

code language-shell

code language-shell
ssh-keygen -t rsa -m pem -f ~/Documents/id_rsa Generating public/private rsa key pair. Enter passphrase (empty for no passphrase): Enter same passphrase again: Your identification has been saved in /Users/vrana/Documents/id_rsa. Your public key has been saved in /Users/vrana/Documents/id_rsa.pub. The key fingerprint is: SHA256:s49PCaO4a0Ee8I7OOeSyhQAGc+pSUQnRii9+5S7pp1M vrana@vrana-macOS The key's randomart image is: +---[RSA 2048]----+ \|o ==.. \| \|.+..o \| \|oo.+ \| \|=.. + \| \|oo = . S \| \|+.+ +E . = . \| \|o.... . o \| \|.o*=.+ + \| \|.oo=Oo ..o \| +----[SHA256]-----+

ssh-keygen -t rsa -m pem -f ~/Documents/id_rsa
Generating public/private rsa key pair.
Enter passphrase (empty for no passphrase):
Enter same passphrase again:
Your identification has been saved in /Users/vrana/Documents/id_rsa.
Your public key has been saved in /Users/vrana/Documents/id_rsa.pub.
The key fingerprint is:
SHA256:s49PCaO4a0Ee8I7OOeSyhQAGc+pSUQnRii9+5S7pp1M vrana@vrana-macOS
The key's randomart image is:
+---[RSA 2048]----+
|o ==..           |
|.+..o            |
|oo.+             |
|=.. +            |
|oo = .  S        |
|+.+ +E . = .     |
|o*..*.. . o      |
|.o*=.+   +       |
|.oo=Oo  ..o      |
+----[SHA256]-----+

接下来，运行以下命令以在Base64中编码私钥：

code language-shell

code language-shell
base64 ~/Documents/id_rsa > ~/Documents/id_rsa_base64 # Print Content of base64 encoded file cat ~/Documents/id_rsa_base64 LS0tLS1CRUdJTiBPUEVOU1NIIFBSSVZBVEUgS0VZLS0tLS0KYjNCbGJuTnphQzFyWlhrdGRqRUFBQUFBQkc1dmJtVUFBQUFFYm05dVpRQUFBQUFBQUFBQkFBQUJGd0FBQUFkemMyZ3RjbgpOaEFBQUFBd0VBQVFBQUFRRUF0cWFYczlXOUF1ZmtWazUwSXpwNXNLTDlOMU9VYklaYXVxbVM0Q0ZaenI1NjNxUGFuN244CmFxZWdvQTlCZnVnWDJsTVpGSFl5elEzbnp6NXdXMkdZa1hkdjFjakd0elVyNyt1NnBUeWRneGxrOGRXZWZsSzBpUlpYWW4KVFRwS0E5c2xXaHhjTXg3R2x5ejdGeDhWSzI3MmdNSzNqY1d1Q0VIU3lLSFR5SFFwekw0MEVKbGZJY1RGR1h1dW1LQjI5SwpEakhwT1grSDdGcG5Gd1pabTA4Uzc2UHJveTVaMndFalcyd1lYcTlyUDFhL0E4ejFoM1ZLdllzcG53c2tCcHFQSkQ1V3haCjczZ3M2OG9sVllIdnhWajNjS3ZsRlFqQlVFNWRNUnB2M0I5QWZ0SWlrYmNJeUNDaXV3UnJmbHk5eVNPQ2VlSEc0Z2tUcGwKL3V4YXNOT0h1d0FBQThqNnF6R1YrcXN4bFFBQUFBZHpjMmd0Y25OaEFBQUJBUUMycHBlejFiMEM1K1JXVG5Rak9ubXdvdgowM1U1UnNobHE2cVpMZ0lWbk92bnJlbzlxZnVmeHFwNkNnRDBGKzZCZmFVeGtVZGpMTkRlZlBQbkJiWVppUmQyL1Z5TWEzCk5TdnY2N3FsUEoyREdXVHgxWjUrVXJTSkZsZGlkTk9rb0QyeVZhSEZ3ekhzYVhMUHNYSHhVcmJ2YUF3cmVOeGE0SVFkTEkKb2RQSWRDbk12alFRbVY4aHhNVVplNjZZb0hiMG9PTWVrNWY0ZnNXbWNYQmxtYlR4THZvK3VqTGxuYkFTTmJiQmhlcjJzLwpWcjhEelBXSGRVcTlpeW1mQ3lRR21vOGtQbGJGbnZlQ3pyeWlWVmdlL0ZXUGR3cStVVkNNRlFUbDB4R20vY0gwQiswaUtSCnR3aklJS0s3Qkd0K1hMM0pJNEo1NGNiaUNST21YKzdGcXcwNGU3QUFBQUF3RUFBUUFBQVFBcGs0WllzMENSRnNRTk9WS0sKYWxjazlCVDdzUlRLRjFNenhrSGVydmpJYk9kL0lvRXpkcHlVa28rbm41RmpGK1hHRnNCUXZnOFdTaUlJTk1oU3BNYWI1agpvWXlka2gvd0ovWElOaDlZaE5QVXlURi9NNkFnMkNYd21KS2RxN1VKWjZyNjloV3V0VVN6U05QbkVYWTZLc29GeVUwTEFvCko0OHJMT1pMZldtMHFhWDBLNUgzNmJPaHFXSWJwMDNoZk94eno5M0MrSDM5MFJkRkp4bzJVZ0FVY3UvdHREb0REVldBdmEKVkVyMWEzak9LenVHbThrK21WeXpPZERjVFY4ckZIT0pwRnRBU3l6Q24yVld1MjV0TWtrcGRPRjNKcVdMZHdOY3loeG1URApXZGVDNWh4V0Fiano0WDZ5WXpHcFcwTmptVkFoWUVVZGNBSVlXWWM3OGEvQkFBQUFnRm8wakl4aGhwZkJ6QjF6b09FMDJBClpjTC9hcUNuYysrdmJ1a2V0aFg5Zzhlb0xQMTQyeUgzdlpLczl3c1RtbVVsZ0prZURaN2hUcklwOGY2eEwzdDRlMXByY1kKb2ZLd0gwckNGOTFyaldPbGZOUmxEempoR1NTTEVMczZoNlNzMEdBQXE2Z0ZQTVF2dTB4TDlQUTlGQ21YZVVKazJpRm1MWgpEWWJGc0NyVUxEQUFBQWdRRGF0a1pMamJaSTBFM0ZuY2dTOVF5Y3lVWmtkZ1dVNjBQcG9ud3BMQXdUdHRpOG1EQXE5cHYwClEvUlk1WE9UeGF3VXNHa0tYMjNtV1BYR0grdUlBSzhrelVVM2dGM1dRWGVkTWw4NHVCVFZCTEtUdStvVVAvZmIvMEE0dE0KSE9BSythbXZPMkZuYzFiSmVwd05USTE2cjZXWk9sZWV2ZklJQVpXcEgxVVpIdkVRQUFBSUVBMWNwcStDNUVXSFJwbnVPZQpiNHE4T0tKTlJhSUxIRUN6U0twWlFpZDFhRmJYWlVKUXpIQU85YzhINVZMcjBNUjFkcW1ORkNja2ZsZzI2Y3BEUEl3TjBYCm5HMFBxcmhKbXp0U3ZQZ3NGdkNPallncXF6U0RYUjkxd1JQTEN5cU8zcGMyM2kzZnp2WkhtMGhIdWdoNVJqV0loUlFZVkwKZUpDWHRqM08vY3p1SWdzQUFBQVJkbkpoYm1GQWRuSmhibUV0YldGalQxTUJBZz09Ci0tLS0tRU5EIE9QRU5TU0ggUFJJVkFURSBLRVktLS0tLQo=

base64 ~/Documents/id_rsa > ~/Documents/id_rsa_base64


# Print Content of base64 encoded file
cat ~/Documents/id_rsa_base64
LS0tLS1CRUdJTiBPUEVOU1NIIFBSSVZBVEUgS0VZLS0tLS0KYjNCbGJuTnphQzFyWlhrdGRqRUFBQUFBQkc1dmJtVUFBQUFFYm05dVpRQUFBQUFBQUFBQkFBQUJGd0FBQUFkemMyZ3RjbgpOaEFBQUFBd0VBQVFBQUFRRUF0cWFYczlXOUF1ZmtWazUwSXpwNXNLTDlOMU9VYklaYXVxbVM0Q0ZaenI1NjNxUGFuN244CmFxZWdvQTlCZnVnWDJsTVpGSFl5elEzbnp6NXdXMkdZa1hkdjFjakd0elVyNyt1NnBUeWRneGxrOGRXZWZsSzBpUlpYWW4KVFRwS0E5c2xXaHhjTXg3R2x5ejdGeDhWSzI3MmdNSzNqY1d1Q0VIU3lLSFR5SFFwekw0MEVKbGZJY1RGR1h1dW1LQjI5SwpEakhwT1grSDdGcG5Gd1pabTA4Uzc2UHJveTVaMndFalcyd1lYcTlyUDFhL0E4ejFoM1ZLdllzcG53c2tCcHFQSkQ1V3haCjczZ3M2OG9sVllIdnhWajNjS3ZsRlFqQlVFNWRNUnB2M0I5QWZ0SWlrYmNJeUNDaXV3UnJmbHk5eVNPQ2VlSEc0Z2tUcGwKL3V4YXNOT0h1d0FBQThqNnF6R1YrcXN4bFFBQUFBZHpjMmd0Y25OaEFBQUJBUUMycHBlejFiMEM1K1JXVG5Rak9ubXdvdgowM1U1UnNobHE2cVpMZ0lWbk92bnJlbzlxZnVmeHFwNkNnRDBGKzZCZmFVeGtVZGpMTkRlZlBQbkJiWVppUmQyL1Z5TWEzCk5TdnY2N3FsUEoyREdXVHgxWjUrVXJTSkZsZGlkTk9rb0QyeVZhSEZ3ekhzYVhMUHNYSHhVcmJ2YUF3cmVOeGE0SVFkTEkKb2RQSWRDbk12alFRbVY4aHhNVVplNjZZb0hiMG9PTWVrNWY0ZnNXbWNYQmxtYlR4THZvK3VqTGxuYkFTTmJiQmhlcjJzLwpWcjhEelBXSGRVcTlpeW1mQ3lRR21vOGtQbGJGbnZlQ3pyeWlWVmdlL0ZXUGR3cStVVkNNRlFUbDB4R20vY0gwQiswaUtSCnR3aklJS0s3Qkd0K1hMM0pJNEo1NGNiaUNST21YKzdGcXcwNGU3QUFBQUF3RUFBUUFBQVFBcGs0WllzMENSRnNRTk9WS0sKYWxjazlCVDdzUlRLRjFNenhrSGVydmpJYk9kL0lvRXpkcHlVa28rbm41RmpGK1hHRnNCUXZnOFdTaUlJTk1oU3BNYWI1agpvWXlka2gvd0ovWElOaDlZaE5QVXlURi9NNkFnMkNYd21KS2RxN1VKWjZyNjloV3V0VVN6U05QbkVYWTZLc29GeVUwTEFvCko0OHJMT1pMZldtMHFhWDBLNUgzNmJPaHFXSWJwMDNoZk94eno5M0MrSDM5MFJkRkp4bzJVZ0FVY3UvdHREb0REVldBdmEKVkVyMWEzak9LenVHbThrK21WeXpPZERjVFY4ckZIT0pwRnRBU3l6Q24yVld1MjV0TWtrcGRPRjNKcVdMZHdOY3loeG1URApXZGVDNWh4V0Fiano0WDZ5WXpHcFcwTmptVkFoWUVVZGNBSVlXWWM3OGEvQkFBQUFnRm8wakl4aGhwZkJ6QjF6b09FMDJBClpjTC9hcUNuYysrdmJ1a2V0aFg5Zzhlb0xQMTQyeUgzdlpLczl3c1RtbVVsZ0prZURaN2hUcklwOGY2eEwzdDRlMXByY1kKb2ZLd0gwckNGOTFyaldPbGZOUmxEempoR1NTTEVMczZoNlNzMEdBQXE2Z0ZQTVF2dTB4TDlQUTlGQ21YZVVKazJpRm1MWgpEWWJGc0NyVUxEQUFBQWdRRGF0a1pMamJaSTBFM0ZuY2dTOVF5Y3lVWmtkZ1dVNjBQcG9ud3BMQXdUdHRpOG1EQXE5cHYwClEvUlk1WE9UeGF3VXNHa0tYMjNtV1BYR0grdUlBSzhrelVVM2dGM1dRWGVkTWw4NHVCVFZCTEtUdStvVVAvZmIvMEE0dE0KSE9BSythbXZPMkZuYzFiSmVwd05USTE2cjZXWk9sZWV2ZklJQVpXcEgxVVpIdkVRQUFBSUVBMWNwcStDNUVXSFJwbnVPZQpiNHE4T0tKTlJhSUxIRUN6U0twWlFpZDFhRmJYWlVKUXpIQU85YzhINVZMcjBNUjFkcW1ORkNja2ZsZzI2Y3BEUEl3TjBYCm5HMFBxcmhKbXp0U3ZQZ3NGdkNPallncXF6U0RYUjkxd1JQTEN5cU8zcGMyM2kzZnp2WkhtMGhIdWdoNVJqV0loUlFZVkwKZUpDWHRqM08vY3p1SWdzQUFBQVJkbkpoYm1GQWRuSmhibUV0YldGalQxTUJBZz09Ci0tLS0tRU5EIE9QRU5TU0ggUFJJVkFURSBLRVktLS0tLQo=

将Base64编码的私钥保存到指定的文件夹后，必须将公钥文件的内容添加到SFTP主机授权密钥中的新行。在命令行上运行以下命令：

code language-shell
`cat ~/id_rsa.pub >> ~/.ssh/authorized_keys`

要确认是否正确添加了公钥，您可以在命令行上运行以下命令：

code language-shell
`more ~/.ssh/authorized_keys`

收集所需的凭据 credentials

必须提供以下凭据的值，才能将您的SFTP服务器连接到Experience Platform。

基本身份验证

为以下凭据提供适当的值，以使用基本身份验证对您的SFTP服务器进行身份验证。

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
凭据	描述
`host`	与您的SFTP服务器关联的名称或IP地址。
`port`	您正在连接的SFTP服务器端口。如果未提供，则值默认为`22`。
`username`	有权访问您的SFTP服务器的用户名。
`password`	SFTP服务器的密码。
`maxConcurrentConnections`	利用此参数，可指定Experience Platform在连接到SFTP服务器时将创建的并发连接数的最大限制。必须将此值设置为小于SFTP设置的限制。注意：为现有SFTP帐户启用此设置时，它只影响未来的数据流，而不影响现有的数据流。
`folderPath`	要提供访问权限的文件夹的路径。 SFTP源，您可以提供文件夹路径，以指定用户对所选子文件夹的访问权限。
`disableChunking`	在数据摄取期间，SFTP源可以首先检索文件长度，将文件划分为多个部分，然后并行读取。您可以启用或禁用此值以指定SFTP服务器是否可以检索文件长度或从特定偏移读取数据。
`connectionSpec.id`	（仅限API）连接规范返回源的连接器属性，包括与创建基础连接和源连接相关的身份验证规范。 SFTP的连接规范ID为： `b7bf2577-4520-42c9-bae9-cad01560f7bc`。

SSH公钥身份验证

为以下凭据提供适当的值，以使用SSH公钥身份验证对您的SFTP服务器进行身份验证。

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 10-row-2
凭据	描述
`host`	与您的SFTP服务器关联的名称或IP地址。
`port`	您正在连接的SFTP服务器端口。如果未提供，则值默认为`22`。
`username`	有权访问您的SFTP服务器的用户名。
`password`	SFTP服务器的密码。
`privateKeyContent`	Base64编码的SSH私钥内容。支持的OpenSSH密钥类型为`ed25519`、`RSA`和`DSA`。
`passPhrase`	如果密钥文件或密钥内容受密码词组保护，则使用密码词组或密码解密私钥。如果PrivateKeyContent受密码保护，则此参数需要与PrivateKeyContent的密码短语（值）一起使用。
`maxConcurrentConnections`	利用此参数，可指定Experience Platform在连接到SFTP服务器时将创建的并发连接数的最大限制。必须将此值设置为小于SFTP设置的限制。注意：为现有SFTP帐户启用此设置时，它只影响未来的数据流，而不影响现有的数据流。
`folderPath`	要提供访问权限的文件夹的路径。 SFTP源，您可以提供文件夹路径，以指定用户对所选子文件夹的访问权限。
`disableChunking`	在数据摄取期间，SFTP源可以首先检索文件长度，将文件划分为多个部分，然后并行读取。您可以启用或禁用此值以指定SFTP服务器是否可以检索文件长度或从特定偏移读取数据。
`connectionSpec.id`	（仅限API）连接规范返回源的连接器属性，包括与创建基础连接和源连接相关的身份验证规范。 SFTP的连接规范ID为： `b7bf2577-4520-42c9-bae9-cad01560f7bc`。

将SFTP连接到Experience Platform

以下文档提供了有关如何使用API或用户界面将SFTP服务器连接到Experience Platform的信息：

使用API

使用UI

recommendation-more-help

337b99bb-92fb-42ae-b6b7-c7042161d089