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

# 브랜드 로그인 페이지, 로그인 이메일 및 사용자 지정 인증 도메인

> Didit 호스팅 로그인 페이지와 이메일을 브랜드에 맞게 꾸미세요. 브랜드 디자인, 다섯 개 언어의 페이지 문구, 약관 및 개인정보처리방침 링크, 자체 로그인 도메인을 설정할 수 있습니다.

Didit Authentication의 호스팅 로그인 페이지와 로그인 이메일은 인증 워크플로와 동일한 브랜드를 사용합니다.
Authentication의 페이지 텍스트와 법적 링크는 직접 설정할 수 있으며, 로그인을 `auth.example.com`과 같은 자체 도메인으로 옮길 수도 있습니다.

콘솔의 **Authentication > Branding and emails**에서 관리할 수 있습니다. 이 페이지에서는 라이트 및 다크 모드에서 호스팅 로그인 페이지를 실시간 미리보기로 확인할 수 있습니다.

![샌드박스 애플리케이션의 Didit Business Console Branding and emails 페이지. Customization의 브랜드, 페이지 텍스트, 호스팅 페이지 미리보기가 표시되어 있습니다.](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-branding.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=9653e0d5b5556cec809139cfa6eaf055)

Authentication > Branding and emails 화면과 호스팅 페이지 미리보기.

## 브랜드

로고, 브랜드 색상, 배경, 모서리 둥글기, 글꼴은 콘솔의 애플리케이션 **Customization** 설정에서 가져오며, 호스팅 페이지와 이메일이 이 설정을 따릅니다.
변경하려면 **Edit in Customization**을 선택하세요. 한 번 변경하면 인증 흐름과 로그인 페이지에 함께 적용됩니다.

* 페이지는 사용자의 기기 설정에 따라 라이트 모드 또는 다크 모드로 표시되며, 브랜드 색상은 어두운 배경에 맞게 조정됩니다.
* 페이지에는 애플리케이션 이름이 표시됩니다.
* Free 요금제에서는 호스팅 페이지에 **Secured by Didit** 배지가 표시됩니다.

![샌드박스 애플리케이션의 Didit 호스팅 로그인 페이지를 라이트 모드와 다크 모드로 보여 주며, 패스키 버튼과 이메일 및 비밀번호 필드가 있습니다](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/hosted-sign-in-light-dark.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=835219dfc253b7bfcb830255aff8ff93)

호스팅 로그인 페이지는 사용자의 기기 설정에 따라 라이트 모드 또는 다크 모드로 표시됩니다.

## 페이지 텍스트 및 법적 링크

| 필드 | 제한 | 표시 위치 |
| - | - | - |
| **로그인 제목** | 120자 | 로그인 페이지의 제목입니다. |
| **부제목** | 160자 | 제목 아래에 표시되는 한 줄입니다. |
| **회원가입 제목** | 120자 | 회원가입 페이지의 제목입니다. |
| **서비스 약관 URL** | 500자 | 페이지에 표시되는 링크입니다. 설정하면 회원가입 양식에서 사용자가 약관에 동의하도록 요청합니다. |
| **개인정보 처리방침 URL** | 500자 | 페이지에서 서비스 약관 옆에 표시되는 링크입니다. |

호스팅 페이지는 영어, 스페인어, 프랑스어, 독일어, 일본어로 번역되어 있으며, 사용자의 브라우저 설정이나 로그인 URL의 `ui_locales`에 따라 언어를 선택합니다.
언어별로 직접 텍스트를 설정하세요. 직접 입력한 텍스트가 없는 언어는 Didit의 번역된 기본값을 그대로 사용합니다.

