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

# iOS 빠른 시작: 인증 연동

> Didit iOS 인증 연동을 준비하세요. 호스팅 로그인, 콜백 검증, 보안 세션, 인증 및 모니터링 링크를 안내합니다.

> [!WARNING]
>
> Authentication은 새로운 기능이며 **DiditAuth for iOS**는 릴리스에 따라 달라집니다. 패키지 배포 정보, 버전, 호출 가능한 시그니처는 여기서 확인되지 않습니다. 추측으로 패키지를 설치하지 마십시오. 신분증 인증 SDK를 Authentication SDK로 사용하지도 마십시오.

## 애플리케이션 준비

1. Didit 애플리케이션에서 Authentication이 활성화되어 있는지 확인하고, 콘솔에서 로그인 오리진(`https://<slug>.auth.didit.me`, 샌드박스의 경우 `<slug>.sandbox.auth.didit.me`)을 복사합니다.
2. 애플리케이션과 런타임이 지원하는 정확한 콜백 URL을 등록합니다. 앱 링크 소유권을 검증하고, 임의의 커스텀 URL 스킴이 허용된다고 가정하지 마십시오.
3. 콜백 처리와 저장된 자격 증명을 포함해 샌드박스 설정과 라이브 설정을 분리해 유지합니다.
4. 인증이나 모니터링을 연결하기 전에 안정적인 사용자 매핑을 선택합니다.

호스팅 로그인에는 시스템 인증 세션을 사용합니다. 네이티브 패스키 처리와 신뢰 당사자 도메인은 함께 계획하십시오. WebView는 시스템 인증 흐름을 대체할 수 없습니다.

## 호스팅 흐름 구현

`{origin}/sign-in` URL로 시스템 인증 브라우저 세션을 엽니다. 새로운 무작위 `state`, S256 PKCE 챌린지, 등록된 `redirect_uri`를 함께 전달합니다. 검증기(verifier)는 해당 시도 동안에만 앱에 보관합니다. 기반 프로토콜은 [JavaScript 빠른 시작](https://docs.didit.me/ko/authentication/quickstarts/javascript.md)에서 확인할 수 있습니다. 네이티브 코드에서는 브라우저 전역 객체 대신 플랫폼의 암호화 기능과 URL 처리를 사용하십시오.

콜백을 받으면 `token/`에서 일회용 코드를 교환하기 전에 state 값, 트랜잭션 유효 기간, 콜백 대상을 검증합니다. 원래의 검증기와 정확한 리디렉션 URI를 사용합니다. 브라우저를 취소하거나 닫는 것은 성공한 로그인이 아닙니다.

갱신 토큰은 플랫폼이 보호하는 자격 증명 저장소에 보관하십시오. 일반 환경설정 파일, 분석 도구, 크래시 로그에는 절대 저장하지 마십시오. 최종 사용자의 Bearer 토큰으로 `GET session/`을 호출해 현재 세션을 검증합니다. 갱신은 직렬화하고, 두 토큰을 함께 교체하며, 로그아웃 후에는 사용자별 상태를 지웁니다. 요청 규격과 갱신 재사용 동작은 [토큰 및 JWKS](https://docs.didit.me/ko/authentication/tokens-and-jwks.md)를 참조하십시오.

## 네이티브 SDK 출시 미리보기

네이티브 Authentication 모듈은 자동 기기 신호와 함께 로그인, 현재 세션 접근, 토큰 조회, 로그아웃, 스텝업 인증을 제공할 예정입니다. 네이티브 패스키와 보호된 토큰 저장소도 이번 출시에 포함됩니다. 래퍼 API는 공개된 플랫폼 규격을 따릅니다. 설계 예시에서 추측한 생성자 인자나 메서드 시그니처를 복사하지 마십시오.

모듈이 출시되기 전에는 어댑터를 비활성화해 두거나, 활성화된 애플리케이션을 위해 검토를 마친 호스팅 프로토콜 구현을 사용하십시오. 패키지 설치만으로 네이티브 Authentication 빠른 시작이 동작한다고 안내하지 마십시오.

## 인증 및 모니터링 연결

백엔드는 인증된 사용자로부터 `vendor_data`를 도출합니다. 해당 사용자를 위한 인증 세션을 만들거나 범위가 제한된 모니터링 토큰을 발급합니다. 앱에는 세션 자격 증명이나 범위 제한 토큰만 반환하고, API 키는 서버에만 보관하십시오.

신분증 인증이 필요하면 [iOS 인증 SDK](https://docs.didit.me/ko/integration/native-sdks/ios-sdk.md)를 사용하십시오. 플랫폼에서 모니터링을 지원하려면 [SDK 거래 제출](https://docs.didit.me/ko/transaction-monitoring/sdk-transaction-submission.md)을 따르십시오. 로그인, 인증, 거래 결정은 각각 별도로 처리합니다.

## 연동 검증

콜드 스타트 후 앱 복귀, 백그라운드 및 포그라운드 전환, 브라우저 취소, 일치하지 않는 콜백, 코드 재사용, 토큰 만료, 동시 갱신, MFA, 로그아웃, 다른 사용자로 로그인하는 경우를 테스트하십시오. 해당 릴리스가 제공된 후 지원되는 기기에서 패스키 등록과 로그인을 테스트하십시오. 대상 플랫폼에서 실행하기 전까지 기기 전용 검증 항목은 확인되지 않은 상태로 남습니다.


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