도메인 관리 가이드
GIIP 플랫폼에서 DNS 도메인(등록한 인터넷 도메인)을 등록하고 whois 정보와 만료일을 추적하는 방법을 안내합니다.
📋 개요
도메인 관리는 회사가 보유한 DNS 도메인을 한 곳에서 등록·추적하는 화면입니다. 도메인명만 입력하면 whois(RDAP)에서 등록업체·등록일·만료일·등록기관 URL을 자동으로 채우고, 만료일까지 남은 일수를 D-day 배지로 표시하여 갱신 시점을 놓치지 않도록 돕습니다.
목록은 로그인 세션에 설정된 프로젝트(CSN) 범위로 조회되며, 서버에서 소속 관계를 다시 검증합니다. 이용하려면 로그인이 필요합니다.
🔍 주요 기능 설명
1. 도메인 목록
등록된 도메인이 표로 표시됩니다. 각 열의 의미는 다음과 같습니다.
- 도메인(Domain): 도메인명. 등록기관 URL이 설정되어 있으면 클릭 시 새 탭으로 열립니다.
- 등록업체(Registrar): 도메인을 등록한 업체명.
- 등록일(Registered): 도메인 등록일.
- 만료일(Expires): 도메인 만료일.
- 상태(Status): 만료까지 남은 일수 배지(아래 참조).
- 프로젝트(Project): 도메인이 속한 프로젝트(조직명 또는 CSN).
- 작업(Actions): whois / 수정 / 삭제 버튼.
2. 만료 상태 배지
만료일까지 남은 일수에 따라 배지 색상이 달라집니다.
- 만료됨(Expired) (빨강): 만료일이 이미 지남.
- D-{일수} (주황): 만료까지 30일 이하 남음. 갱신을 준비하세요.
- D-{일수} (초록): 만료까지 30일을 초과해 여유가 있음.
- 날짜 없음(No date) (회색): 만료일 정보가 없음. whois를 조회하거나 수동으로 입력하세요.
3. 도메인 추가
우측 상단 [+ 도메인 추가] 버튼을 누르면 입력창이 열립니다. 도메인명만 입력하면(예: example.com) 등록 후 자동으로 whois를 조회하여 등록업체·등록일·만료일·URL을 채웁니다. whois 조회에 실패하더라도 도메인은 이미 등록된 상태이므로, 이후 [whois] 버튼이나 [수정]으로 정보를 보완할 수 있습니다.
4. whois 리프레시
각 행의 [whois] 버튼을 누르면 해당 도메인의 whois를 다시 조회하여 최신 등록정보와 만료일로 갱신합니다. .kr/.co.kr 도메인은 whois.kr을, 그 외 도메인은 RDAP를 사용합니다. 조회 결과가 있으면 자동으로 저장됩니다.
5. 수정
[수정] 버튼을 누르면 등록업체, 등록일, 만료일, 등록기관 URL을 직접 편집할 수 있습니다. 수정 모달 안에서도 [whois 조회] 버튼으로 값을 다시 채울 수 있습니다.
6. 삭제
[삭제] 버튼을 누르면 확인 후 도메인을 목록에서 제거합니다(소프트 삭제).
🛠️ 활용 팁
- 프로젝트(CSN) 필요: 도메인 추가는 세션에 프로젝트(CSN)가 설정되어 있어야 합니다. 프로젝트를 먼저 선택하세요.
- 새로고침: 우측 상단 [새로고침] 버튼으로 목록을 다시 불러옵니다.
- 입력 간소화: 추가 시 등록업체·날짜·URL을 직접 입력할 필요 없이 whois 자동채움에 맡기는 것이 가장 빠릅니다.
💡 유의 사항
- 이 화면의 "도메인"은 DNS 도메인(등록한 인터넷 도메인)이며, 네트워크 노드와는 무관합니다.
- 목록이 비어 있으면 상단 [+ 도메인 추가] 버튼으로 첫 도메인을 등록하세요.
API 참조
이 기능의 API 상세 사양은 별도 가이드를 참조하세요.
문제 해결
| 증상 | 원인 | 해결 |
|---|---|---|
| "로그인이 필요합니다" 메시지 | 세션이 없거나 만료됨 | 다시 로그인한 뒤 페이지를 새로고침합니다. |
| 도메인 추가 시 "프로젝트(CSN)가 없습니다" | 세션에 프로젝트가 선택되어 있지 않음 | 프로젝트를 먼저 선택한 뒤 다시 시도합니다. |
| 도메인은 추가됐으나 등록업체·날짜가 비어 있음 | whois 자동조회에 실패함 | 해당 행의 [whois] 버튼을 다시 누르거나 [수정]으로 직접 입력합니다. |
| 상태가 "날짜 없음"으로 표시됨 | 만료일 정보가 없음 | [whois]로 조회하거나 [수정]에서 만료일을 입력합니다. |
| whois 조회가 "저장할 데이터가 없음"으로 끝남 | whois 응답에 영속화할 정보가 없음 | 도메인명을 확인하거나 [수정]으로 값을 직접 입력합니다. |
버전: 1.0
최종 업데이트: 2026-07-22
소스 파일: giipv3/public/help/domains.ko.md