서비스 관리 사용자 문제 해결 Amazon API Gateway 문제 해결 암호화된 Amazon S3 버킷에 대한 정책 문제 해결 인증 문제 해결 관리형 워크플로 문제 해결 워크플로 복호화 문제 해결 Amazon SES 문제 해결 ID 제공자 테스트 문제 해결 SFTP 커넥터의 신뢰할 수 있는 호스트 키 추가 문제 해결 파일 업로드 문제 해결 ResourceNotFound 예외 문제 해결 SFTP 커넥터 문제 해결 AS2 문제 해결

문제 해결 AWS Transfer Family

다음 정보를 사용하면 작업할 때 발생할 수 있는 일반적인 문제를 진단하고 해결하는 데 도움이 AWS Transfer Family됩니다.

Transfer Family의 IAM 관련 문제는 AWS Transfer Family ID 및 액세스 문제 해결를 참조하세요.

서비스 관리 사용자 문제 해결

이 섹션에서는 다음 문제에 대한 가능한 해결 방법을 설명합니다.

주제

Amazon EFS 서비스 관리 사용자 문제 해결
퍼블릭 키 본문이 너무 긴 문제 해결
문제 해결에서 SSH 퍼블릭 키를 추가하지 못했습니다.

Amazon EFS 서비스 관리 사용자 문제 해결

설명

sftp 명령을 실행하면 프롬프트가 나타나지 않고 대신 다음 메시지가 표시됩니다:


Couldn't canonicalize: Permission denied
           Need cwd

원인

AWS Identity and Access Management (IAM) 사용자의 역할에는 Amazon Elastic File System (Amazon EFS) 에 액세스할 수 있는 권한이 없습니다.

솔루션

사용자 역할에 대한 정책 권한을 늘리세요. 와 같은 AWS AmazonElasticFileSystemClientFullAccess 관리형 정책을 추가할 수 있습니다.

퍼블릭 키 본문이 너무 긴 문제 해결

설명

서비스 관리 사용자를 생성하려고 하면 다음 오류가 발생합니다:


Failed to create user (1 validation error detected:
'sshPublicKeyBody' failed to satisfy constraint: Member must have length less than or equal to 2048)

원인

공개 키 본문에는 PGP 키를 입력할 수 있지만 서비스 관리 사용자의 경우 PGP 키를 AWS Transfer Family 지원하지 않을 수 있습니다.

솔루션

PGP 키가 RSA 기반인 경우, 귀하는 그것을 PEM 형식으로 변환할 수 있습니다. 예를 들어, Ubuntu는 다음과 같은 변환 도구를 제공합니다: https://manpages.ubuntu.com/manpages/xenial/man1/openpgp2ssh.1.html

문제 해결에서 SSH 퍼블릭 키를 추가하지 못했습니다.

설명

서비스 관리 사용자에 대한 퍼블릭 키를 추가하려고 하면 다음 오류가 발생합니다:


Failed to add SSH public key (Unsupported or invalid SSH public key format)

원인

SSH2 형식의 공개 키를 가져오려고 할 수 있지만 서비스 관리 사용자를 위한 SSH2 형식의 공개 키는 지원되지 않습니다. AWS Transfer Family

솔루션

키를 OpenSSH 형식으로 변환해야 합니다. 이 과정은 SSH2 퍼블릭 키를 PEM 형식으로 변환에 설명되어 있습니다.

Amazon API Gateway 문제 해결

이 섹션에서는 다음과 같은 API Gateway 문제에 대한 가능한 해결 방법을 설명합니다.

주제

인증 오류가 너무 많음
연결 종료

인증 오류가 너무 많음

설명

SSH(Secure Shell) 파일 전송 프로토콜(SFTP)을 사용하여 서버에 연결하려고 하면 다음 오류가 발생합니다.


Received disconnect from 3.15.127.197 port 22:2: Too many authentication failures
Authentication failed.
Couldn't read packet: Connection reset by peer

원인

잘못된 데이터베이스 사용자 암호를 입력했을 수 있습니다. 올바른 암호를 다시 입력해 보세요.

