ERC-5573 이더리움 로그인 권한 위임, 리캡 (Sign-In with Ethereum Capabilities, ReCaps)

Draft · 서명·인증 · 2021-07-20 작성

이더리움 계정으로 로그인(SIWE)할 때 서명 한 번으로, 서비스가 내 계정을 대신해 다른 서비스에서 할 수 있는 행동의 범위까지 명시적으로 위임할 수 있게 합니다.

왜 필요한가

이더리움 로그인 표준(ERC-4361, SIWE)은 이더리움 계정이 오프체인 서비스에 자신을 인증하는 방법만 정합니다. 그런데 로그인한 뒤에는 그 서비스가 사용자를 대신해 제3의 서비스와 상호작용해야 하는 경우가 많습니다. 예를 들어 사용자의 데이터를 보관해 주는 저장 서비스에 접근하는 경우입니다. 지금까지는 인증된 계정이 이런 권한을 서비스에 넘겨주는 표준적인 방법이 없었습니다. 그래서 인증과 인가를 따로 처리해야 해 사용자 절차가 늘어나고 사용자가 무엇을 허락하는지 명확히 알기 어려웠습니다. 이 제안(리캡, ReCap)은 SIWE 서명 메시지 위에 사람이 읽을 수 있는 동의 문장과 기계가 검증할 수 있는 권한 객체를 함께 얹어 사전 동의(informed consent)에 기반한 권한 위임을 가능하게 합니다.

심층 설명

SIWE 메시지 위의 확장 구조

리캡은 ERC-4361 메시지의 특정 형식입니다. 리캡 권한(ReCap Capability)은 SIWE 메시지 Resources 배열의 마지막 항목으로 들어가야 하며 그 내용은 번역 알고리즘을 통해 사람이 읽을 수 있는 형태로 statement 필드에 결정적으로 변환되어야 합니다. SIWE의 기존 필드가 권한 범위를 한정하는 데 쓰입니다. URI 필드는 위임 대상인 신뢰 당사자(예: https://example.com, did:key:...)를 지정해야 합니다. Issued At은 권한 발급 시각, Expiration Time이 있으면 권한 만료 시각, Not Before가 있으면 그 시각 이후부터 리소스 서비스가 권한 행사를 받아들입니다.

리캡 URI 스킴

리캡 URI는 urn:recap: 뒤에 리캡 상세 객체(ReCap Details Object)를 패딩 없는 base64url로 인코딩한 값을 붙인 형태입니다. base64url은 RFC4648의 URL·파일명 안전 알파벳을 쓰는 Base 64 인코딩입니다. 리캡 URI가 존재한다면 반드시 SIWE 자원 목록의 마지막 항목을 차지해야 합니다.

능력 문자열(Ability String)

능력 문자열은 네임스페이스 안의 행동을 식별하며 <namespace>/<ability> 형태로 직렬화합니다. 네임스페이스와 능력 이름에는 영숫자와 . * _ + - 문자만 쓸 수 있고 전체 문자열은 ^[a-zA-Z0-9.*_+-]+\/[a-zA-z0-9.*_+-]+$ 정규식을 따라야 합니다. 예를 들어 crud/update는 네임스페이스가 crud, 능력 이름이 update입니다.

리캡 상세 객체: att와 prf

att 필드는 각 키가 자원 URI이고 값은 능력 문자열을 키로, 그 행동에 대한 제한이나 요구 조건(qualification) 객체의 배열을 값으로 갖는 객체입니다. 키는 사전순으로 정렬해야 하며 바이트 값으로 정렬하되 한 문자열이 다른 문자열로 시작하면 짧은 쪽이 앞에 옵니다(msg/send가 msg/send-to보다 앞). 자바스크립트 Array.sort()와 같은 방식이고 중복 키는 금지됩니다. 배열 안의 빈 객체는 제한 없이 행동할 수 있다는 뜻이고 객체가 하나도 없는 빈 배열은 그 능력을 유효하게 쓸 방법이 없다는 뜻입니다. prf 필드는 Base58로 인코딩된 CID 문자열 배열로, SIWE 주소가 att 항목의 통제자가 아닐 때 그 권한을 뒷받침하는 부모 권한을 가리킵니다. 제한 데이터의 구조와 의미를 정하는 책임은 리소스 서비스에 있습니다.

권한 객체 병합

두 리캡 객체는 필드 내용의 정렬 규칙을 지키는 한 각 필드 요소를 재귀적으로 이어 붙여 하나로 병합할 수 있습니다. 예를 들어 같은 자원에 대한 crud/read 권한과 crud/update 권한을 가진 두 객체를 합치면 그 자원 아래 두 능력이 함께 들어가고 prf 배열도 양쪽 항목을 모두 포함하게 됩니다.

번역 알고리즘: 기계 권한을 사람 문장으로

번역 알고리즘은 리캡 URI 안의 att 내용을 statement 문장으로 바꿉니다. 기존 statement가 있으면 그 뒤에 공백 하나를 붙이고 "I further authorize the stated URI to perform the following actions on my behalf:"라는 머리말을 더한 뒤, 자원별로 능력 문자열을 네임스페이스 단위로 묶어 (1)부터 번호를 매긴 항목을 이어 붙입니다. 같은 출력을 내는 알고리즘이라면 다른 구현도 허용됩니다. 이 덕분에 서명 문장과 인코딩된 권한 객체가 항상 일치하는지 기계적으로 확인할 수 있습니다.

검증 알고리즘

검증자는 먼저 ERC-4361 서명 검증을 수행합니다. 그다음 메시지의 uri 필드와 resources 마지막 항목의 리캡 URI를 입력으로 번역 알고리즘을 수행하고 메시지의 statement가 그 결과 문자열로 끝나는지 확인해야 합니다. 신뢰 당사자가 리소스 서비스에 자신을 어떻게 인증하는지는 이 명세의 범위 밖이며 리소스 서비스 구현에 달려 있습니다.

아직 초안 단계입니다

이 제안의 상태는 초안(Draft)입니다. 원문의 Rationale과 Implementer's Guide 절도 아직 작성 전(TBD)입니다. 내용이 앞으로 바뀔 수 있다는 점을 감안해야 합니다.

쓸 때 주의할 점

ERC 원문 · ← ERCs