Domain Management Guide
Learn how to register DNS domains (registered internet domains) on the GIIP platform and track their whois details and expiry dates.
📋 Overview
Domain Management is a single screen for registering and tracking the DNS domains your organization owns. Enter just the domain name and whois (RDAP) auto-fills the registrar, registration date, expiry date, and registrar URL. Days remaining until expiry are shown as a D-day badge so you never miss a renewal.
The list is scoped to the project (CSN) set in your login session, and the server re-verifies membership. You must be logged in to use it.
🔍 Key Feature Descriptions
1. Domain List
Registered domains appear in a table. The columns mean:
- Domain: The domain name. If a registrar URL is set, clicking it opens in a new tab.
- Registrar: The company the domain was registered with.
- Registered: The domain's registration date.
- Expires: The domain's expiry date.
- Status: A badge showing days remaining until expiry (see below).
- Project: The project the domain belongs to (organization name or CSN).
- Actions: whois / Edit / Delete buttons.
2. Expiry Status Badge
The badge color changes with the days remaining until expiry.
- Expired (red): The expiry date has already passed.
- D-{days} (amber): 30 days or fewer until expiry. Prepare to renew.
- D-{days} (green): More than 30 days until expiry — comfortable margin.
- No date (gray): No expiry information. Run a whois lookup or enter it manually.
3. Add Domain
Click [+ Add domain] in the upper right to open the input box. Enter only the domain name (e.g. example.com); after registration a whois lookup runs automatically to fill in the registrar, dates, and URL. Even if the whois lookup fails the domain is already registered, so you can complete the details later with the [whois] button or [Edit].
4. whois Refresh
The [whois] button on each row re-runs a whois lookup for that domain and updates it with the latest registration details and expiry date. .kr/.co.kr domains use whois.kr; all others use RDAP. Any result found is saved automatically.
5. Edit
The [Edit] button lets you directly edit the registrar, registration date, expiry date, and registrar URL. Inside the edit dialog you can also press [Fetch from whois] to re-populate the values.
6. Delete
The [Delete] button removes the domain from the list after a confirmation prompt (soft delete).
🛠️ Tips
- Project (CSN) required: Adding a domain requires a project (CSN) in your session. Select a project first.
- Refresh: Use the [Refresh] button in the upper right to reload the list.
- Simplify input: When adding, let whois auto-fill handle the registrar, dates, and URL instead of typing them yourself — it's the fastest path.
💡 Important Notes
- "Domain" on this screen means a DNS domain (a registered internet domain), unrelated to network nodes.
- If the list is empty, register your first domain with the [+ Add domain] button at the top.
API Reference
For detailed API specifications of this feature, refer to the dedicated guide.
Troubleshooting
| Symptom | Cause | Resolution |
|---|---|---|
| "Please login to continue" message | No session or the session expired | Log in again and refresh the page. |
| "No project (CSN)" when adding a domain | No project is selected in the session | Select a project first, then try again. |
| Domain added but registrar/dates are empty | The automatic whois lookup failed | Press the [whois] button on that row again, or enter values via [Edit]. |
| Status shows "No date" | No expiry information is available | Run [whois], or enter the expiry date via [Edit]. |
| whois lookup ends with "no persistable data" | The whois response contained nothing to save | Verify the domain name, or enter values manually via [Edit]. |
Version: 1.0
Last Updated: 2026-07-22
Source: giipv3/public/help/domains.en.md