이 페이지는 Apple 개발자 포털에서의 공급자 측 설정만 다룹니다. Apple을 활성화하고 Auth 창에 자격 증명을 입력하는 전체 Clerk Auth 흐름에 대해서는 Clerk Auth 문서의 SSO 공급자에 대한 OAuth 자격 증명 구성을 참조하세요.
사전 요구 사항
- Apple 개발자 계정 (Apple 개발자 프로그램 등록 필요)
- 게시된 Replit 앱 — 사용자 정의 OAuth 자격 증명은 프로덕션 환경에서만 사용 가능
- Auth 창 → 구성 탭 → SSO 공급자 섹션 → 프로덕션 환경 선택 → Apple 옆의 편집 선택에서 열린 Apple 공급자 편집 패널
1단계: Apple App ID 만들기
- Apple 개발자 포털로 이동합니다
- 인증서, 식별자 및 프로파일로 이동한 다음 식별자로 이동합니다
- 드롭다운에서 App IDs를 선택합니다
- + 아이콘을 선택하여 새 식별자를 등록합니다
- App IDs를 선택한 다음 계속을 선택합니다
- 앱을 선택한 다음 계속을 선택합니다
- 다음을 입력합니다:
- 설명: App ID의 이름
- 번들 ID: 고유 식별자
- 기능에서 Sign In with Apple을 활성화합니다
- 계속을 선택한 다음 등록을 선택합니다
- App ID 접두사(상단에 표시됨)를 저장합니다 — 이것이 Team ID입니다
2단계: Apple Services ID 만들기
- 식별자 페이지에서 드롭다운의 Services IDs를 선택합니다
- **+**를 선택하여 새 식별자를 등록합니다
- Services IDs를 선택한 다음 계속을 선택합니다
- 다음을 입력합니다:
- 설명: Services ID의 이름
- 식별자: 고유 식별자 (이것을 저장하세요 — Services ID입니다)
- 계속을 선택한 다음 등록을 선택합니다
Services ID 구성
- 새로 만든 Services ID를 선택합니다
- Sign In with Apple을 활성화합니다
- 구성을 선택합니다
-
다음을 설정합니다:
- Primary App ID: 1단계의 App ID 선택
- 도메인 및 서브도메인: Auth 창의 공급자 설정에 표시된 값을 복사합니다 (
https://프로토콜 접두사 없이) - 반환 URL: Auth 창의 공급자 설정에 표시된 값을 복사합니다
- 다음을 선택한 다음 완료, 계속, 저장을 선택합니다
3단계: Apple 개인 키 만들기
- Apple 개발자 포털 사이드바에서 키를 선택합니다
- **+**를 선택하여 새 키를 등록합니다
- 키 이름을 입력합니다
- Sign In with Apple을 활성화합니다
- 구성을 선택한 다음 1단계의 App ID를 선택합니다
- 저장을 선택한 다음 계속, 등록을 선택합니다
- Key ID를 저장합니다
- 개인 키 파일(.p8)을 다운로드합니다
4단계: Apple 개인 이메일 릴레이 구성
Apple의 내 이메일 숨기기 기능을 사용하면 사용자가 실제 이메일을 노출하지 않고 로그인할 수 있습니다. 이러한 사용자에게 이메일을 보내려면 이메일 소스를 등록하세요.- Apple 개발자 포털 사이드바에서 서비스를 선택합니다
- 이메일 커뮤니케이션을 위한 Apple로 로그인 아래에서 구성을 선택합니다
- **+**를 선택하여 이메일 소스를 추가합니다
- Auth 창의 공급자 설정에 표시된 이메일 소스 값을 입력합니다
- 다음을 선택한 다음 등록, 완료를 선택합니다
- DNS 확인을 기다립니다 (녹색 체크 아이콘)
일부 지역(중국, 인도)에서는 Apple ID가 이메일 대신 전화번호에 연결될 수 있습니다. 앱이 모든 사용자에게 이메일을 요구하는 경우, 이 지역 사용자에 대해 Apple로 로그인이 실패할 수 있습니다.
문제 해결
유효하지 않은 클라이언트
- 모든 자격 증명이 올바르게 입력되었는지 확인하세요
- 개인 키에 BEGIN 및 END 줄이 포함되어 있는지 확인하세요
- Services ID가 올바르게 구성되어 있는지 확인하세요
유효하지 않은 리디렉션 URI
- Apple Services ID 구성의 반환 URL이 Auth 창의 공급자 설정에 표시된 값과 정확히 일치하는지 확인하세요
- 도메인 및 서브도메인의 도메인이 게시된 도메인과 일치하는지 확인하세요 (
https://없이)
이메일 릴레이가 작동하지 않음
- Apple 개발자 포털에서 이메일 소스에 녹색 체크가 표시되는지 확인하세요
- 최근에 추가했다면 DNS 전파를 기다리세요
사용자 정의 도메인에서 작동하지 않음
- Auth 창의 공급자 설정에 표시된 사용자 정의 도메인 항목을 도메인 및 서브도메인(
https://없이)과 반환 URL에 추가하세요