도메인 관리 가이드

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 상세 사양은 별도 가이드를 참조하세요.

📘 API 레퍼런스 개요 (v1.2)

문제 해결

증상	원인	해결
"로그인이 필요합니다" 메시지	세션이 없거나 만료됨	다시 로그인한 뒤 페이지를 새로고침합니다.
도메인 추가 시 "프로젝트(CSN)가 없습니다"	세션에 프로젝트가 선택되어 있지 않음	프로젝트를 먼저 선택한 뒤 다시 시도합니다.
도메인은 추가됐으나 등록업체·날짜가 비어 있음	whois 자동조회에 실패함	해당 행의 [whois] 버튼을 다시 누르거나 [수정]으로 직접 입력합니다.
상태가 "날짜 없음"으로 표시됨	만료일 정보가 없음	[whois]로 조회하거나 [수정]에서 만료일을 입력합니다.
whois 조회가 "저장할 데이터가 없음"으로 끝남	whois 응답에 영속화할 정보가 없음	도메인명을 확인하거나 [수정]으로 값을 직접 입력합니다.

---

버전: 1.0 최종 업데이트: 2026-07-22 소스 파일: giipv3/public/help/domains.ko.md