> ## Documentation Index
> Fetch the complete documentation index at: https://docs.replit.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Apple OAuth 구성하기

> 앱 인증을 위해 Sign in with Apple을 설정하세요

이 가이드는 Sign in with Apple에 필요한 Apple App ID, Services ID, Private Key를 생성하는 과정을 안내합니다. **Team ID**, **Services ID**, **Key ID**, **Private Key**를 수집하여 **Auth 패널**에 입력하게 됩니다.

<Note>
  이 페이지는 Apple Developer 포털에서의 제공자 측 설정만 다룹니다. Apple 활성화 및 **Auth 패널**에서의 자격 증명 입력을 포함한 전체 Clerk Auth 흐름은 Clerk Auth 문서의 [SSO 제공자용 OAuth 자격 증명 구성하기](/ko/features/auth-and-identity/clerk-auth#configuring-oauth-credentials-for-an-sso-provider)를 참고하세요.
</Note>

## 사전 준비 사항

* [Apple Developer 계정](https://developer.apple.com/account) (Apple Developer Program 가입 필요)
* [게시된 Replit 앱](/ko/learn/projects-and-artifacts/replit-deployments) — 커스텀 OAuth 자격 증명은 **Production** 환경에서만 사용할 수 있습니다
* **Apple** 제공자의 편집 패널을 다음 경로로 엽니다: **Auth 패널** → **Configure** 탭 → **SSO providers** 섹션 → **Production** 환경 선택 → **Apple** 옆의 **Edit** 선택

## 1단계: Apple App ID 만들기

1. [Apple Developer 포털](https://developer.apple.com/account)로 이동합니다
2. **Certificates, IDs & Profiles**로 이동한 다음 **Identifiers**를 선택합니다
3. 드롭다운에서 **App IDs**를 선택합니다
4. **+** 아이콘을 선택하여 새 식별자를 등록합니다
5. **App IDs**를 선택한 다음 **Continue**를 선택합니다
6. **App**을 선택한 다음 **Continue**를 선택합니다
7. 다음 항목을 입력합니다:
   * **Description**: App ID의 이름
   * **Bundle ID**: 고유 식별자
8. Capabilities에서 **Sign In with Apple**을 활성화합니다
9. **Continue**를 선택한 다음 **Register**를 선택합니다
10. **App ID Prefix를 저장하세요**(상단에 표시됨) - 이것이 **Team ID**입니다

## 2단계: Apple Services ID 만들기

1. Identifiers 페이지에서 드롭다운에서 **Services IDs**를 선택합니다
2. \*\*+\*\*를 선택하여 새 식별자를 등록합니다
3. **Services IDs**를 선택한 다음 **Continue**를 선택합니다
4. 다음 항목을 입력합니다:
   * **Description**: Services ID의 이름
   * **Identifier**: 고유 식별자(저장해 두세요 - 이것이 **Services ID**입니다)
5. **Continue**를 선택한 다음 **Register**를 선택합니다

### Services ID 구성하기

1. 새로 만든 Services ID를 선택합니다
2. **Sign In with Apple**을 활성화합니다
3. **Configure**를 선택합니다
4. 다음을 설정합니다:

   * **Primary App ID**: 1단계에서 만든 App ID를 선택합니다
   * **Domains and Subdomains**: **Auth 패널**의 **Provider setup**에 표시된 값을 복사합니다(`https://` 프로토콜 접두사 제외)
   * **Return URLs**: **Auth 패널**의 **Provider setup**에 표시된 값을 복사합니다

   이 값들을 찾는 방법은 [SSO 제공자용 OAuth 자격 증명 구성하기](/ko/features/auth-and-identity/clerk-auth#configuring-oauth-credentials-for-an-sso-provider)를 참고하세요.
5. **Next**를 선택한 다음 **Done**, **Continue**, **Save**를 순서대로 선택합니다

## 3단계: Apple Private Key 만들기

1. Apple Developer 포털 사이드바에서 **Keys**를 선택합니다
2. \*\*+\*\*를 선택하여 새 키를 등록합니다
3. **Key Name**을 입력합니다
4. **Sign In with Apple**을 활성화합니다
5. **Configure**를 선택한 다음 1단계에서 만든 App ID를 선택합니다
6. **Save**를 선택한 다음 **Continue**, **Register**를 순서대로 선택합니다
7. **Key ID를 저장하세요**
8. 프라이빗 키 파일(.p8)을 **다운로드**합니다

<Warning>
  프라이빗 키는 한 번만 다운로드할 수 있습니다. 안전하게 보관하세요 — 다시 다운로드할 수 없습니다.
</Warning>

## 4단계: Apple Private Email Relay 구성하기

Apple의 Hide My Email 기능을 사용하면 사용자가 실제 이메일을 노출하지 않고 로그인할 수 있습니다. 이런 사용자에게 이메일을 보내려면 이메일 소스를 등록해야 합니다.

1. Apple Developer 포털 사이드바에서 **Services**를 선택합니다
2. **Sign in with Apple for Email Communication** 아래에서 **Configure**를 선택합니다
3. \*\*+\*\*를 선택하여 Email Source를 추가합니다
4. **Auth 패널**의 **Provider setup**에 표시된 Email Source 값을 입력합니다
5. **Next**를 선택한 다음 **Register**, **Done**을 순서대로 선택합니다
6. DNS 확인을 기다립니다(녹색 체크 아이콘)

<Info>
  일부 지역(중국, 인도)에서는 Apple ID가 이메일 대신 전화번호에 연결되어 있을 수 있습니다. 앱이 모든 사용자에게 이메일을 요구하는 경우, 이러한 지역의 사용자에게는 Sign in with Apple이 실패할 수 있습니다.
</Info>

## 문제 해결

### Invalid client

* 모든 자격 증명이 올바르게 입력되었는지 확인하세요
* 프라이빗 키에 BEGIN 및 END 줄이 포함되어 있는지 확인하세요
* Services ID가 올바르게 구성되었는지 확인하세요

### Invalid redirect URI

* Apple Services ID 구성의 Return URL이 **Auth 패널**의 **Provider setup**에 표시된 값과 정확히 일치하는지 확인하세요
* Domains and Subdomains의 도메인이 게시된 도메인과 일치하는지 확인하세요(`https://` 제외)

### 이메일 릴레이가 작동하지 않음

* Apple Developer 포털에서 Email Source에 녹색 체크가 표시되는지 확인하세요
* 최근에 추가했다면 DNS 전파를 기다리세요

### 커스텀 도메인에서 작동하지 않음

* **Auth 패널**의 **Provider setup**에 표시된 커스텀 도메인 항목을 Domains and Subdomains(`https://` 제외)와 Return URLs에 추가하세요

## 추가 자료

* [Apple Sign in with Apple 문서](https://developer.apple.com/sign-in-with-apple/)
* [Private Email Relay Service 가이드](https://developer.apple.com/help/account/configure-app-capabilities/configure-private-email-relay-service)