암호가 올바르면 유효하지 않은 Amazon 리소스 이름(ARN) 역할이 문제의 원인일 수 있습니다. 이것이 문제인지 확인하려면 서버의 ID 공급자를 테스트하세요. 다음과 비슷한 응답이 표시되는 경우 역할 ARN은 자리 표시자일 뿐이며 역할 ID 값이 모두 0인 것으로 표시됩니다:


{
    "Response": "{\"Role\": \"arn:aws:iam::000000000000:role/MyUserS3AccessRole\",\"HomeDirectory\": \"/\"}",
    "StatusCode": 200,
    "Message": "",
    "Url": "https://api-gateway-ID.execute-api.us-east-1.amazonaws.com/prod/servers/transfer-server-ID/users/myuser/config"
}

솔루션

자리 표시자 역할 ARN을 서버 액세스 권한이 있는 실제 역할로 교체하세요.

역할을 업데이트하려면

https://console.aws.amazon.com/cloudformation 에서 AWS CloudFormation 콘솔을 엽니다.
왼쪽 탐색 창에서 스택을 선택합니다.
스택 목록에서 스택을 선택한 다음 파라미터 탭을 선택합니다.
업데이트를 선택합니다. 업데이트 스택 페이지에서 현재 템플릿 사용을 선택하고 다음을 선택합니다.
Transfer Family 서버에 액세스할 수 있는 충분한 권한이 있는 역할 UserRoleArnARN으로 바꾸십시오.

참고
필요한 권한을 부여하려면 AmazonAPIGatewayAdministrator 및 AmazonS3FullAccess 관리형 정책을 역할에 추가할 수 있습니다.
다음을 선택하고 다시 다음을 선택합니다. 스택 검토 페이지에서 IAM 리소스를 생성할 AWS CloudFormation 수 있음을 인정함을 선택한 다음 Update stack (스택 업데이트) 을 선택합니다.

연결 종료

설명

SSH(Secure Shell) 파일 전송 프로토콜(SFTP)을 사용하여 서버에 연결하려고 하면 다음 오류가 발생합니다.


Connection closed

원인

이 문제의 한 가지 가능한 원인은 Amazon CloudWatch 로깅 역할이 Transfer Family와 신뢰 관계를 맺고 있지 않기 때문입니다.

솔루션

서버의 로깅 역할이 Transfer Family와 신뢰 관계를 맺고 있는지 확인하세요. 자세한 내용은 신뢰 관계를 구축하기 위해를 참조하세요.

암호화된 Amazon S3 버킷에 대한 정책 문제 해결

설명

Transfer Family 서버의 스토리지로 사용하고 있는 암호화된 Amazon S3 버킷이 있습니다. 서버에 파일을 업로드하려고 하면 오류 Couldn't close file: Permission denied가 발생합니다.

그리고 서버 로그를 보면 다음과 같은 오류가 표시됩니다:


ERROR Message="Access denied" Operation=CLOSE Path=/bucket/user/test.txt BytesIn=13
ERROR Message="Access denied"

원인

IAM 사용자에 대한 정책에는 암호화된 버킷에 액세스할 권한이 없습니다.

솔루션

요구되는 AWS Key Management Service (AWS KMS) 권한을 부여하려면 정책에 추가 권한을 지정해야 합니다. 자세한 내용은 Amazon S3의 데이터 암호화를 참조하세요.

인증 문제 해결

이 섹션에서는 다음 인증 문제에 대한 가능한 해결 방법을 설명합니다.

주제

인증 실패—SSH/SFTP
관리형 AD 불일치 영역 문제
기타 인증 문제

인증 실패—SSH/SFTP

설명

SSH(Secure Shell) 파일 전송 프로토콜(SFTP)을 사용하여 서버에 연결하려고 하면 다음과 비슷한 메시지가 나타납니다:


Received disconnect from 3.130.115.105 port 22:2: Too many authentication failures
  Authentication failed.

참고

API Gateway를 사용 중이고 이 오류가 발생하는 경우 인증 오류가 너무 많음를 참조하세요.

원인

사용자에 대한 RSA 키 쌍을 추가하지 않았으므로 대신 암호를 사용하여 인증해야 합니다.

솔루션

sftp 명령은 -o PubkeyAuthentication=no 옵션을 지정할 때 실행됩니다. 이 옵션을 선택하면 시스템에서 강제로 암호를 요청합니다. 예:


sftp -o PubkeyAuthentication=no sftp-user@server-id.server.transfer.region-id.amazonaws.com

관리형 AD 불일치 영역 문제

설명

사용자의 영역과 그룹 영역이 일치해야 합니다. 둘 다 기본 영역에 있거나 둘 다 신뢰할 수 있는 영역에 있어야 합니다.

원인

사용자와 그룹이 일치하지 않는 경우 Transfer Family에서 사용자를 인증할 수 없습니다. 사용자의 ID 공급자를 테스트하면 사용자 그룹에 연결된 액세스 권한을 찾을 수 없음이라는 오류 메시지가 표시됩니다.

솔루션

사용자 영역에서 그룹 영역(기본값 또는 신뢰할 수 있음)과 일치하는 그룹을 참조합니다.

기타 인증 문제

설명

인증 오류가 발생했지만 다른 문제 해결은 작동하지 않습니다.

원인

선행 또는 후행 슬래시(/) 가 포함된 논리 디렉터리의 대상을 지정했을 수 있습니다.

솔루션

논리적 디렉터리 대상을 업데이트하여 슬래시로 시작하고 후행 슬래시를 포함하지 않도록 하세요. 예를 들어 /DOC-EXAMPLE-BUCKET/images 는 허용되지만 DOC-EXAMPLE-BUCKET/images 허용되지는 않습니다. /DOC-EXAMPLE-BUCKET/images/

관리형 워크플로 문제 해결

이 섹션에서는 다음과 같은 워크플로우 문제에 대한 가능한 해결 방법을 설명합니다.

주제

Amazon을 사용하여 워크플로 관련 오류 문제 해결 CloudWatch
워크플로 복사 오류 문제 해결

Amazon을 사용하여 워크플로 관련 오류 문제 해결 CloudWatch

설명

워크플로에 문제가 있는 경우 Amazon을 사용하여 원인을 CloudWatch 조사할 수 있습니다.

원인

원인은 여러 가지가 있을 수 있습니다. Amazon CloudWatch Logs를 사용하여 조사하십시오.

솔루션

Transfer Family는 워크플로우 실행 상태를 CloudWatch 로그로 내보냅니다. CloudWatch 로그에는 다음과 같은 유형의 워크플로 오류가 나타날 수 있습니다.

"type": "StepErrored"
"type": "ExecutionErrored"
"type": "ExecutionThrottled"
"Service failure on starting workflow"

다양한 필터 및 패턴 구문을 사용하여 워크플로의 실행 로그를 필터링할 수 있습니다. 예를 들어, 로그에 로그 필터를 생성하여 ExecutionErrored메시지가 포함된 워크플로 실행 로그를 캡처할 수 있습니다. CloudWatch 자세한 내용은 Amazon CloudWatch Logs 사용 설명서의 구독을 통한 로그 데이터의 실시간 처리 및 필터 및 패턴 구문을 참조하십시오.

StepErrored


2021-10-29T12:57:26.272-05:00
            {"type":"StepErrored","details":{"errorType":"BAD_REQUEST","errorMessage":"Cannot
            tag Efs file","stepType":"TAG","stepName":"successful_tag_step"},
            "workflowId":"w-abcdef01234567890","executionId":"1234abcd-56ef-78gh-90ij-1234klmno567",
            "transferDetails":{"serverId":"s-1234567890abcdef0","username":"lhr","sessionId":"1234567890abcdef0"}

여기서 StepErrored는 워크플로 내의 한 단계에서 오류가 발생했음을 나타냅니다. 단일 워크플로에서 여러 단계를 구성할 수 있습니다. 이 오류는 오류가 발생한 단계를 알려주고 오류 메시지를 제공합니다. 이 특정 예에서는 파일에 태그를 지정하도록 단계를 구성했지만 Amazon EFS 파일 시스템에서 파일에 태그를 지정하는 것은 지원되지 않으므로 단계에서 오류가 발생했습니다.

ExecutionErrored


2021-10-29T12:57:26.618-05:00
            {"type":"ExecutionErrored","details":{},"workflowId":"w-w-abcdef01234567890",
            "executionId":"1234abcd-56ef-78gh-90ij-1234klmno567","transferDetails":{"serverId":"s-1234567890abcdef0",
            "username":"lhr","sessionId":"1234567890abcdef0"}}

워크플로에서 어떤 단계도 실행할 수 없는 경우 ExecutionErrored 메시지가 생성됩니다. 예를 들어, 특정 워크플로에서 단일 단계를 구성했는데 해당 단계를 실행할 수 없는 경우 전체 워크플로가 실패합니다.

Executionthrottled

시스템에서 지원할 수 있는 속도보다 빠른 속도로 워크플로가 트리거되면 실행이 제한됩니다. 이 로그 메시지는 워크플로의 실행 속도를 늦춰야 함을 나타냅니다. 워크플로 실행 속도를 줄일 수 없는 경우 Contact로 문의하십시오. AWS SupportAWS

워크플로 시작 시 서비스 실패

서버에서 워크플로를 제거하고 새 워크플로로 바꾸거나 워크플로의 실행 역할에 영향을 미치는 서버 구성을 업데이트할 때마다 새 워크플로를 실행하기 전에 약 10분을 기다려야 합니다. Transfer Family 서버는 워크플로 세부 정보를 캐시하며 서버가 캐시를 새로 고치는 데 10분이 걸립니다.

또한 활성 SFTP 세션에서 로그아웃한 다음 10분 대기 시간이 지난 후 다시 로그인해야 변경 사항을 확인할 수 있습니다.

워크플로 복사 오류 문제 해결

설명

업로드된 파일을 복사하는 단계가 포함된 워크플로를 실행하는 경우 다음 오류가 발생할 수 있습니다:


{
  "type": "StepErrored", "details": {
    "errorType": "BAD_REQUEST", "errorMessage": "Bad Request (Service: Amazon S3; Status Code: 400; Error Code: 400 Bad Request;
    Request ID: request-ID; S3 Extended Request ID: request-ID Proxy: null)", "stepType": "COPY", "stepName": "copy-step-name" },
  "workflowId": "workflow-ID",
  "executionId": "execution-ID",
  "transferDetails": {
     "serverId": "server-ID",
     "username": "user-name",
     "sessionId": "session-ID"
  }
}

원인

원본 파일은 대상 버킷과 AWS 리전 다른 Amazon S3 버킷에 있습니다.

솔루션

복사 단계가 포함된 워크플로를 실행하는 경우, 소스 버킷과 목적지 버킷이 동일한 AWS 리전안에 있는지 확인하세요.

워크플로 복호화 문제 해결

이 섹션에서는 암호화된 워크플로와 관련된 다음과 같은 문제에 대한 가능한 해결책을 설명합니다.

주제

서명된 암호화 파일의 오류 문제 해결
FIPS 알고리즘의 오류 문제 해결

서명된 암호화 파일의 오류 문제 해결

설명

암호 해독 워크플로가 실패하고 다음과 같은 오류 메시지가 나타납니다.


"Encrypted file with signed message unsupported"

원인

Transfer Family는 현재 암호화된 파일에 대한 서명을 지원하지 않습니다.

솔루션

PGP 클라이언트에서 암호화된 파일에 서명하는 옵션이 있는 경우 선택을 취소해야 합니다. Transfer Family는 현재 암호화된 파일에 대한 서명을 지원하지 않기 때문입니다.

FIPS 알고리즘의 오류 문제 해결

설명

복호화 워크플로가 실패하고 로그 메시지가 다음과 비슷합니다:


{
   "type": "StepErrored",
   "details": {
      "errorType": "BAD_REQUEST",
      "errorMessage": "File encryption algorithm not supported with FIPS mode enabled.",
      "stepType": "DECRYPT",
      "stepName": "step-name"
   },
   "workflowId": "workflow-ID",
   "executionId": "execution-ID",
   "transferDetails": {
      "serverId": "server-ID",
      "username": "user-name",
      "sessionId": "session-ID"
   }
}

원인

Transfer Family 서버에는 FIPS 모드가 활성화되어 있으며 관련 복호화 워크플로 단계가 있습니다. Transfer Family 서버에 업로드하기 전에 파일을 암호화하는 경우 암호화 클라이언트는 FIPS에서 승인하지 않은 대칭 암호화 알고리즘을 사용하는 암호화된 파일을 생성할 수 있습니다. 이러한 시나리오에서는 워크플로에서 파일을 해독할 수 없습니다. 다음 예에서 GnuPG 버전 2.4.0은 OCB (비 FIPS 블록 암호 모드) 를 사용하여 파일을 암호화합니다: 이로 인해 워크플로가 실패합니다.

솔루션

파일을 암호화하는 데 사용한 GPG 키를 편집한 다음 다시 암호화해야 합니다. 다음 절차는 취해야 하는 단계를 설명합니다.

PGP 키를 편집하려면

gpg ‐‐list-keys를 실행하여 편집해야 하는 키를 식별합니다.

그러면 키 목록이 반환됩니다. 각 키에는 다음과 유사한 세부 정보가 있습니다.
```
pub   ed25519 2022-07-07 [SC]
      wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
uid           [ultimate] Mary Major <marymajor@example.com>
sub   cv25519 2022-07-07 [E]
```
편집할 키를 식별합니다. 이전 단계에 표시된 예에서 ID는 wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY입니다.
gpg ‐‐edit-key wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY를 실행합니다.

시스템은 GnuPG 프로그램 및 지정된 키에 대한 세부 정보로 응답합니다.

gpg> 프롬프트에서 showpref를 입력합니다. 다음과 같은 세부 정보가 반환됩니다:


[ultimate] (1). Mary Major <marymajor@example.com>
   Cipher: AES256, AES192, AES, 3DES
   AEAD: OCB
   Digest: SHA512, SHA384, SHA256, SHA224, SHA1
   Compression: ZLIB, BZIP2, ZIP, Uncompressed
   Features: MDC, AEAD, Keyserver no-modify

참고로, 키에 저장된 선호 알고리즘이 나열되어 있습니다.

OCB를 제외한 모든 알고리즘을 유지하도록 키를 편집하려고 합니다. setpref 명령을 실행하여 유지할 모든 알고리즘을 지정합니다:


gpg> setpref AES256, AES192,AES,3DES,SHA512, SHA384, SHA256, SHA224, SHA1,ZLIB, BZIP2, ZIP, Uncompressed

그러면 다음 세부 사항이 반환됩니다:


Set preference list to:
     Cipher: AES256, AES192, AES, 3DES
     AEAD: 
     Digest: SHA512, SHA384, SHA256, SHA224, SHA1
     Compression: ZLIB, BZIP2, ZIP, Uncompressed
     Features: MDC, Keyserver no-modify
Really update the preferences? (y/N)

y를 입력하여 업데이트한 다음, 변경을 확인하라는 메시지가 표시되면 암호를 입력합니다.
변경 사항을 저장합니다.
```
gpg> save
```

복호화 워크플로를 다시 실행하기 전에 편집한 키를 사용하여 파일을 다시 암호화해야 합니다.

Amazon SES 문제 해결

이 섹션에서는 다음과 같은 Amazon EFS 문제에 대한 가능한 해결 방법을 설명합니다.

주제

누락된 POSIX 프로필 문제 해결
Amazon EFS로 논리적 디렉터리 문제 해결

누락된 POSIX 프로필 문제 해결

설명

서버에 Amazon EFS 스토리지를 사용하고 사용자 지정 ID 공급자를 사용하는 경우 AWS Lambda 함수에 POSIX 프로필을 제공해야 합니다.

원인

한 가지 가능한 원인은 AWS Lambda지원 Amazon API Gateway 메서드를 생성하기 위해 제공하는 템플릿에 현재 POSIX 정보가 포함되어 있지 않기 때문입니다.

POSIX 정보를 제공한 경우 POSIX 정보를 제공하는 데 사용한 형식이 Transfer Family에서 올바르게 파싱되지 않을 수 있습니다.

솔루션

Transfer Family에 PosixProfile 파라미터에 대한 JSON 요소를 제공하고 있는지 확인하세요.

예를 들어, Python을 사용하는 경우 PosixProfile 파라미터를 파싱하는 위치에 다음 줄을 추가할 수 있습니다.


if PosixProfile: 
        response_data["PosixProfile"] = json.loads(PosixProfile)

또는 에서 JavaScript 다음 줄을 추가할 수 있습니다. 여기서 uid-value 및 gid-value 는 각각 사용자 ID (UID) 와 그룹 ID (GID) 를 나타내는 0 이상의 정수입니다.


PosixProfile: {"Uid": uid-value, "Gid": gid-value},

이 코드 예는 PosixProfile 파라미터를 문자열이 아닌 JSON 객체로 Transfer Family에 전송합니다.

또한 다음과 AWS Secrets Manager같이 내에 PosixProfile 매개변수를 저장해야 합니다. your-uid와(과) your-gid를 GID 및 UID의 실제 값으로 바꾸세요.


{"Uid": your-uid, "Gid": your-gid, "SecondaryGids": []}

Amazon EFS로 논리적 디렉터리 문제 해결

설명

사용자의 홈 디렉터리가 존재하지 않고 사용자가 ls 명령을 실행하면 시스템은 다음과 같이 응답합니다:


sftp> ls
remote readdir ("/"): No such file or directory

원인

Transfer Family 서버에서 Amazon EFS를 사용하는 경우, 사용자가 논리적 홈 디렉터리에서 작업할 수 있으려면 먼저 읽기 및 쓰기 권한이 있는 사용자의 홈 디렉터리를 생성해야 합니다. 사용자는 논리적 홈 디렉터리 상의 mkdir에 대한 권한이 없기 때문에 이 디렉터리를 직접 만들 수는 없습니다.

솔루션

상위 디렉터리에 대한 관리 액세스 권한이 있는 사용자는 사용자의 논리적 홈 디렉터리를 생성해야 합니다.

ID 제공자 테스트 문제 해결

설명

콘솔 또는 TestIdentityProvider API 호출을 사용하여 ID 공급자를 테스트하는 경우 Response 필드는 비어 있습니다. 예:


{
    "Response": "{}",
    "StatusCode": 200,
    "Message": ""
}

원인

가장 가능성이 높은 원인은 잘못된 사용자 이름이나 암호로 인해 인증이 실패했기 때문입니다.

솔루션

사용자에 대한 올바른 자격 증명을 사용하고 있는지 확인하고 필요한 경우 사용자 이름 또는 암호를 업데이트하세요.

SFTP 커넥터의 신뢰할 수 있는 호스트 키 추가 문제 해결

설명

SFTP 커넥터를 만들거나 편집하고 신뢰할 수 있는 호스트 키를 추가하면 다음 오류 메시지가 나타납니다: Failed to edit connector details (Invalid host key format.)

원인

올바른 퍼블릭 키를 붙여넣으면 키의 comment 일부가 포함된 것이 문제일 수 있습니다. AWS Transfer Family 현재 키의 설명 부분을 수락하지 않습니다.

솔루션

키를 텍스트 필드에 붙여넣을 때 키의 설명 부분을 삭제하세요. 예를 들어, 키는 다음과 비슷할 것입니다:


ssh-rsa AAAA...== marymajor@dev-dsk-marymajor-1d-c1234567.us-east-1.amazon.com

== 문자 뒤에 오는 텍스트를 제거하고, 키에서 == 문자 앞까지 오는 부분만 붙여넣습니다.


ssh-rsa AAAA...==

파일 업로드 문제 해결

이 섹션에서는 다음과 같은 파일 업로드 문제에 대한 가능한 해결 방법을 설명합니다.

주제

Amazon S3 파일 업로드 오류 문제 해결
읽을 수 없는 파일 명칭 문제 해결

Amazon S3 파일 업로드 오류 문제 해결

설명

Transfer Family를 사용하여 Amazon S3 스토리지에 파일을 업로드하려고 하면 다음과 같은 오류 메시지가 나타납니다: AWS Transfer는 S3 객체에 대한 임의 액세스 쓰기를 지원하지 않음.

원인

Amazon S3를 서버 스토리지로 사용하는 경우 Transfer Family는 단일 전송에 대한 복수 연결을 지원하지 않습니다.

솔루션

Transfer Family 서버가 Amazon S3를 스토리지로 사용하는 경우 단일 전송에 복수 연결을 사용한다고 언급하는 클라이언트 소프트웨어 옵션을 비활성화하세요.

읽을 수 없는 파일 명칭 문제 해결

설명

업로드한 파일 중 일부에 손상된 파일 명칭이 있습니다. FTP 및 SFTP 전송 시 움라우트, 악센트 부호가 있는 글자 또는 중국어나 아랍어와 같은 특정 스크립트 등 파일 명칭의 특정 문자가 제대로 표시되지 않는 문제가 발생하는 경우가 있습니다.

원인

FTP 및 SFTP 프로토콜을 사용하면 클라이언트가 파일 명칭의 문자 인코딩을 협상할 수 있지만 Amazon S3와 Amazon EFS는 그렇지 않습니다. 대신 UTF-8 문자 인코딩이 필요합니다. 따라서 특정 문자가 제대로 렌더링되지 않습니다.

솔루션

이 문제를 해결하려면 클라이언트 응용 프로그램에서 파일 명칭 문자 인코딩을 검토하고 해당 인코딩이 UTF-8 로 설정되어 있는지 확인하세요.

`ResourceNotFound` 예외 문제 해결

설명

리소스를 찾을 수 없는 오류가 발생합니다. 예를 들어 UpdateServer를 실행하면 다음과 같은 오류가 발생할 수 있습니다:


An error occurred (ResourceNotFoundException) when calling the UpdateServer operation: Unknown server

원인

ResourceNotFoundException메시지를 받는 데에는 여러 가지 이유가 있습니다. 대부분의 경우 API 명령에 지정한 리소스가 존재하지 않습니다. 기존 리소스를 지정한 경우 가장 가능성이 높은 원인은 기본 지역이 리소스의 지역과 다르기 때문입니다. 예를 들어 기본 지역이 us-east-1이고 Transfer Family 서버가 us-east-2에 있는 경우 알 수 없는 리소스 예외가 발생합니다.

기본 지역 설정에 대한 자세한 설명은 aws configure를 통한 빠른 구성을 참조하세요.

솔루션

API 명령에 지역 파라미터를 추가하여 특정 리소스를 찾을 위치를 명시적으로 지정합니다.


aws transfer -describe-server --server-id server-id --region us-east-2

SFTP 커넥터 문제 해결

이 섹션에서는 다음 SFTP 커넥터 문제의 가능한 해결 방법을 설명합니다.

주제

키 협상이 실패했습니다.
기타 SFTP 커넥터 문제

키 협상이 실패했습니다.

설명

키 교환 협상이 실패하는 오류가 발생합니다. 예:


Key exchange negotiation failed due to incompatible host key algorithms. 
Client offered: [ecdsa-sha2-nistp256, ecdsa-sha2-nistp384,
ecdsa-sha2-nistp521, rsa-sha2-512, rsa-sha2-256] Server offered: [ssh-rsa]

원인

이 오류는 서버에서 지원하는 호스트 키 알고리즘과 커넥터에서 지원하는 호스트 키 알고리즘이 겹치지 않기 때문입니다.

솔루션

원격 서버가 오류 메시지에 나열된 클라이언트 호스트 키 알고리즘 중 하나 이상을 지원하는지 확인하세요. 지원되는 키 알고리즘 목록은 SFTP AWS Transfer Family 커넥터에 대한 보안 정책 섹션을 참조하세요.

기타 SFTP 커넥터 문제

설명

실행 후 오류가 StartFileTransfer 발생하지만 문제의 원인을 알 수 없으며 API 호출 후 커넥터 ID만 반환됩니다.

원인

이 오류에는 여러 가지 원인이 있을 수 있습니다. 문제를 해결하려면 커넥터를 테스트하고 CloudWatch 로그를 검색하는 것이 좋습니다.

솔루션

커넥터 테스트: 을 참조하십시오SFTP 커넥터를 테스트합니다.. 테스트가 실패하면 시스템은 테스트 실패 이유를 기반으로 오류 메시지를 제공합니다. 이 섹션에서는 콘솔에서 또는 TestConnectionAPI 명령을 사용하여 커넥터를 테스트하는 방법을 설명합니다.
커넥터의 CloudWatch 로그 보기: 을 참조하십시오SFTP 커넥터의 예제 로그 항목. 이 항목에서는 SFTP 커넥터 로그 항목의 예와 적절한 로그를 찾는 데 도움이 되는 명명 규칙을 제공합니다.

AS2 문제 해결

적용성 보고서 2(AS2) 지원 서버의 오류 메시지 및 문제 해결 팁은 다음과 같습니다: AS2 오류 코드.

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

AWS 관리형 정책

API 참조