Platform Docs

Appearance

제한 열람 운영자 매뉴얼 — 디렉토리 서비스 자격증명 ​

보안 등급: 제한 열람. 이 문서는 일반 소스 저장소·배포 산출물·공개 협업 문서에 포함하지 않는다. 운영 책임자와 승인된 시스템 관리자만 열람한다.

1. 보관 원칙 ​

관리자 API Key, Document Library API Key, 프로세스 포털 API Key, JWT 서명 비밀값은 각각 독립된 Secret 관리 저장소에 보관한다. 키 원문은 이 제한 열람 매뉴얼의 해당 칸에만 기록하며, 화면 캡처·티켓 댓글·이메일·소스 코드에는 복사하지 않는다.

자격증명Secret 환경변수소유자권한 범위원문 기록 위치
Directory 관리자 API KeyPORTAL_CONSOLE_ADMIN_API_KEYS_JSON중앙 Directory 운영자관리 화면·관리 tRPC API아래 2절
Document Library 포털 API KeyPORTAL_API_KEYS_JSONDocument Library 운영자directory:read, directory:sync, authorization:sync아래 2절
프로세스 포털 API KeyPORTAL_API_KEYS_JSON프로세스 포털 운영자directory:read, directory:sync, authorization:sync아래 2절
포털 JWT 서명 비밀값PORTAL_JWT_SECRET중앙 Directory 보안 책임자포털 JWT 검증아래 2절

2. 현재 자격증명 원문 ​

이 절은 운영 책임자가 Secret 관리 시스템에서 확인한 값만 기록한다. 이 프로젝트의 소스 저장소에는 원문을 남기지 않는다.

자격증명발급 일시만료·재검토 일시현재 원문보관 확인자
Directory 관리자 API Key<기입><기입><제한 열람 원문 기입><기입>
Document Library 포털 API Key<기입><기입><제한 열람 원문 기입><기입>
프로세스 포털 API Key<기입><기입><제한 열람 원문 기입><기입>
포털 JWT 서명 비밀값<기입><기입><제한 열람 원문 기입><기입>

3. 정상 사용 절차 ​

관리자는 관리 화면에서 x-directory-admin-key 헤더에 Directory 관리자 API Key를 전달한다. Document Library과 프로세스 포털은 Authorization: Bearer <포털 API Key>를 사용한다. 각 포털은 중앙 사용자·부서 조회 후 자신의 내부 그룹·역할·권한을 관리하고, 변경된 권한 현황만 POST /api/directory/v1/authorization-snapshot으로 발행한다.

4. 정기 교체 절차 ​

  1. Secret 관리 시스템에 새 난수 키를 생성하고 발급 일시·담당자를 2절에 기록한다.
  2. 기존 키와 새 키를 짧은 중첩 기간 동안 함께 활성화한다. 포털별 키는 다른 포털에 재사용하지 않는다.
  3. 대상 포털의 사용자 조회와 권한 요약 발행을 새 키로 확인한다.
  4. 기존 키를 비활성화하고, 마지막 사용 여부·폐기 일시·검증자를 변경 기록에 남긴다.
  5. 배포 후 /api/directory/v1/users의 인증 성공, 운영센터 동기화 상태, 감사 로그를 확인한다.

5. 분실·유출 대응 절차 ​

키 유출 또는 분실이 의심되면 해당 키를 즉시 비활성화하고, 같은 포털의 새 키를 발급한다. 유출된 키가 관리자 키인 경우에는 관리 화면 접근을 먼저 차단하고, 포털 키인 경우에는 해당 포털의 directory:read, directory:sync, authorization:sync 호출을 중지한다. 새 키 배포와 호출 확인이 끝난 뒤 감사 로그와 운영센터 상태를 검토하고, 사고 일시·영향 범위·조치·검증자를 변경 기록에 남긴다.

6. 변경 기록 ​

일시자격증명작업사유작업자검증 결과
<기입><기입>발급·교체·폐기<기입><기입><기입>