인증
로그인 방식과 접속 제한을 정하는 화면입니다. 관리자 IP 허용 목록, 외부 인증 Provider 활성화, 모든 세션 강제 로그아웃을 한 화면에서 설정합니다. Provider별 등록은 별도 문서에서 다룹니다.
이 페이지 목차
위치: 관리자 > 운영 > 인증 (/admin/auth, 화면 제목 "인증 설정")
화면 설명 문구: "관리자 IP 제한 / 외부 인증 provider / 세션 강제 로그아웃. 잘못 설정되어 잠겨도 CLI admin:reset-password 로 복구할 수 있습니다."
IP 허용 목록을 비우면 락아웃되고, 외부 Provider를 활성화하면 일반 사용자는 그 Provider로만 로그인합니다. 잘못 설정해 잠긴 경우 화면 안내에 따라 CLI admin:reset-password로 복구할 수 있으니, 서버에서 CLI를 실행할 담당자가 있는지 먼저 확인하세요.
화면 구성
- 1관리자 IP allowlist 잘못 입력하면 관리자도 로그인하지 못합니다. 입력 방법은 아래 관리자 IP allowlist에서 다룹니다.
- 2외부 인증 Provider 등록을 마친 Provider만 활성화할 수 있습니다. 자세한 내용은 아래 외부 인증 Provider에서 다룹니다.
- 3Provider 등록 카드 저장한 뒤 2번에서 활성화해야 로그인 방식이 바뀝니다. 연결 정보 입력은 외부 인증 Provider 등록에서 다룹니다.
- 4모든 세션 강제 로그아웃 실행 전에 사용자에게 알리고 시점을 정하세요.
관리자 IP allowlist
0.0.0.0/0 이면 전부 허용. 비워두면 락아웃되니 주의./admin/*) 도 같은 allowlist 로 제한. 기본은 OFF — 켤 경우 사용자 화면에서 admin 으로 이동도 IP 검사.- 1현재 IP 허용 대역을 저장하기 전에 이 IP가 들어가는지 확인합니다.
- 2CIDR (줄당 1개)
10.0.0.0/8처럼 대역으로 적습니다. 비워 두면 락아웃됩니다.
입력한 뒤 저장을 누릅니다.
목록을 비워 두면 락아웃됩니다. 저장하기 전에 화면의 현재 IP가 입력한 대역에 포함되는지 확인하세요.
2단계 인증 (인증 앱)
아이디·비밀번호로 로그인할 때 인증 앱 코드를 한 번 더 확인하게 해서, 비밀번호가 새어 나가도 계정을 지킵니다.
대상자가 처음 로그인하면 등록 화면(앱 설치 → QR 스캔 → 코드 확인)이 자동으로 뜹니다.
휴대폰을 잃어버린 사용자는 사용자 관리 → 사용자 상세의 「2단계 인증 초기화」로 재등록하게 합니다. 관리자 전원이 잠기면 서버에서 imctl mfa policy off 또는 imctl mfa reset <로그인ID>.
서버 시계가 정확해야 합니다(NTP). 30초 오차까지 허용합니다.
모바일 앱 로그인에는 아직 적용되지 않습니다.
- 1등록 완료 인원 필수로 바꾸기 전에 이미 몇 명이 등록했는지 봅니다.
- 적용 대상을 고릅니다. 처음에는 관리자만 필수로 시작해 보고 넓히는 방법을 권합니다.
- 필요하면 인증 앱 표시 이름을 바꿉니다.
- 저장을 누릅니다.
휴대폰을 잃어버린 사용자는 사용자 상세의 2단계 인증 초기화로 다시 등록하게 합니다.
외부 인증 Provider
이 카드에서 일반 사용자가 쓸 로그인 방식을 하나 골라 활성화합니다.
/login 접속 즉시 /api/auth/<provider>/start 로 navigate. 비상시 /login/admin 으로 로컬 로그인 가능.- 1Provider 선택 등록 카드에서 저장한 뒤 여기서 활성화해야 로그인 방식이 바뀝니다.
- 2모바일 로그인 방식 목록에는 자동 / 로컬 비밀번호 / LDAP / Microsoft (브라우저 SSO)가 있습니다.
값을 바꾸면 적용 버튼이 활성화됩니다.
각 Provider 등록 카드에는 "저장과 활성화는 별개"라고 안내되어 있습니다. 등록 카드에서 저장한 뒤, 위쪽 "외부 인증 provider"에서 해당 Provider를 활성화해야 로그인 방식이 바뀝니다.
Provider 등록
Provider별 연결 정보(Microsoft Entra, LDAP, Pentasecurity ISign+, HTTP Auth, SAML 2.0)는 외부 인증 Provider 등록에서 등록합니다.
모든 세션 강제 로그아웃
화면 안내: "외부 provider 전환 / 보안 이슈 의심 시 사용. session_epoch 을 현재 시각으로 bump 해서 그 이전 발급된 모든 JWT 를 거부합니다."
모두 강제 로그아웃은 실행 시각 이전에 발급된 모든 로그인 세션(JWT)을 거부합니다. 실행 전에 사용자에게 알리고 시점을 정하세요.
설정 후 확인
- 관리자 IP 허용 목록을 바꿨다면, 현재 창을 닫지 않은 채 다른 브라우저 창에서 관리자 로그인이 되는지 확인합니다.
마지막 수정: