ERC-8019 지갑 관리형 SIWE 자동 로그인 (Minimal Wallet-Managed Auto-Login for SIWE)
Review · 서명·인증 · 2025-09-02 작성
믿는 앱에 대해 지갑이 허용 규칙을 미리 저장해 두고 이더리움 로그인(SIWE) 메시지가 규칙과 정확히 맞으면 서명 창 없이 자동으로 로그인 서명을 해 주는 표준입니다.
왜 필요한가
이더리움 로그인(Sign-In With Ethereum, SIWE)은 지갑으로 메시지에 서명해 웹사이트에 로그인하는 방식입니다. 그런데 이미 믿고 쓰는 앱이라도 접속할 때마다 거의 똑같은 로그인 메시지에 서명해 달라는 창이 뜹니다. 사용자는 같은 내용을 반복해서 확인하고 버튼을 눌러야 하므로 번거롭습니다. 반복되는 확인 창은 내용을 읽지 않고 누르는 습관을 만들 수 있습니다. 사실 사용자는 앱에 처음 연결할 때 이미 지갑에서 그 앱을 믿을지 확인하는 절차를 거칩니다. 이 표준은 그 신뢰 결정을 로그인에도 이어 쓰자는 제안입니다. 지갑 안에만 존재하는 간단한 허용 목록(allowlist)을 정의하고 들어온 로그인 메시지가 명확한 일치 규칙을 모두 통과할 때에만 묻지 않고 서명할 수 있게 합니다. 정책은 지갑과 사용자만 만들고 관리하며 앱은 영향을 줄 수 없습니다.
구현해야 하는 것
wallet_getCurrentAutoLoginPolicy: 매개변수 없이 호출하면 호출한 앱에 대한 현재 자동 로그인 정책 객체를 activePolicy로 돌려줍니다. 이 표준이 꺼져 있거나 해당 앱의 정책이 없으면 null을 돌려줘야 합니다.
심층 설명
허용 정책(allow-policy)의 구조
정책 하나는 여섯 개 필드로 이뤄집니다. domain은 SIWE 메시지의 domain과 정확히 일치해야 하는 값, uriPrefix는 SIWE URI가 반드시 이 값으로 시작해야 하는 접두사, allowedChains는 허용하는 chainId 목록, allowedResources는 허용 리소스 집합, supportsEIP6492는 하드웨어 지갑 계정일 때 처리 방식을 정하는 플래그, expiresAt은 정책이 만료되는 UNIX 타임스탬프입니다. expiresAt이 0이면 만료가 없습니다. 예시에서는 domain이 example.com, allowedChains가 [1]과 같이 쓰입니다.
자동 서명 규칙 다섯 가지
파싱된 SIWE 메시지 M에 대해 지갑은 다음이 모두 성립할 때에만 자동 서명할 수 있습니다(MAY). 1) M.domain이 policy.domain과 같을 것, 2) M.uri가 policy.uriPrefix로 시작할 것, 3) M.chainId가 있으면 policy.allowedChains에 포함될 것, 4) policy.allowedResources가 비어 있지 않으면 M.resources 집합이 그 부분집합일 것(순서 무관), 그렇지 않으면 리소스가 전혀 허용되지 않음, 5) policy.expiresAt이 0이 아니면 현재 시각이 그보다 앞설 것. 그 외 논스 고유성, 시간 유효성, 서명 도메인 바인딩 같은 ERC-4361의 검증은 그대로 지갑이 반드시 수행해야 합니다.
정책은 지갑 안에서만 관리됩니다
정책의 생성, 조회, 수정, 삭제는 오직 지갑 UI 안에서만 이뤄지고 사용자에게 어느 정도의 제어권을 줄지는 지갑이 정합니다. 권장 방식은 두 가지입니다. 인기 앱에 대한 기본 정책 목록을 내장하는 것과, 안전하다고 판단한 앱에 대해 첫 SIWE 서명 때 사용자 동의를 받아 정책을 자동 생성하는 것입니다. 후자의 경우 일반 서명 흐름 대신 "앱 X가 계정으로 로그인하려 합니다"라는 안내와 "앞으로 이 앱에 자동 로그인" 체크박스를 보여 주는 흐름이 됩니다. 앱이 정책 생성에 영향을 주는 힌트나 헤더는 존재하지 않습니다.
하드웨어 지갑과 supportsEIP6492
하드웨어 지갑 계정에서는 사용자가 맥락 없이 기기에서 서명을 요구받으므로 자동 서명이 성립하지 않습니다. 그래서 supportsEIP6492 필드를 둡니다. 이 값이 false면 계정의 기본 서명자가 하드웨어 지갑일 때 자동 로그인을 해서는 안 됩니다(MUST NOT). 앱이 스마트 컨트랙트 서명을 검증할 방법이 없기 때문입니다. true면 1) 계정에 EIP-7702를 적용할 수 있거나 계정이 스마트 계정이고, 2) 자동 로그인만을 위한 제한된 범위의 세션 키나 위임을 승인할 수 있을 때, 기기 확인 없이 로그인 서명을 생성할 수 있습니다(MAY). 다만 EIP-7702 적용과 세션 키 설정 자체는 사용자 확인이 필요하며 세션 키 관리 방식은 이 ERC의 범위 밖이고 ERC-7710을 쓸 수 있습니다.
RPC 메서드 wallet_getCurrentAutoLoginPolicy
지갑은 이 RPC 메서드를 구현할 수 있습니다(MAY). 매개변수가 없고 호출한 앱에 대한 현재 정책을 담은 객체를 돌려줍니다. 응답의 activePolicy에는 활성 정책 객체가 들어가거나 null이 들어갑니다. 이 ERC가 지갑에서 비활성화되어 있거나 호출한 앱에 대한 활성 정책이 없으면 activePolicy로 반드시 null을 돌려줘야 합니다. 정책이 만료되었거나 앱이 허용되지 않은 체인에 연결된 경우에도 null을 돌려주는 것이 권장됩니다. 앱은 이 응답으로 사용자 조작 없이 로그인 요청을 스스로 시작할 수 있는지 판단합니다.
하위 호환성과 설계 근거
하위 호환성이 이 ERC의 주요 목표입니다. ERC-4361을 그대로 쓰기 때문에 기존 앱은 아무것도 바꿀 필요가 없습니다. 다만 이 ERC를 온전히 활용하려면 앱이 사용자의 로그인 버튼 클릭을 기다리는 대신 wallet_getCurrentAutoLoginPolicy를 써서 로그인 요청을 스스로 시작해야 합니다. 설계 근거로는, 어떤 앱에 이 정책을 허용할지 판단하는 일을 지갑에 맡기는 편이 보안상 훨씬 쉽다는 점을 듭니다. 대부분의 지갑이 이미 신뢰 앱 목록을 관리하고 있기 때문입니다. EIP-712 타입드 데이터는 SIWE가 일반 텍스트 기반이므로 범위 밖입니다.
현재 상태는 Review입니다
이 제안은 아직 검토(Review) 단계에 있습니다. 표준으로 확정되기 전이므로 정책 필드나 규칙 같은 세부 내용이 논의 과정에서 바뀔 수 있습니다.
쓸 때 주의할 점
- 자동 로그인은 기본값으로 꺼 두기: 지갑 UI에서 자동 로그인은 기본적으로 꺼져 있고 사용자가 믿는 사이트에 대해 직접 켜는 방식이 권장됩니다.
- 표준 SIWE 검증은 그대로 수행: 자동 서명을 하더라도 새 논스 확인, 올바른 도메인 바인딩, 시간 유효성 같은 표준 SIWE 검사는 계속 수행해야 합니다.
- uriPrefix는 구체적으로: uriPrefix를 /login처럼 구체적으로 유지해 지나치게 넓은 범위가 일치하는 일을 피해야 합니다.
- 전체 끄기 설정 제공: 각 지갑에 이 ERC 자체를 비활성화할 수 있는 최상위 설정을 두는 것이 권장됩니다.
- iframe을 통한 악용 방지: M.domain은 항상 각 앱의 최상위 출처(top-level origin)와 비교해야 합니다. 악의적인 최상위 출처에 포함된 iframe 안에서 자동 로그인이 동작하는 것을 막기 위해서입니다.