> ## 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.

# Auth

> Replit에서 Auth가 무엇인지 알아보세요 — 사용자 계정을 통해 앱이 환경 설정을 저장하고, 기능을 제한하고, 경험을 개인화하는 방법과 Replit Auth와 Clerk Auth 중 선택하는 방법.

export const YouTubeEmbed = ({videoId, title = "YouTube video", startAt}) => {
  if (!videoId) {
    return null;
  }
  let url = "https://www.youtube.com/embed/" + videoId;
  if (startAt) {
    url = url + "?start=" + startAt;
  }
  return <Frame>
      <iframe src={url} title={title} allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowFullScreen></iframe>
    </Frame>;
};

<YouTubeEmbed videoId="cfpC1rzxspo" title="Replit 앱에 Auth 추가하기" />

Auth — \*\*인증(authentication)\*\*의 줄임말 — 는 앱에 "사용자"라는 개념을 부여합니다. Auth 없이는 모든 방문자가 익명이고 앱이 한 사람을 다른 사람과 구별할 수 없습니다. Auth가 있으면 각 방문자가 로그인하고, 앱이 누구인지 알고, 그들에게 특정한 데이터를 저장할 수 있습니다: 예약, 저장된 차량, 환경 설정, 진행 상황.

Auth가 연결되면 다음이 가능합니다:

* 사용자별 데이터 저장 — 예약, 설정, 콘텐츠, 기록.
* 로그인 뒤에 기능 제한 (결제, 프로필 페이지, 관리자 패널).
* 이름, 역할, 플랜, 또는 과거 행동에 따라 경험 개인화.
* 세션이 아닌 개인별 활동 및 사용량 추적.

## Replit 앱에서 Auth 작동 방식

Replit은 두 가지 내장 Auth 옵션을 제공합니다. 두 가지 모두 Agent가 프로비저닝합니다 — 별도의 대시보드 가입이나 OAuth 키 복사-붙여넣기가 필요 없습니다.

* **[Replit Auth](/references/auth-and-identity/authentication)** — 사용자가 기존 **Replit 계정**으로 로그인합니다. 로그인 페이지는 Replit 브랜드입니다. Agent에게 추가하도록 요청하는 것 외에 설정이 필요 없습니다.
* **[Clerk Auth](/references/auth-and-identity/clerk-auth)** — 앱에 전용 **Clerk 테넌트**가 생깁니다. 사용자는 Replit이 아닌 *여러분의* 앱 내에서 계정을 만듭니다. 브랜딩, 로그인 방법, 로그인 화면의 모양과 느낌을 제어할 수 있습니다.

두 옵션 모두 무거운 작업을 처리합니다 — 로그인 페이지, 세션, 안전한 비밀번호 처리, 소셜 로그인 — 그래서 앱 코드는 "로그인한 사용자가 누구인가?"만 물어보면 됩니다.

## Replit Auth vs. Clerk Auth

|               | Replit Auth                      | Clerk Auth                       |
| ------------- | -------------------------------- | -------------------------------- |
| **사용자 계정**    | 사용자가 Replit 계정으로 로그인             | 사용자가 앱 내에서 계정 생성 (Replit 계정 불필요) |
| **브랜딩**       | Replit 브랜드 로그인 페이지               | 완전히 맞춤 설정 가능 — 앱의 이름, 아이콘, 색상    |
| **SSO 자격 증명** | Replit의 공유 OAuth 앱 사용            | 제공업체별 자체 OAuth 자격 증명             |
| **환경**        | 단일 환경                            | 별도의 개발 및 프로덕션 환경                 |
| **최적 용도**     | 빠른 설정, 프로토타입, Replit 브랜딩이 허용되는 앱 | 브랜드 앱, 전문 및 상업용 제품               |

프로토타입이나 내부 도구를 빌드하는 경우, Replit Auth가 가장 빠른 방법입니다. 자체 브랜드 정체성이 있는 것, 특히 고객 대면이나 상업용을 빌드하는 경우, Clerk Auth가 더 적합합니다.

## 앱에 Auth 추가하기

미리 선택하지 않아도 됩니다 — 하나로 시작하고 나중에 마이그레이션할 수 있습니다. 가장 빠른 방법은 Agent에게 어떤 것을 사용할지 말하는 것입니다:

* *"내 앱에 로그인을 추가해 줘. Replit Auth를 사용해."*
* *"내 앱에 로그인을 추가해 줘. Clerk Auth를 사용해."*

## 다음 단계

<CardGroup cols={2}>
  <Card title="Replit Auth" icon="lock" href="/references/auth-and-identity/authentication">
    제로 설정으로 Replit 브랜드 로그인 — 사용자가 Replit 계정으로 로그인합니다.
  </Card>

  <Card title="Clerk Auth" icon="user-lock" href="/references/auth-and-identity/clerk-auth">
    자체 브랜드 Auth 테넌트 — 완전히 맞춤 설정 가능한 로그인, 별도의 Dev/Prod 환경.
  </Card>

  <Card title="로그인 추가하기" icon="user-plus" href="/build/add-login">
    실제 예제: 실제 앱에 Clerk Auth를 연결하고 두 명의 고객으로 테스트합니다.
  </Card>

  <Card title="Replit Auth에서 Clerk로 마이그레이션" icon="right-left" href="/references/auth-and-identity/clerk-auth-migration">
    기존 앱을 Replit Auth에서 Clerk 테넌트로 이전합니다.
  </Card>
</CardGroup>