본문으로 건너뛰기

서비스 계정 관리

개요​

이 화면은 무엇인가요?

이 화면에서는 서비스 계정 관리 데이터를 등록하고 관리합니다. 계정유형(API_KEY, SERVICE_PRINCIPAL, BOT, SYSTEM 등)별로 분류할 수 있으며, 상태(활성 → 비활성 → 만료 → 잠금)를 추적합니다.

누가 사용하나요?​

  • IT관리자: 서비스 계정 관리 설정, 권한 관리
  • IAM담당: 서비스 계정 관리 계정 관리, SSO 설정
  • 보안담당: 서비스 계정 관리 정책 수립, 사고 대응

언제 사용하나요?​

  • 신규 서비스 계정 관리 데이터를 등록할 때
  • 기존 서비스 계정 관리 정보를 수정하거나 이력을 확인할 때
  • 서비스 계정 관리의 상태를 변경하거나 진행 현황을 추적할 때

주요 기능​

  • 등록·조회: 서비스 계정 관리 데이터의 신규 등록 및 목록 조회
  • 유형별 분류: 계정유형(API_KEY , SERVICE_PRINCIPAL , BOT 등)별 분류 및 필터
  • 상태 추적: 상태 변경 이력 관리 및 현황 확인
  • 감사 추적: 데이터 변경 이력 자동 기록

업무 흐름에서의 위치​

입력 항목 가이드​

항목설명필수입력 예시
계정코드고유 식별 코드✅ACCOUNT-CODE-001
계정명식별하기 쉬운 이름✅(이름 입력)
설명식별하기 쉬운 이름자유 텍스트 입력
계정유형분류 구분✅API_KEY / SERVICE_PRINCIPAL / BOT
소유자시스템 users 테이블 참조✅목록에서 선택
부서관련 데이터 선택목록에서 선택
권한권한자유 텍스트 입력
API키해시API키해시텍스트 입력
최종사용시각최종사용시각2026-03-17 09:00
만료시각만료시각2026-03-17 09:00
상태현재 진행 상태✅활성 / 비활성 / 만료
IP화이트리스트IP화이트리스트자유 텍스트 입력
키교체주기(일)키교체주기(일)숫자 입력
최종키교체시각최종키교체시각2026-03-17 09:00

자주 묻는 질문 (FAQ)​

상태를 변경할 수 없습니다. 왜 그런가요?

워크플로우가 설정된 경우, 정해진 순서대로만 상태를 변경할 수 있습니다. 현재 상태에서 변경 가능한 다음 상태만 선택할 수 있으며, 필수 입력 항목이 누락되어 있지 않은지 확인해 주세요.

서비스 계정 관리 데이터를 대량으로 등록하려면 어떻게 하나요?

CSV 가져오기 기능을 사용합니다. 먼저 CSV 내보내기로 템플릿을 다운로드한 후, 템플릿에 맞춰 데이터를 입력하고 CSV 가져오기로 일괄 등록합니다.

실무 시나리오​

신규 서비스 계정 관리 등록​

상황: 새로운 서비스 계정 관리 데이터를 등록해야 합니다.

처리 순서:

  1. 계정코드를 입력하여 신규 데이터를 생성합니다
  2. 계정유형을 API_KEY으로 선택합니다
  3. 계정명을(를) 입력합니다
  4. 상태를 활성으로 설정합니다
  5. 저장하여 등록을 완료합니다
참고: 데이터 구조

테이블: service_accounts

컬럼명한글명타입설명
account_code계정코드VARCHAR*필수
account_name계정명VARCHAR*필수
description설명TEXT
account_type계정유형API_KEY / SERVICE_PRINCIPAL / BOT / SYSTEM / INTEGRATION*필수
owner_id소유자UUID*필수 시스템 users 테이블 참조
department_id부서UUID
permissions권한TEXT
api_key_hashAPI키해시VARCHAR
last_used_at최종사용시각TIMESTAMP
expires_at만료시각TIMESTAMP
status상태활성 / 비활성 / 만료 / 잠금*필수
ip_whitelistIP화이트리스트TEXT
rotation_interval_days키교체주기(일)INT
last_rotated_at최종키교체시각TIMESTAMP

데이터 관계​