> ## 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 Business Console에서 사용자가 애플리케이션에 로그인하는 방식을 설정하고, 로그인할 때 어떤 일이 일어나는지 확인하는 곳입니다.
제품 목록에서 **Authentication**을 열면, 사이드바에 페이지가 아래와 같이 그룹으로 나뉘어 표시됩니다.

| 그룹 | 페이지 |
| - | - |
| 인증 | [개요](#overview), [사용자](#users), [로그인](#로그인-및-세션) |
| 로그인 | [로그인 방법](#로그인-방법), [인증된 신원](#verified-identity), [조직](#조직) |
| 보호 | [봇 보호](#봇-방어), [보안 및 세션](#보안-및-세션), [에이전트 액세스](#에이전트-액세스) |
| 구축 | [브랜딩 및 이메일](#branding-and-emails), [사용자 가져오기](#사용자-가져오기), [개발자](#개발자) |

설정은 콘솔 상단에서 선택한 애플리케이션에 속하며, 프로덕션 애플리케이션과 샌드박스 애플리케이션은 설정과 사용자가 각각 별도로 관리됩니다.
이 섹션을 읽으려면 `authentication` 권한이 **read**여야 하고, 설정을 변경하려면 **write**여야 합니다. 자세한 내용은 [역할 및 권한](https://docs.didit.me/ko/console/roles-permissions.md)을 참고하세요.
요금제에 포함되지 않은 기능의 페이지에는 요금제 안내가 표시됩니다. 샌드박스 애플리케이션에는 모든 요금제의 기능이 포함되어 있으므로, 먼저 사용해 볼 수 있습니다.

## Overview

홈 화면에서는 지난 30일을 한 문장으로 요약하고, **Ask Didit**에서 로그인에 관한 질문에 답변을 받을 수 있습니다.

| 지표 | 집계 내용 |
| - | - |
| **Monthly active users** | 지난 30일 동안 로그인한 사람 수이며, 그 이전 30일과 비교합니다. |
| **Sign-ins** | 지난 30일 동안의 로그인 횟수와 활성 사용자 1명당 평균입니다. |
| **Success rate** | 로그인 시도 중 성공한 비율과 가장 흔한 실패 사유입니다. |
| **Passkey adoption** | 패스키로 로그인한 비율입니다. |

**Needs your attention**에는 팀이 조치해야 할 항목이 표시됩니다. 예를 들어 잘못된 비밀번호를 반복해서 입력하여 잠긴 계정이 이에 해당하며, **Unlock** 또는 **Keep locked**를 선택할 수 있습니다.
**See all analytics**를 선택하면 [분석](https://docs.didit.me/ko/console/analytics.md)에서 인증 지표를 열 수 있습니다.

![Didit Business Console의 인증 개요 화면으로, 지난 30일간의 월간 활성 사용자, 로그인 수, 성공률, 패스키 사용률이 표시되어 있습니다](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-overview.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=211a7703b2c07f4fb0f993d4c5636f42)

Business Console의 Authentication > Overview입니다.

## Users

**Users**는 콘솔의 다른 화면과 같은 사용자 목록이므로, 각 사용자의 로그인 기록이 인증 및 거래 기록과 나란히 표시됩니다.
**Can sign in** 및 **Locked or blocked** 보기와 **Sign-in** 필터를 사용하면 로그인 상태, 로그인 방법 또는 MFA 기준으로 목록을 좁힐 수 있습니다.

팀은 사용자별로 다음 작업을 수행할 수 있습니다.

| 작업 | 설명 |
| - | - |
| **Block** and **Unblock** | 로그인을 중지하거나 복원합니다. 차단하면 해당 사용자의 세션과 에이전트 액세스도 종료됩니다. 상태가 변경되면 사용자에게 이메일을 보낼 수 있습니다. |
| **Unlock** | 일시적인 잠금과 실패 시도 횟수를 초기화합니다. |
| **Revoke sessions** | 모든 곳에서 사용자를 로그아웃시키며, 에이전트도 포함됩니다. |
| **Reset MFA** | 패스키를 포함한 모든 2단계 인증 수단을 제거하고 해당 사용자의 세션을 종료합니다. Owner 또는 Admin만 사용할 수 있습니다. |
| **Send sign-in link** | 로그인 페이지로 연결되는 15분 동안 유효한 일회용 링크를 사용자에게 이메일로 보냅니다. Owner 또는 Admin만 사용할 수 있습니다. |
| **Send password reset** | 30분 동안 유효한 비밀번호 재설정 링크를 사용자에게 이메일로 보냅니다. |

여러 사용자를 선택하면 최대 100명에게 한 번에 작업을 적용할 수 있습니다.
각 작업의 규칙은 [관리자 ID 작업](https://docs.didit.me/ko/authentication/sign-in-methods.md#관리자-신원-작업)에 설명되어 있습니다.

## 로그인 및 세션

**Sign-ins**에는 두 가지 보기가 있습니다.

**Sign-in attempts**에는 모든 로그인 시도가 상태(성공, 실패, 추가 인증 요구, 차단), 사용자, 방법, 기기, 위치, 위험 수준, 시간과 함께 표시됩니다.
상태, 방법, 위험 수준별로 필터링할 수 있습니다.
시도를 열면 기기, 네트워크, VPN 또는 잠금 신호 등의 근거를 확인할 수 있습니다. 또한 **Open person**, **See in Events**, **Block this IP** 버튼이 있습니다. **Block this IP**는 해당 IP 주소를 [Lists](https://docs.didit.me/ko/console/blocklist-users.md)의 차단 목록에 추가합니다.

![Didit Business Console의 Sign-ins 페이지, 로그인 시도별 상태, 사용자, 방법, 기기, 위치, 위험 수준, 시간을 표시](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-sign-ins.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=3c79b4e120c911b732d738e52d1687c8)

Authentication > Sign-ins: 모든 로그인 시도와 상태, 방법, 위험 수준별 필터.

**Active sessions**에는 현재 로그인되어 있는 세션이 표시되며, 사용자, 기기, 위치, 각 세션의 시작 시각, 마지막 활동 시각, 종료 시각이 포함됩니다. 종료 시각은 설정에 있는 "Sessions last X, or Y without activity" 규칙에 따라 정해집니다.
**Revoke**를 누르면 해당 기기의 세션이 즉시 종료됩니다.

![Didit Business Console의 Active sessions 보기, 로그인된 세션을 기기, 위치, 시작, 마지막 활동, 종료 시각 및 Revoke 버튼과 함께 표시](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-active-sessions.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=098f6be31804b0af7c680e569f341bfb)

Authentication > Sign-ins > Active sessions: 각 세션에 Revoke 버튼이 있습니다.

**Open in Events**를 누르면 같은 활동을 이벤트로 볼 수 있으며, 로그인과 사용자의 나머지 활동을 결합하는 [부정 행위 보기](https://docs.didit.me/ko/authentication/events-and-webhooks.md#사기-탐지-보기)도 함께 제공됩니다.

## 로그인 방법

각 방법을 켜거나 끄고 설정합니다.
각 방법이 전체 로그인 중 차지하는 비율도 함께 표시됩니다.

| 그룹 | 방법 |
| - | - |
| 비밀번호 없음 | **Passkeys**, **Email code**, **매직 링크** |
| 비밀번호 | **Email and password** |
| 소셜 | 각 소셜 로그인 제공자를 표시하며, 샌드박스에서는 Didit의 테스트 자격 증명을 사용하고 자체 앱을 사용하는 경우에는 앱의 클라이언트 ID와 시크릿을 사용합니다. |
| 전화번호 및 재사용 가능한 신원 | 인증 코드를 보내는 전화번호 인증 워크플로가 포함된 **Phone code**, 그리고 아직 사용할 수 없는 **Didit ID Wallet** |

**Hosted sign-in** 카드에는 호스팅 로그인 페이지의 URL이 표시되며, **Try your sign-in page**를 선택하면 해당 페이지가 열립니다.
각 방법의 작동 방식은 [로그인 방법](https://docs.didit.me/ko/authentication/sign-in-methods.md)을 참조하세요.

![Didit Business Console의 Sign-in methods 페이지입니다. 호스팅 로그인 페이지 카드, 비밀번호 없음 및 비밀번호 로그인 방법, 호스팅 페이지의 실시간 미리보기가 표시되어 있습니다.](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-sign-in-methods.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=4f71ad0125f22dd8184ad837854ec8db)

Authentication > Sign-in methods, 호스팅 로그인 페이지의 실시간 미리보기가 포함된 화면입니다.

## Verified identity

계정이 생성되기 전에 사용자가 통과해야 하는 검사(없음, 라이브니스 또는 전체 신분증 인증)를 선택하고, 민감한 작업 전에 검사를 다시 요청하는 규칙(특정 금액을 초과하는 지급, 새 은행 계좌, 이메일 또는 전화번호 변경, 새 기기 및 이어지는 지급)을 설정하며, 앱이 토큰으로 받는 인증된 클레임을 선택합니다.
**Preview a step-up**에서 사용자에게 보이는 화면을 미리 볼 수 있습니다.
각 규칙에는 이번 달에 요청된 검사 수와 통과한 검사 수가 표시됩니다.
자세한 내용은 [인증된 신원](https://docs.didit.me/ko/authentication/verified-identity.md)을 참조하세요.

![Didit Business Console의 인증된 신원 페이지. 가입 시 인증 수준과 가격, 민감한 작업 전 단계별 재인증 규칙이 표시되어 있습니다](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-verified-identity.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=98544caeedf5ffaf68484cace19f9b3f)

인증 > 인증된 신원: 가입 시 검사와 민감한 작업 전 재인증 규칙.

## 조직

기업 고객을 위해 조직 기능을 활성화하고 관리하세요. **New organization**을 선택한 다음, 각 조직의 싱글 사인온과 설정 링크, 자동 가입이 설정된 인증된 도메인, 멤버, 역할, 초대를 관리하세요.
주요 지표에는 조직, 멤버, SSO 연결, 인증된 도메인의 수가 집계됩니다.
자세한 내용은 [조직](https://docs.didit.me/ko/authentication/organizations.md)을 참고하세요.

![Didit 기업 콘솔의 조직 페이지로, 주요 지표와 각 조직의 멤버, 인증된 도메인, 싱글 사인온 상태가 표시된 조직 목록이 나와 있습니다](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-organizations.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=95f8ab54f499735fe3f8593c565c0daa)

인증 > 조직.

## 봇 방어

**Only allow humans** 스위치는 모든 보호 기능을 제어합니다.
그 아래에서 여섯 가지 보호 기능(봇 탐지, 자격 증명 스터핑, 무차별 대입 공격 잠금, 일회용 이메일, VPN 및 데이터 센터 네트워크, 불가능한 이동) 각각을 **Off**, Log, Challenge 또는 Block으로 설정할 수 있으며, 이번 달 일치한 시도 횟수가 표시됩니다.
**Attack mode**는 긴급 상황을 위해 모든 가입과 로그인에 챌린지를 적용하며, 이후 스스로 꺼집니다.
주요 지표에는 이번 달 차단된 건수와 챌린지가 적용된 건수, 그리고 가장 큰 급증 규모가 표시되며, **See detections**를 클릭하면 해당 이벤트가 열립니다.
자세한 내용은 [봇 방어](https://docs.didit.me/ko/authentication/bot-protection.md)를 참조하세요.

![Didit Business Console의 봇 방어 페이지로, Only allow humans 스위치, 공격 모드, 주요 지표와 각 보호 기능의 Off, Log, Challenge, Block 모드가 표시됩니다](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-bot-protection.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=bb899d54d9e9e32172d83afbfa996375)

인증 > 봇 방어.

## 보안 및 세션

| 카드 | 설정 |
| - | - |
| **Recommendations** | 조직 관리자에게 MFA를 요구하는 것과 같은 권장 변경 사항입니다. 적용되면 **Done**으로 표시됩니다. |
| **Multi-factor authentication** | MFA를 사용해야 하는 대상은 **Everyone**, **Organization admins** 또는 **Optional**입니다. 사용자는 패스키, 인증 앱 또는 백업 코드를 사용할 수 있습니다. |
| **Sessions** | **Session lifetime**(1일, 7일, 30일 또는 90일), **Ends when idle for**(30분, 2시간, 1일 또는 7일), **Sign out other devices when the password changes**, 그리고 **Several devices at once**입니다. |
| **Password** | **Minimum password length**(8, 10, 12 또는 14)입니다. 흔한 비밀번호는 항상 거부되며, 유출된 비밀번호 확인은 **Bot protection**에 있습니다. |
| **Account protection** | **Who can sign up**(**Anyone**, **Invited people** 또는 **Allowed domains**, 허용할 이메일 도메인 목록 포함), **Email subaddresses**, 그리고 **Lists**의 허용 목록과 차단 목록이며, 이는 로그인 시점에 적용됩니다. |
| **Redirect URLs and allowed origins** | Didit이 사용자를 리디렉션할 수 있는 정확한 주소와 로그인 오리진을 호출할 수 있는 웹 오리진입니다. 자세한 내용은 [redirect URLs](https://docs.didit.me/ko/authentication/overview.md#리디렉션-url)를 참조하십시오. |
| **Sign-in URL** | 앱에서 로그인이 시작되는 위치입니다. 팀이 사용자 레코드에서 보내는 로그인 링크는 이 위치를 엽니다. |

각 설정은 [application settings](https://docs.didit.me/ko/authentication/overview.md#애플리케이션-설정)의 필드에 대응합니다.

![Didit 비즈니스 콘솔의 보안 및 세션 페이지로, MFA 정책, 세션 수명, 유휴 시간 제한 및 비밀번호 설정이 표시됩니다](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-security-and-sessions.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=ab3736c1463119747c89f6269ef31e05)

인증 > 보안 및 세션.

## 에이전트 액세스

에이전트 액세스를 켜고, 에이전트가 수행할 수 있는 작업, 에이전트 세션의 유지 시간, 그리고 사용자가 에이전트를 승인하는 방식을 선택합니다.
페이지에는 활성 에이전트 세션이 **Revoke**와 함께 표시되며, 승인과 권한 철회 건수가 집계됩니다.
자세한 내용은 [에이전트 액세스](https://docs.didit.me/ko/authentication/agent-access.md)를 참조하세요.

![Didit Business Console의 에이전트 액세스 페이지로, 에이전트 설정, 주요 지표, 그리고 Revoke 버튼이 있는 활성 에이전트 세션 목록이 표시됩니다](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-agent-access.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=7cc518e37e2ccafa5515eb22e6ef9b8d)

인증 > 에이전트 액세스.

## Branding and emails

Customization에서 브랜드를 확인하고, 페이지 문구와 이용약관 및 개인정보 처리방침 링크를 설정하며, 사용자 지정 로그인 도메인을 추가하고, 호스팅 페이지를 라이트 및 다크 모드로 미리 볼 수 있습니다.
이메일 보기에서는 로그인 이메일 목록과 각 이메일의 미리보기를 확인할 수 있으며, **Send a test**를 사용할 수 있습니다. 이메일 및 SMS 메시지의 발신자도 여기에서 확인할 수 있습니다.
자세한 내용은 [브랜딩 및 사용자 지정 도메인](https://docs.didit.me/ko/authentication/branding-and-custom-domain.md)을 참조하세요.

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

인증 > 브랜딩 및 이메일, 호스팅 페이지 미리보기 포함.

## 사용자 가져오기

다른 ID 플랫폼이나 자체 데이터베이스의 사용자를 CSV 또는 JSON 파일로 가져올 수 있습니다. 먼저 드라이 런을 실행하고, 결과를 확인한 후 가져오기를 진행하세요.
**Import history**에서 모든 가져오기 작업의 상태와 결과를 확인할 수 있습니다.
자세한 내용은 [사용자 가져오기](https://docs.didit.me/ko/authentication/migration.md)를 참조하세요.

## 개발자

| 카드 | 포함 내용 |
| - | - |
| **키** | 공개되어도 되며 앱에 넣는 **공개 가능 키**, 클라이언트 코드에 절대 넣으면 안 되는 **비밀 키**, 그리고 **Frontend API** 주소입니다. |
| **AI 코딩 에이전트용 프롬프트** | 애플리케이션의 키가 포함된 준비된 프롬프트로, 인증을 코드베이스에 추가하며 먼저 다른 플랫폼에서 사용자를 옮기는 중인지 묻습니다. |
| **SDK** | React, Next.js, iOS, Android용 설치 및 로그인 코드 조각입니다. |
| **이벤트 및 webhook** | `auth.*` webhook 유형과 서버가 수신하는 내용입니다. |

커스텀 도메인을 활성화하면 공개 가능 키가 변경됩니다. 여기에서 새 키를 복사해 앱에 넣으세요.
[빠른 시작](https://docs.didit.me/ko/authentication/quickstart.md)과 [이벤트 및 webhook](https://docs.didit.me/ko/authentication/events-and-webhooks.md)을 참고하세요.


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