API를 사용하면 [인증 관리 API](https://docs.didit.me/ko/authentication/set-up-by-api.md)에 `PATCH branding/` 요청을 보내 같은 항목을 설정할 수 있습니다:

```bash theme={null}
curl --fail-with-body --request PATCH "${MANAGEMENT_BASE}branding/" \
  -H "x-api-key: $DIDIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "texts": {
      "en": {"sign_in_title": "Welcome back", "subtitle": "Sign in to manage your account.", "sign_up_title": "Open your account"},
      "es": {"sign_in_title": "Hola de nuevo"}
    },
    "terms_url": "https://example.com/legal/terms",
    "privacy_url": "https://example.com/legal/privacy"
  }'
```

빈 값으로 보낸 텍스트는 기본값으로 되돌아갑니다.

## 로그인 이메일

**Branding and emails** 보기에는 애플리케이션의 로그인 이메일 목록이 각 이메일의 미리보기 및 **Send a test**와 함께 표시됩니다:

| 이메일 | 발송 시점 |
| - | - |
| 이메일 코드 | 사용자가 이메일 코드로 로그인하거나 가입할 때. |
| 매직 링크 | 사용자가 로그인 링크를 요청할 때. |
| 비밀번호 재설정 | 사용자가 [비밀번호 찾기](https://docs.didit.me/ko/authentication/sign-in-methods.md#비밀번호-찾기-및-재설정)를 시작할 때. |
| 새 기기 로그인 | 사용자가 새 기기에서 로그인할 때. |
| 초대 | `invited` 가입 정책을 사용하여 사용자를 가입하도록 초대할 때. |
| 조직 초대 | 사용자를 [조직](https://docs.didit.me/ko/authentication/organizations.md#초대) 중 하나에 초대할 때. |
| 에이전트 승인됨, 에이전트 액세스 종료됨 | 사용자의 [AI 에이전트](https://docs.didit.me/ko/authentication/agent-access.md)가 액세스 권한을 얻거나 잃을 때. |

각 이메일에는 애플리케이션에 대해 **On** 또는 **Off**가 표시됩니다.
커스터마이징에서 이메일 도메인을 설정하고 인증한 경우 이메일은 인증된 이메일 도메인에서 발송되며, 그렇지 않은 경우에는 `Didit <no-reply@didit.me>`에서 발송됩니다.

## 커스텀 도메인

기본적으로 애플리케이션은 `https://<slug>.auth.didit.me`에서 사용자를 로그인시킵니다. 커스텀 도메인을 설정하면 호스팅 페이지, 런타임 API, 토큰 발급자가 `auth.example.com`과 같이 여러분의 서브도메인으로 옮겨집니다. 커스텀 도메인은 실제 운영 애플리케이션을 위한 기능입니다. 샌드박스 애플리케이션은 항상 Didit 도메인에서 사용자를 로그인시킵니다.

> [!WARNING]
>
> 패스키는 사용자가 로그인하는 도메인에 묶입니다.
> 커스텀 도메인을 활성화하면 기존 패스키를 새 도메인에 다시 등록해야 하므로, 사용자가 패스키를 추가하기 전에 도메인을 먼저 추가하십시오.

### 설정하기

1. **Custom domain**에서 **Your domain** 항목에 `auth.example.com`과 같은 도메인을 입력하고 **Add domain**을 선택하십시오. 서브도메인을 사용하십시오. CNAME은 도메인의 루트에 둘 수 없습니다.
2. 콘솔에 표시된 DNS 레코드를 만드십시오. 도메인에서 애플리케이션의 Didit 호스트를 가리키는 `CNAME`입니다.
3. **Check DNS now**를 선택하십시오. 새로 만든 레코드가 나타나는 데 최대 한 시간이 걸릴 수 있습니다. Didit이 레코드를 찾으면 도메인용 인증서를 발급하며, 이 인증서는 자동으로 갱신됩니다.
4. 도메인에 **Verified**가 표시되면 **Use this domain**을 선택하여 이 도메인을 애플리케이션의 로그인 오리진으로 지정하십시오.

| 상태 | 의미 |
| - | - |
| Waiting for DNS | Didit이 아직 `CNAME` 레코드를 찾지 못했습니다. |
| Issuing certificate | 레코드가 존재하며 인증서를 발급하는 중입니다. |
| Verified | 도메인에서 호스팅 페이지가 제공됩니다. 활성화하기 전까지는 로그인 오리진이 아닙니다. |
| Active | 도메인이 로그인 오리진이자 발급자입니다. |
| Not found | 확인에 실패했습니다. 레코드를 수정한 후 다시 확인하십시오. |

API로는 `PUT domain/`에 `{"domain": "auth.example.com"}`을 보내 도메인을 추가하고, `POST domain/verify/`로 확인하고, `POST domain/activate/`로 활성화하며, `DELETE domain/`로 삭제합니다.

### 활성화하면 바뀌는 항목

* **발급자.** 새로 발급되는 토큰의 `iss`에 여러분의 도메인이 표시되며, 디스커버리와 JWKS도 이 도메인으로 옮겨집니다. 백엔드가 확인하는 발급자를 업데이트하거나, 이전 토큰이 만료될 때까지 두 발급자를 모두 허용하십시오. [토큰 및 JWKS](https://docs.didit.me/ko/authentication/tokens-and-jwks.md)를 참조하십시오.
* **게시 가능한 키(publishable key).** 게시 가능한 키에는 발급자가 인코딩되어 있으므로 바뀝니다. **Authentication > Developers**에서 새 키를 복사하여 앱에 넣으십시오.
* **이전 도메인의 세션과 토큰.** 5분 이내에 종료됩니다.
* **패스키.** 새 도메인에 다시 등록해야 합니다.
* **리디렉션 URL, 설정, 가입한 사용자.** 그대로 유지됩니다.

앱의 한 설정에서만 게시 가능한 키를 관리하십시오. 그러면 전환할 때 한 곳만 변경하면 됩니다.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.