Adobe Commerce Cloud의 프로덕션에 배포하는 동안 작성기 인증 자격 증명 오류 발생

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

URL 필수 인증(HTTP 401)과 같은 작성기 인증 자격 증명 오류인 경우. 은(는) 클라우드 인프라의 Adobe Commerce에서 프로덕션에 배포하는 동안 발생합니다. 먼저 프로덕션 배포의 빌드 단계에서 auth.json 파일 또는 이와 동등한 인증 자격 증명에 액세스할 수 있는지 확인하십시오. env:COMPOSER_AUTH 환경 수준 변수(권장)를 수정하거나 auth.json 파일을 수동으로 만들고 배포할 수 있습니다.

설명 description

환경

Adobe Commerce on Cloud infrastructure, 프로덕션 및 스테이징

문제

환경에 배포하려고 할 때 URL 필수 인증(HTTP 401)으로 인해 배포 프로세스가 중지되었습니다.작성기 인증 자격 증명과 관련된 오류입니다.

동일한 자격 증명이 로컬 또는 다른 환경에서 auth.json 파일에서 작동하지만 다른 환경에서 배포하는 동안 실패합니다.

해결 방법 resolution

참고: 작성기 자격 증명을 찾으려면 Adobe Commerce 설치 안내서에서 인증 키 가져오기를 참조하세요.

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

프로덕션 배포의 빌드 단계에서 auth.json 파일 또는 이와 동등한 인증 자격 증명에 액세스할 수 있는지 확인하십시오.

이 문제를 해결하기 위한 두 가지 권장 옵션이 있습니다.

옵션 1: env:COMPOSER_AUTH 환경 수준 변수 수정(권장)

env:COMPOSER_AUTH에 대한 올바른 자격 증명을 설정했는지 확인하십시오.
클라우드 프로젝트 UI의 왼쪽 상단에 있는 톱니바퀴 아이콘을 클릭하여 전역 구성에 액세스한 다음 변수 탭을 선택합니다.
빌드 시간 동안 사용 가능 을 선택하고 런타임 동안 사용 가능 을 선택 취소합니다. Commerce on Cloud Infrastructure Guide에서 인증 키를 참조하십시오.

옵션 1로 문제가 해결되지 않으면 옵션 2를 계속 사용하십시오.

옵션 2: auth.json 파일을 수동으로 만들고 배포합니다.

서버에 SSH를 입력합니다.
다음을 사용하여 현재 env:COMPOSER_AUTH 변수의 콘텐츠를 검색합니다.

echo $COMPOSER_AUTH
위 단계(JSON 형식)의 모든 콘텐츠를 복사합니다.
이 내용으로 이름이 auth.json인 새 파일을 만듭니다.
새로 만든 이 auth.json 파일을 리포지토리의 루트 디렉터리에 커밋합니다.
새 배포를 트리거합니다.

위에 제공된 두 옵션 중 하나를 수행하면 작성기 인증 자격 증명과 관련된 문제가 발생하지 않고 문제가 있는 환경에 성공적으로 배포할 수 있습니다.

추가 지원이 필요하거나 이러한 솔루션을 구현하는 동안 문제가 발생하는 경우 Adobe Commerce 기술 지원 팀에서 티켓을 여십시오. 추가 지원을 받으십시오.

Adobe Commerce Cloud의 프로덕션에 배포하는 동안 작성기 인증 자격 증명 오류 발생

설명 description

환경

문제

해결 방법 resolution

관련 읽기