Flow Service API를 사용하여 SFTP 기본 연결 만들기
기본 연결은 소스와 Adobe Experience Platform 간의 인증된 연결을 나타냅니다.
이 자습서에서는 Flow Service API를 사용하여 SFTP (Secure File Transfer Protocol)에 대한 기본 연결을 만드는 단계를 안내합니다.
시작하기
이 안내서를 사용하려면 Adobe Experience Platform의 다음 구성 요소에 대해 이해하고 있어야 합니다.
다음 섹션에서는 Flow Service API를 사용하여 SFTP 서버에 성공적으로 연결하기 위해 알아야 할 추가 정보를 제공합니다.
필요한 자격 증명 수집
Flow Service이(가) SFTP에 연결하려면 다음 연결 속성에 대한 값을 제공해야 합니다.
host
port
22
입니다.username
password
privateKeyContent
passPhrase
privateKeyContent
이(가) 암호로 보호된 경우 이 매개 변수는 개인 키 콘텐츠의 암호와 함께 값으로 사용해야 합니다.maxConcurrentConnections
folderPath
connectionSpec.id
b7bf2577-4520-42c9-bae9-cad01560f7bc
입니다.Platform API 사용
Platform API를 성공적으로 호출하는 방법에 대한 자세한 내용은 Platform API 시작에 대한 안내서를 참조하십시오.
기본 연결 만들기
기본 연결은 소스의 인증 자격 증명, 연결의 현재 상태 및 고유한 기본 연결 ID를 포함하여 소스와 플랫폼 간에 정보를 유지합니다. 기본 연결 ID를 사용하면 소스 내에서 파일을 탐색 및 탐색하고 데이터 유형 및 형식에 대한 정보를 포함하여 수집할 특정 항목을 식별할 수 있습니다.
SFTP 원본은 기본 인증과 SSH 공개 키를 통한 인증을 모두 지원합니다. 이 단계에서 액세스 권한을 제공할 하위 폴더의 경로를 지정할 수도 있습니다.
기본 연결 ID를 만들려면 SFTP 인증 자격 증명을 요청 매개 변수의 일부로 제공하는 동안 /connections
끝점에 POST 요청을 하십시오.
"-----BEGIN [RSA/DSA] PRIVATE KEY-----"
(으)로 시작되고 "-----END [RSA/DSA] PRIVATE KEY-----"
(으)로 끝나는지 확인하십시오. 개인 키 파일이 PPK 형식 파일인 경우 PuTTY 도구를 사용하여 PPK에서 OpenSSH 형식으로 변환합니다.API 형식
POST /connections
accordion | ||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
요청 | ||||||||||||||||||||
|
accordion | ||
---|---|---|
응답 | ||
성공한 응답은 새로 만든 연결의 고유 식별자(
|
accordion | ||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
요청 | ||||||||||||||||||||||
|
accordion | ||
---|---|---|
응답 | ||
성공한 응답은 새로 만든 연결의 고유 식별자(
|
다음 단계
이 자습서에 따라 Flow Service API를 사용하여 SFTP 연결을 만들고 연결의 고유 ID 값을 얻었습니다. 이 연결 ID를 사용하여 흐름 서비스 API를 사용하여 클라우드 저장소 탐색할 수 있습니다.