Naru

시스템과 인증

레거시 시스템을 환경(dev/prod)마다 등록하고, 인증 plugin을 차례로 엮어 로그인·서명·세션 갱신을 맡겨요.

시스템

시스템은 레거시 하나의 주소, driver, 자격 방식, 인증 체인이에요. pack은 시스템의 이름과 driver만 선언하고, 주소와 인증은 관리자가 환경(dev/prod)마다 등록해요.

관리 → 시스템 → 그룹웨어. 기본 정보, 접속 정보, 인증 체인을 고쳐요.관리 → 시스템 → 그룹웨어. 기본 정보, 접속 정보, 인증 체인을 고쳐요.
관리 → 시스템 → 그룹웨어. 기본 정보, 접속 정보, 인증 체인을 고쳐요.
항목 뜻
slug, env 이름과 환경. 같은 slug를 dev와 prod에 따로 둬요
driver http, soap, sql(PostgreSQL, MySQL, SQL Server, Oracle, SQLite), jdbc(Tibero, Altibase, CUBRID, DB2: Java sidecar)
endpoint baseUrl과 연결 확인 경로 probe(SQL은 dialect, 호스트·DB 또는 url)
transport charset(EUC-KR 등), readOnly, tls, proxy, 보호 설정
mode service, onbehalf, personal
serviceAccount 공용 연계 계정(service, onbehalf)
accounts 사람의 레거시 계정을 정하는 법: employeeNo(기본), email, emailLocal, userId, table(관리자가 올리는 대응표)
auth 인증 plugin을 순서대로

비밀값은 시스템 설정에 넣지 않고 따로 넣어요. 화면의 시스템 비밀값 저장이나 naru-admin systems secret <id> <이름>(값은 표준 입력)이에요. API·화면·로그에 다시 나오지 않아요.

연결 확인(naru-admin systems test <id>)은 실제로 로그인하고 확인 요청을 보내 봐요.

인증 plugin

plugin 쓰임
none 인증 없음(나가는 IP 허용만으로)
static-header API 키, 고정 토큰
basic HTTP Basic
onbehalf 공용 계정 + 부른 사람의 사번을 헤더·SOAP 헤더·DB 세션에
login-flow 웹 로그인: 다단계 폼, CSRF, EUC-KR, SSO redirect, 쿠키, 만료 감지
token-endpoint 사내 로그인 API → JSON 경로 → 헤더
oauth2-client-credentials OAuth 2 클라이언트 자격
oauth2-code 각자 레거시 OAuth에 로그인(personal)
hmac-signature 요청 서명(대외계, API GW). KST 타임스탬프
ws-security SOAP UsernameToken
db-password DB 계정 비밀번호
ntlm Windows 통합 인증
kerberos SPNEGO(Java sidecar, keytab)
관리 → 인증 plugin. 내장 plugin과 승인한 코드 plugin.관리 → 인증 plugin. 내장 plugin과 승인한 코드 plugin.
관리 → 인증 plugin. 내장 plugin과 승인한 코드 plugin.

설정은 템플릿이에요: {{account.id}}, {{user.id}}, {{secret.password}}, {{principal.employeeNo}}, 앞 단계에서 뽑은 값({{csrf}}), 필터(|base64, |sha256, |urlencode …).

토큰 + 서명 + 사번 (ERP REST)
auth:
  - plugin: token-endpoint
    config: { request: { url: /auth/token, json: { clientId: "{{account.id}}", clientSecret: "{{secret.client_secret}}" } }, token: { json: data.accessToken }, expiresIn: data.expiresIn }
  - plugin: hmac-signature
    config: { timestamp: { format: yyyyMMddHHmmss, timezone: Asia/Seoul } }
  - plugin: onbehalf
    config: { header: X-EMP-NO }

코드 plugin

선언으로 안 되는 인증(예: 로그인 페이지의 RSA 공개키로 비밀번호를 암호화)은 코드 plugin으로 써요. 한 파일로 번들해 NARU_PLUGINS_DIR에 두면, 관리자가 그 digest를 승인해야 로드돼요. 파일이 바뀌면 다시 보류돼요. 예: examples/plugins/rsa-form-login.

사람의 계정 잇기 (personal)

personal 시스템은 사람마다 자기 계정을 써요. 아직 잇지 않은 사람이 도구를 부르면 auth_required와 연결 주소(/connect/<시스템>)가 와요(URL elicitation을 지원하는 클라이언트에는 JSON-RPC -32042로). 사람은 나루 홈의 내 계정 연결에서 계정을 넣고, 나루가 그 자리에서 로그인해 보고 맞을 때만 저장해요.

나루 홈. 사내 시스템을 AI 도구로 쓰는 주소와 내 계정 연결.나루 홈. 사내 시스템을 AI 도구로 쓰는 주소와 내 계정 연결.
나루 홈. 사내 시스템을 AI 도구로 쓰는 주소와 내 계정 연결.

레거시 보호

설정 기본
maxConcurrency 8 (넘으면 기다려요)
ratePerMinute 600
breaker 연속 5회 실패 시 30초 쉼
timeoutMs 30초

배치 시간대처럼 약한 시스템은 낮춰요. 출력은 스키마 검사, 크기 한도(기본 512 KiB), 마스킹을 거쳐요.

Esc