대리 로그인
대리 로그인을 사용하면 권한이 있는 사용자가 다른 사용자로서 작업할 수 있습니다. 해당 사용자에게 보이는 화면을 재현하거나 그 사람을 대신해 어떤 일을 처리할 때 씁니다. 대리 로그인 중에 보낸 모든 요청은 대리 대상 사용자의 것으로 기록되고, 모든 대리 로그인 세션은 따로 기록됩니다. 시작하려면 관리자(또는 슈퍼 관리자) 역할이 필요합니다.
누가 누구로 대리 로그인할 수 있는가
| 수행자 \ 대상 | 슈퍼 관리자 역할 보유 | 관리자 역할 보유 | 그 밖의 사용자 |
|---|---|---|---|
| 슈퍼 관리자 | ❌ | ✅ 플랫폼 전체 | ✅ 플랫폼 전체 |
| 관리자 | ❌ | ❌ | ✅ 자신의 테넌트만 |
| 그 밖의 역할 | ❌ | ❌ | ❌ — 이 동작 자체가 제공되지 않음 |
이 표의 구조가 핵심입니다. 대리 로그인으로는 수행자에게 아직 없는 권한을 얻을 수 없습니다. 일반 관리자는 동료 관리자로 대리 로그인할 수 없고, 슈퍼 관리자는 관리자가 통과할 모든 게이트를 이미 우회하므로 관리자로 대리 로그인해도 얻는 것이 없습니다.
대상은 유효 역할을 기준으로 판단합니다. 따라서 사용자 그룹에서 상속받은 관리자 역할도 직접 부여된 역할과 똑같이 보유자를 보호합니다. 그렇지 않으면 그룹이 위 표를 우회하는 수단이 될 것입니다.
역할과 관계없이 거부되는 대상이 네 가지 더 있습니다. 자기 자신, 초기 생성된 시스템 사용자, 비활성화된 사용자, 소프트 삭제된 사용자입니다. 또한 관리자의 경우 다른 테넌트의 대상에는 HTTP 403이 아니라 HTTP 404로 응답합니다. 테넌트를 넘나드는 참조로는 해당 사용자의 존재를 절대 확인할 수 없습니다.
시작과 중지
사용자 목록의 대리 로그인 동작에서 시작합니다. 확인하면 해당 사용자로 작업하는 상태에서 환영 페이지가 열립니다. 대리 로그인이 활성화된 동안에는 헤더 칩에 "<user>(으)로 작업 중"과 대리 로그인 중지 버튼이 표시됩니다.
대리 로그인은 한 번에 하나만 열려 있을 수 있습니다. 새로 시작하면 이전에 열려 있던 대리 로그인이 닫힙니다. 중지는 열려 있는 대리 로그인이 없을 때 호출해도 항상 안전합니다.
유효 신원
대리 로그인은 세션 교체가 아니라 요청 헤더 재정의입니다. 실제 세션 쿠키는 절대 바뀌지 않습니다. 브라우저는 선택한 사용자 ID를 각 요청에 붙이기만 하고, 백엔드는 이 ID에서 유효 신원을 확인합니다. 그 결과는 두 가지입니다.
- 실제 수행자의 세션이 그대로 유지되므로, 중지할 때 다시 로그인할 필요가 없습니다.
- 요청이 건드리는 모든 것, 즉 읽기와 쓰기, 그리고 감사용
createdBy/updatedBy필드는 대리 대상 사용자가 직접 로그인한 것과 똑같이 그 사용자의 것으로 기록됩니다. 역할 검사도 대리 대상 사용자의 유효 역할을 기준으로 실행됩니다. 따라서 요청자로 대리 로그인한 슈퍼 관리자에게는 요청자의 게이트가 적용되고, 요청자에게 보이는 UI가 보입니다.
시작 및 중지 엔드포인트는 의도적인 예외입니다. 이 둘은 유효 신원이 아니라 실제 수행자의 역할로 게이트를 판단합니다. 그렇지 않으면 일부러 권한이 없는 사용자로 대리 로그인한 관리자가 자신의 "중지" 호출에서 역할 검사에 실패해 그 상태에서 벗어나지 못하게 됩니다.
대리 로그인이 더 이상 유효하지 않을 때
자격은 대리 로그인을 시작할 때뿐 아니라 모든 요청에서 다시 확인합니다. 위 표는 역할에 따라 달라지고, 역할은 바뀌기 때문입니다. 대리 로그인이 더 이상 유효하지 않으면 요청은 실패하지 않습니다. 조용히 실제 수행자로 되돌아가고 유효하지 않은 기록을 닫습니다. 대상이 비활성화되거나 삭제된 경우, 대상이 승격된 경우(관리자 역할을 부여하는 그룹에 추가된 경우 포함), 수행자가 관리자 역할(직접 또는 이를 부여하는 그룹을 떠나서) 또는 슈퍼 관리자 역할을 잃은 경우, 수행자와 대상이 더 이상 같은 테넌트에 속하지 않는 경우, 다른 곳에서 대리 로그인이 중지된 경우가 여기에 해당합니다.
요청을 실패시키는 쪽이 오히려 훨씬 나쁩니다. 선택 값이 브라우저의 로컬 스토리지에 있으므로, 오류를 내면 유효하지 않은 값 하나 때문에 정당한 관리자가 애플리케이션 전체에서 차단될 수 있습니다.
감사 추적
모든 대리 로그인 세션은 누가, 누구로, 언제 대리 로그인했는지를 impersonation_events 테이블의 영구 감사 추적에 기록합니다(구성 참조 페이지 참고). createdBy / updatedBy에는 대리 대상 사용자가 기록되므로 "그 쓰기의 실제 수행자는 누구인가?"에 답할 수 있는 것은 이 추적뿐이며, 바로 그 때문에 선택 사항이 아닙니다.
관리자는 감사 로그의 대리 로그인 탭에서 이 추적을 읽을 수 있습니다. 이 탭에는 슈퍼 관리자가 연 세션을 포함해 해당 테넌트의 계정과 관련된 모든 세션이 나열됩니다.