설명서

잘못된 PEM 형식이 Adobe Commerce에서 키 유효성 검사 오류를 트리거합니다.

Last update: Mon Mar 30 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

Adobe Commerce에서, Commerce 서비스 커넥터에서 Adobe 결제 서비스에 대한 API 키를 구성할 때 키 유효성 검사 오류가 발생합니다. 이러한 오류는 개인 키 PEM(Privacy-Enhanced Mail) 파일의 형식이 올바르지 않은 경우 나타납니다. 이 문제를 해결하려면 Base64 콘텐츠가 머리글 및 바닥글에서 제대로 분리되도록 PEM(Privacy-Enhanced Mail) 파일 형식을 수정하십시오.

설명 description

환경

제품: Adobe Commerce

문제/증상

설치하는 동안 다음과 같은 증상이 발생합니다.

  • 샌드박스 키를 추가할 때 오류 메시지 상태 공개 키가 잘못됨 및 개인 키가 잘못됨.
  • 잘못된 PEM 서식으로 인해 개인 키를 확인하지 못했습니다. 키 콘텐츠가 머리글 또는 바닥글과 같은 줄에 배치됩니다.

해결 방법 resolution

이 문제를 해결하려면 다음 단계를 수행합니다.

  1. 개인 키 PEM 파일의 머리글과 바닥글 사이의 별도 줄에 추가 문자나 선행 공백 없이 Base64 내용이 있는지 확인합니다. 자세한 내용은 Commerce 서비스 커넥터를 참조하세요.

  2. 추가 문자 또는 선행 공백이 있는 경우 아래 샌드박스 개인 키를 사용하여 샌드박스를 정규화할 수 있습니다.

    code language-none 
    awk '
function trim(s){ sub(/[  \t\r\n] +/, "", s); sub(/[  \t\r\n] +$/, "", s); return s }

# BEGIN/END lines: print as-is (trimmed), no extra newlines
/-----BEGIN / { print trim($0); next }
/-----END /   { print trim($0); next }

# Body: remove *all* whitespace then wrap at 64 chars
{
  line = trim($0)
  gsub(/[  \t\r\n] /, "", line)
  while (length(line) > 64) { print substr(line,1,64); line = substr(line,65) }
  if (length(line)) print line
}' <key_incorrect_oneline.pem> > <key_normalized_multiline.pem>

  3. Commerce 서비스 커넥터 구성에 수정된 샌드박스 개인 키를 입력합니다. 자세한 내용은 Commerce 서비스 커넥터를 참조하세요.

  4. 성공하면 정규화된 프로덕션 개인 키로 이 작업을 반복합니다.

  5. Commerce 서비스 커넥터 페이지를 새로 고칩니다.

  6. 커넥터 인터페이스에서 공개 키와 개인 키의 유효성을 다시 확인합니다.

  7. 잘못된 키 오류가 더 이상 나타나지 않는지 확인합니다.

메모

  • 샌드박스와 프로덕션의 공개 키는 변경할 필요가 없습니다.
  • 표준화된 PEM 파일은 표준 PEM 형식 요구 사항(라인당 64자로 래핑된 Base64 데이터)에 따라 제공되거나 생성된 것으로 사용해야 합니다.

관련 읽기

recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f