[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-08-18(UTC)"],[[["\u003cp\u003eThis documentation applies to both Apigee and Apigee hybrid platforms, focusing on developer portal customization.\u003c/p\u003e\n"],["\u003cp\u003eBy default, Apigee provides a sample domain name for developer portals, but using a custom domain, which is recommended before launching, is available for paid accounts.\u003c/p\u003e\n"],["\u003cp\u003eCustomizing a domain involves registering the domain, creating a TLS certificate, determining the default portal host name, creating an Internet network endpoint group (NEG), setting up a load balancer, and configuring the custom domain on the portal.\u003c/p\u003e\n"],["\u003cp\u003eThe final step in setting up a custom domain is to update your DNS settings to include a new record that points the custom domain to the reserved IP address from the load balancer configuration.\u003c/p\u003e\n"],["\u003cp\u003eCustom domains can be edited or disabled through the portal settings within the Apigee UI, allowing flexibility in managing domain configurations.\u003c/p\u003e\n"]]],[],null,["# Customizing your domain\n\n*This page\napplies to **Apigee** and **Apigee hybrid**.*\n\n\n*View [Apigee Edge](https://docs.apigee.com/api-platform/get-started/what-apigee-edge) documentation.*\n\n\u003cbr /\u003e\n\nWhen you create a developer portal, by default you are provided with an Apigee\nsample domain name for accessing your live portal in the following format:\n\n`https://`*orgname-portalname*`.apigee.io`\n\nWhere *orgname* is the organization name and\n*portalname* is defined using the portal name converted to all\nlowercase and with spaces and dashes removed.\n\nBefore launching a developer portal, it is recommended that you provide your own\ncustom domain name. For example, a popular alternative is:\n\n`https://developers.example.com`\n| **Note:** Domain names can be customized for paid accounts only.\n\nFor considerations for using a custom domain with a SAML identity provider, see\n[Using a custom domain with the SAML identity provider](/apigee/docs/api-platform/publish/portal/portal-identity-provider#custom-domain-saml).\n\nSteps to customize your domain\n------------------------------\n\nTo customize your domain name perform the following steps:\n\n1. [Register your domain name](#register-domain).\n2. [Create a TLS certificate for your custom domain](#cert). You will need the cert when creating the load balancer.\n3. [Determine the default hostname for your portal](#default-hostname).\n4. [Create an Internet network endpoint group (NEG)](#internet-neg) to define the backend endpoint to your integrated portal for the load balancer.\n5. [Create a load balancer](#cloud-lb) that points to the Internet NEG and reserves the IP for your incoming client requests.\n6. [Configure the custom domain on your portal](#portal).\n7. [Update your DNS](#cloud-dns) to create a new record for the custom domain host.\n\nStep 1: Register your domain name\n---------------------------------\n\nIf you need to register a new domain, there are many popular domain registration\nsites available, such as [Google Domains](https://domains.google/). Which domain registration site you choose is up to you.\n\nWhen deciding on your domain name, consider that user-friendly, human-readable\nURLs are a key component in improving search engine optimization, as described\nin [Implement search engine optimization (SEO)](/apigee/docs/api-platform/publish/portal/portal-best-practices#seo).\n| **Notes:**\n|\n| - Don't use the string \"apigee\" in your custom domain name.\n| - Consider redirecting to other similar domain name alternatives.\n\nStep 2: Create a TLS certificate for your custom domain\n-------------------------------------------------------\n\nCreate a TLS certificate for your custom domain using your preferred tool, such as [Let's Encrypt](https://letsencrypt.org/). For more information, see:\n\n- [SSL certificates overview](/load-balancing/docs/ssl-certificates)\n- [Using self-managed SSL certificates](/load-balancing/docs/ssl-certificates/self-managed-certs)\n\nStep 3: Determine the default hostname for your portal\n------------------------------------------------------\n\nTo determine the default hostname for your portal:\n\n1. Display the list of portals:\n\n ### Cloud Console UI\n\n In the Apigee in Cloud console, go to the **Distribution \\\u003e Portals** page.\n\n [Go to Portals](https://console.cloud.google.com/apigee/portals)\n\n ### Classic UI\n\n In the Apigee UI, select **Publish \\\u003e Portals** in the side navigation bar.\n The list of portals is displayed.\n2. Copy the contents in the **Location** field for the portal for which you\n want to create a custom domain. For example, `apigee-gcp-prod1-helloworld.apigee.io`.\n\n You will need this value in the next step.\n\nStep 4: Create an Internet NEG\n------------------------------\n\nIn this step you create an Internet network endpoint group (NEG) to define the backend endpoint to your integrated portal for the load balancer. For more information, see [Internet network endpoint groups overview](/load-balancing/docs/negs/internet-neg-concepts).\n\n1. In the Google Cloud console, go to the **Dashboard** page and select or create a Google Cloud project.\n\n [Go to the Dashboard page](https://console.cloud.google.com/projectselector2/home/dashboard)\n\n \u003cbr /\u003e\n\n2. Select **Compute Engine \\\u003e Network endpoint groups** in the navigator.\n\n3. Click **Create network endpoint group**.\n\n4. Configure the following fields:\n\n5. You can leave the remaining fields set to their defaults.\n\n6. Click **Create**.\n\nThe Internet NEG is created.\n\nStep 5: Create a load balancer\n------------------------------\n\nCreate a load balancer that points to the Internet NEG and reserves the IP for your incoming client requests.\n\n#### Select the load balancer type\n\n1. In the Google Cloud console, go to the **Load balancing** page.\n\n [Go to Load balancing](https://console.cloud.google.com/net-services/loadbalancing/list)\n2. Click **Create load balancer**.\n3. For **Type of load balancer** , select **Application Load Balancer\n (HTTP/HTTPS)** and click **Next**.\n4. For **Public facing or internal** , select **Public facing\n (external)** and click **Next**.\n5. For **Global or single region deployment** , select **Best for global\n workloads** and click **Next**.\n6. For **Load balancer generation** , select **Global external\n Application Load Balancer** and click **Next**.\n7. Click **Configure**.\n\n#### Configure the load balancer\n\n1. Click each category and configure the load balancer as described in the following table.\n\n2. Click **Create** on the **Create global external Application Load Balancer** page.\n\nStep 6: Configure the custom domain on your portal\n--------------------------------------------------\n\nTo configure the custom domain on your portal:\n\n1. Display the list of portals:\n\n ### Cloud Console UI\n\n In the Apigee in Cloud console, go to the **Distribution \\\u003e Portals** page.\n\n [Go to Portals](https://console.cloud.google.com/apigee/portals)\n\n ### Classic UI\n\n In the Apigee UI, select **Publish \\\u003e Portals** in the side navigation bar.\n The list of portals is displayed.\n2. Select your portal in the list.\n\n3. Select **Settings**.\n\n4. Click the **Domains** tab.\n\n5. Enter your custom domain name in the **Domain** field.\n\n6. Click **Enable**.\n\nTest that when you access the custom domain in a browser you are directed to your integrated portal.\n\nSee also [Editing a custom domain](#edit) and [Disabling a custom domain](#disable).\n\nStep 7: Update your DNS\n-----------------------\n\nIn your DNS system, create a new record for the custom domain host.\n\nTo create a Cloud DNS zone, follow the steps described in [Managing Zones](https://cloud.google.com/dns/zones). Ensure that you configure the following fields:\n\nAfter you create a zone, on the Zone details page, click **Add record set** and follow the steps described in\n[Managing Records](https://cloud.google.com/dns/records). Ensure that you configure the following fields:\n\nEditing a custom domain on your portal\n--------------------------------------\n\nTo edit a custom domain on your portal:\n\n1. Display the list of portals:\n\n ### Cloud Console UI\n\n In the Apigee in Cloud console, go to the **Distribution \\\u003e Portals** page.\n\n [Go to Portals](https://console.cloud.google.com/apigee/portals)\n\n ### Classic UI\n\n In the Apigee UI, select **Publish \\\u003e Portals** in the side navigation bar.\n The list of portals is displayed.\n2. Select your portal in the list.\n\n3. Select **Settings**.\n\n4. Click the **Domains** tab.\n\n5. Edit the custom domain information.\n\n6. Click **Save**.\n\nDisabling a custom domain on your portal\n----------------------------------------\n\nTo disable a custom domain name on your portal:\n\n1. Display the list of portals:\n\n ### Cloud Console UI\n\n In the Apigee in Cloud console, go to the **Distribution \\\u003e Portals** page.\n\n [Go to Portals](https://console.cloud.google.com/apigee/portals)\n\n ### Classic UI\n\n In the Apigee UI, select **Publish \\\u003e Portals** in the side navigation bar.\n The list of portals is displayed.\n2. Select your portal in the list.\n\n3. Select **Settings**.\n\n4. Click the **Domains** tab.\n\n5. Click **Disable**.\n\n6. Click **Disable** at the prompt to confirm the operation.\n\nThe custom domain is disabled and the fields are cleared."]]
