Magento 2 연동 문제 해결하기

예상 3 읽은 시간(분)

업데이트 2024년 8월 29일 오후 7:22 EST

아래에 설명된 문제 해결 단계에 따라 Magento 2 OAuth 설정 관련 문제를 해결하는 방법을 알아보세요. 이 단계를 수행한 후에도 문제가 계속 발생하면 커뮤니티 또는 지원팀에 문의하세요.

아직 시작하지 않았다면 Magento 2 시작하기 가이드를 읽고 단계별 지침에 따라 Magento 2 통합을 설정하세요.

클라비요는 OAuth 프로토콜을 사용하여 액세스 토큰을 생성하고 Magento 2 스토어에서 데이터를 검색합니다. Magento 2 설치를 사용자 지정한 경우 클라비요의 OAuth 절차가 실패할 수 있습니다. 이 도움말에서는 장애가 발생하는 위치를 파악하기 위한 일련의 문제 해결 단계를 안내합니다.

일반적인 문제 해결 단계

유효한 SSL 인증서로 사이트에 공개적으로 액세스할 수 있는지 확인합니다.

클라비요의 OAuth 절차를 사용하려면 웹사이트가 공개적으로 액세스할 수 있어야 하며, 그렇지 않으면 액세스 토큰을 생성하는 데 필요한 API 호출이 실패합니다.

스토어에 대한 액세스가 비밀번호로 보호되거나 IP가 제한되어 있지 않은지 확인합니다.
유효한 SSL 인증서를 사용하여 HTTPS를 통해 스토어에 액세스할 수 있는지 확인합니다. 여기에서 인증서를 테스트할 수 있습니다.

방화벽이 클라비요의 요청을 차단하고 있지 않은지 확인하세요.

모든 아웃바운드 클라비요 연동 트래픽은 예측 가능한 고정 IP 주소 집합 뒤에 있으므로 이 트래픽이 클라비요에서 발생한다는 높은 수준의 확신을 가질 수 있습니다. 클라비요 연동 트래픽 IP 주소를 허용 목록에 추가하는 방법을 알아보려면 문서를 읽어보세요.

Magento 2 및 클라비요 확장 버전 확인

Magento v2.2.0을 사용하는 경우 OAuth를 수동으로 활성화해야 합니다.
올바른 클라비요 확장 프로그램을 설치했는지 확인하세요( 업그레이드해야 할 수도 있습니다).

OAuth 엔드포인트에 액세스할 수 있는지 확인

추가되거나 누락된 재작성 규칙이 있어 기본 Magento 2 OAuth 엔드포인트에 액세스할 수 없게 될 수 있습니다. 클라비요는 인증 프로세스에 필요한 자격 증명을 생성하기 위해 이러한 엔드포인트에 액세스해야 합니다.

스토어에서 아래 URL에 액세스할 수 있는지 확인합니다:

https://[스토어 URL]/oauth/token/request

https://[스토어 URL]/oauth/token/access

다음과 같은 POST 요청을 통해 액세스 가능한지 확인할 수 있습니다:

curl --location --url 'https://[스토어 URL]/oauth/token/request' --request 'POST' -v

curl --location --url 'https://[스토어 URL]/oauth/token/access' --request 'POST' -v

다음과 유사한 응답을 기대할 수 있습니다. 이러한 방식으로 요청할 때 오류가 표시되는 것은 정상이며, 이는 엔드포인트가 올바르게 응답하고 있는지 확인하는 것입니다.
OAuth와 관련된 응답을 받지 못하면 리디렉션, 잘못된 재작성 규칙 또는 내부 서버 오류로 인해 이러한 URL에 액세스할 수 없는지 확인해야 합니다.

이는 URL의 스토어 하위 경로로 인해 발생할 수 있습니다. 에서 엔드포인트에 액세스하여 스토어 하위 경로 문제를 테스트합니다:

https://[스토어 URL]/[스토어 경로]/인증/토큰/요청

https://[스토어 URL]/[스토어 경로]/oauth/token/access

이러한 엔드포인트가 해결되면 .htaccess에 아래 재작성 규칙을 포함하세요. 파일로 문제를 해결하세요.

엔진 다시 쓰기
RewriteRule /oauth/token/request$ https://%{HTTP_HOST}/[저장 경로]/oauth/token/request [L,R=301]
RewriteRule /oauth/token/access$ https://%{HTTP_HOST}/[저장 경로]/oauth/token/access [L,R=301]

통합을 삭제하고 다시 만들기

이전에 통합 시도가 실패한 후 변경한 경우 원래의 OAuth 통합을 삭제하는 것이 좋습니다. 사용된 키가 유효하지 않을 수 있으므로 다시 생성해야 합니다.

Magento 내에서 시스템으로이동합니다.
통합선택
클라비요 연동 레코드를 찾아 삭제합니다.

연동 레코드가 삭제되면 Magento 2 연동 방법 가이드의 단계에 따라 새 연동 레코드를 생성하고 다시 시도하세요.

Magento 버전별 문제

Magento 2.4.2와 관련된 오류

Magento 2.4.2를 사용하는 경우 OAuth 활성화가 실패하는 알려진 문제가 있습니다. 연동 기능을 활성화하면 아래와 같은 오류 메시지가 표시될 수 있습니다. 오류가 표시되지 않더라도 OAuth 활성화가 실패했을 수 있습니다. 일반적으로 오류는 Magento 로그에서 찾을 수 있습니다.

이 오류를 해결하려면 다음 중 하나를 수행해야 합니다:

Magento 2.4.3으로 업그레이드합니다. Magento 2의 설명서를 참조하여 버전을 업그레이드하세요.
마젠토 2용 클라비요의 깃허브 리포지토리에 설명된 대로 패치를 적용합니다.

Magento 2.4.6과 관련된 인증 실패

Magento 2.4.6을 사용 중이고 클라비요와 통합한 후 401 인증 오류가 발생합니까? 이는 Magento 버전 2.4.6에 영향을 미치는 알려진 Magento 버그 때문일 수 있습니다. 이 문제를 해결하려면 무기명 토큰 인증을 사용하도록 설정하여 클라비요가 이를 사용하여 요청을 할 수 있도록 해야 합니다(OAuth 1.0 대신). 무기명 토큰 인증을 사용하려면: