서드 파티 쿠키 지원 중단에 대비하기

경고: Chrome은 발표했습니다. 서드 파티 (3P) 쿠키 지원 중단을 더 이상 진행하지 않는다. 여기에 설명된 안내는 더 이상 필요하지 않으며 2025년 초에 부가기능에 영향을 미치지 않을 것 입니다. 하지만 Chrome은 3P 쿠키에 관한 사용자 선택권을 더욱 확대할 계획이므로 앞으로 3P 쿠키 액세스가 현재보다 더 제한될 수 있습니다. 따라서 이 가이드는 부가기능에서 3P 쿠키가 사용되는 방식을 이해하고 Chrome 사용자 환경이 발전함에 따라 3P 쿠키 가용성의 잠재적 변화에 대비하는 데 관심이 있는 개발자에게 여전히 유용할 수 있습니다.

이 가이드는 Chrome에서 서드 파티 쿠키 지원을 종료함에 따라 부가기능에 미치는 영향과 필요한 변경사항을 이해하는 데 도움이 됩니다.

개요

2024년 1월 4일 Chrome은 사용자 1% 를 대상으로 서드 파티 (3P) 쿠키에 대한 웹사이트 액세스를 기본적으로 제한하는 추적 방지 기능을 도입했습니다. Chrome은 2025년 초에 3P 쿠키를 완전히 단계적으로 지원 중단할것으로 예상됩니다.

클래스룸 부가기능에서 영향을 받는 사용자 여정은 최소 두 가지입니다.

1. Google 싱글 사인온 (SSO) 흐름
2. 새 탭에서 사용자 실행

Google SSO

Google SSO 흐름 중에 사용자는 Google 계정에 로그인하고 데이터 공유에 동의하는 대화상자로 이동합니다.

그림 1. iframe 내에서 SSO 중에 발생하는 세 가지 쿠키 컨텍스트 시각화: (1) 최상위 클래스룸 앱, (2) 3P 삽입 iframe (이 경우 localhost의 DavidPuzzle), (3) 최상위 OAuth 대화상자

일반적인 부가기능 구현에서 이 로그인 프로세스가 완료되면 세션 쿠키가 설정됩니다. 삽입된 컨텍스트에 있는 부가기능 iframe이 이제 세션 쿠키와 함께 다시 로드되어 사용자가 인증된 세션에 액세스할 수 있습니다. 하지만 3P 쿠키가 사용 중지되면 부가기능 iframe과 같은 삽입된 컨텍스트의 사이트는 각 최상위 컨텍스트의 쿠키에 액세스할 수 없습니다. 클래스룸 부가기능의 경우 사용자가 인증된 세션에 액세스할 수 없으며 로그인 루프에 갇히게 됩니다.

삽입된 iframe 컨텍스트에서 세션 쿠키를 설정하는 구현의 경우 CHIPS API를 사용하여 이 문제를 완화할 수 있습니다. 이 API를 사용하면 삽입된 사이트에서 분할된 쿠키 (삽입자와 삽입된 도메인 모두에서 키가 지정된 쿠키)를 설정하고 액세스할 수 있습니다. 하지만 로그인 대화상자의 최상위 컨텍스트에서 세션 쿠키를 설정하는 구현은 iframe에서 분할되지 않은 쿠키에 액세스할 수 없어 로그인이 불가능합니다.

새 탭

마찬가지로 사용자가 부가기능 iframe에서 쿠키 기반 인증된 세션을 보유하고 iframe이 활동을 위해 사용자를 새 최상위 탭으로 실행하는 경우 최상위 탭은 iframe에서 분할된 세션 쿠키에 액세스할 수 없습니다. 이렇게 하면 iframe 세션 상태가 새 탭 활동에 유지되지 않으며 사용자가 새 탭에서 다시 로그인해야 할 수 있습니다. CHIPS API는 설계상 이 문제를 해결할 수 없습니다. 분할된 iframe 쿠키는 최상위 컨텍스트에서 액세스할 수 없습니다.

개발자 작업

Chrome에서 3P 쿠키를 단계적으로 지원 중단함에 따라 부가기능이 계속 의도한 대로 작동하도록 하기 위해 고려해야 할 몇 가지 작업이 있습니다.

1. 부가기능의 중요한 사용자 여정에서 3P 쿠키 사용을**감사** 합니다. 특히 3P 쿠키를 사용 중지한 상태에서 테스트하여 특정 구현에 미치는 영향을 평가합니다.

2. Storage Access API를 살펴봅니다. 모든 부가기능 구현에서 Storage Access API (SAA)를 살펴보는 것이 좋습니다. SAA를 사용하면 iframe이 iframe 컨텍스트 외부에서 쿠키에 액세스할 수 있습니다. SAA는 현재 Chrome에서 사용할 수 있으며 클래스룸 앱에서 지원됩니다.

   참고: SSO 흐름에서 대화상자 컨텍스트에 쿠키를 설정하지 않고 부가기능에서 사용자를 최상위 탭으로 실행하지 않는 경우 SAA가 필요하지 않을 수 있습니다. 더 간단한 CHIPS API를 살펴보고 요구사항을 충족하는지 확인하세요.

3. FedCM을 선택합니다. 또한 GIS(Google 계정으로 로그인 라이브러리)를 사용하는 경우 ID팀의 공식 안내는 FedCM을 선택하는 것입니다. 이는 3P 쿠키 기능을 대체하지는 않지만 결국 3P 쿠키 지원 중단의 일환으로 GIS에서 필요하게 됩니다. FedCM은 현재 Chrome에서 사용할 수 있으며 클래스룸에서 지원되지만 동작과 기능은 아직 개발 중이며 의견을 수렴하고 있습니다.

4. GIS로 마이그레이션합니다. 지원 중단된 GSIv2 라이브러리(Google 로그인 라이브러리라고도 함)를 사용하는 경우 앞으로 GSIv2 지원이 불확실하므로 GIS로 마이그레이션하는 것이 좋습니다.

5. 지원 중단 기능 트라이얼 지연을 신청합니다. Chrome은 비광고 사용 사례에서 3P 쿠키 지원 중단의 영향을 지연할 수 있도록 지원 중단 평가판을 제공합니다. 신청이 수락되면 SAA와 같은 장기적인 솔루션으로 마이그레이션하는 동안 2024년까지 출처에 대해 3P 쿠키를 사용 설정된 상태로 유지하는 데 사용할 수 있는 토큰이 제공됩니다. 신청 후 손상 보고서의 버그 ID 또는 링크를 제공하라는 메시지가 표시됩니다. Google팀에서 이미 클래스룸 부가기능에 대해 이 작업을 제출했으며 이 버그를 제공할 수 있습니다.

경고: 지원 중단 기능 트라이얼에 수락된 개발자는 앱에 토큰이 없더라도 유예 기간 동안 3P 쿠키가 자동으로 사용 설정됩니다. 1% 지원 중단을 사용하여 3P 쿠키 없이 부가기능이 작동하는 방식을 테스트하려면 이 주의사항을 숙지하세요.

참고: 지원 중단 기능 트라이얼은 기존 애플리케이션을 대상으로 합니다. 오늘 부가기능을 빌드하는 경우 SAA 또는 부가기능이 3P 쿠키 없이 작동할 수 있는 다른 구현을 사용하여 빌드할 계획을 세우세요. 영향을 받는 애플리케이션이 아직 없는 경우 지원 중단 기능 트라이얼을 이용하지 못할 수 있습니다.

참고: Chrome은 3P 쿠키 단계적 지원 중단 일정을 2024년 하반기에서 2025년 초로 변경한다고 발표했습니다. 이 변경사항은 지원 중단 기능 트라이얼 기간에 영향을 미칠 수 있으며 변경사항을 반영하도록 이 페이지가 업데이트됩니다.