도메인 맞춤설정

이 페이지는 Apigee 및 Apigee Hybrid에 적용됩니다.

Apigee Edge 문서 보기

개발자 포털을 만들면 기본적으로 실제 포털에 액세스하는 데 필요한 Apigee 샘플 도메인 이름이 다음 형식으로 제공됩니다.

https://orgname-portalname.apigee.io

여기서 orgname은 조직 이름이고 portalname은 모두 소문자로 변환되고 공백과 대시가 삭제된 포털 이름을 사용하여 정의됩니다.

개발자 포털을 시작하기 전에 커스텀 도메인 이름을 지정하는 것이 좋습니다. 예를 들어 일반적인 대안은 다음과 같습니다.

https://developers.example.com

SAML ID 공급업체를 통해 커스텀 도메인을 사용하기 위한 고려사항은 SAML ID 공급업체를 통해 커스텀 도메인 사용을 참조하세요.

도메인 맞춤설정 단계

도메인 이름을 맞춤설정하려면 다음 단계를 수행하세요.

  1. 도메인 이름을 등록합니다.
  2. 커스텀 도메인의 TLS 인증서 만들기 부하 분산기를 만들 때 인증서가 필요합니다.
  3. 포털의 기본 호스트 이름을 확인합니다.
  4. 인터넷 네트워크 엔드포인트 그룹(NEG)을 만들어 부하 분산기의 통합 포털에 백엔드 엔드포인트를 정의합니다.
  5. 인터넷 NEG를 가리키는 부하 분산기를 만들고 수신되는 클라이언트 요청에 사용할 IP를 예약합니다.
  6. 포털의 커스텀 도메인을 사용 설정합니다.
  7. DNS를 업데이트하여 커스텀 도메인 호스트의 새 레코드를 만듭니다.

1단계: 도메인 이름 등록

새 도메인을 등록해야 하는 경우에 사용할 수 있는 Google Domains와 같이 일반적인 도메인 등록 사이트가 많이 있습니다. 도메인 등록 사이트는 사용자가 선택할 수 있습니다.

도메인 이름을 결정할 때 사람이 읽을 수 있고 사용자 친화적인 URL은 검색엔진 최적화를 개선하는 데 핵심적인 구성요소라고 간주하세요. 자세한 내용은 검색 엔진 최적화(SEO) 구현을 참조하세요.

2단계: 커스텀 도메인의 TLS 인증서 만들기

Let's Encrypt 등 원하는 도구를 사용하여 커스텀 도메인의 TLS 인증서를 만듭니다. 자세한 내용은 다음을 참고하세요.

3단계: 포털의 기본 호스트 이름 확인

포털의 기본 호스트 이름 확인하려면 다음 안내를 따르세요.

  1. Apigee UI의 측면 탐색 메뉴에서 게시 > 포털을 선택합니다. 포털 목록이 표시됩니다.

  2. 커스텀 도메인을 만들려는 포털의 위치 필드에 있는 콘텐츠를 복사합니다. 위치 필드가 강조표시된 포털 항목

    다음 단계에서 이 값이 필요합니다.

4단계: 인터넷 NEG 만들기

이 단계에서는 인터넷 네트워크 엔드포인트 그룹(NEG)을 만들어 부하 분산기의 통합 포털에 백엔드 엔드포인트를 정의합니다. 자세한 내용은 인터넷 네트워크 엔드포인트 그룹 개요를 참조하세요.

  1. Google Cloud Console에서 대시보드 페이지로 이동하고 Google Cloud 프로젝트를 선택하거나 만듭니다.

    대시보드 페이지로 이동

  2. 탐색기에서 Compute Engine > 네트워크 엔드포인트 그룹을 선택합니다.

  3. 네트워크 엔드포인트 그룹 만들기를 클릭합니다.

  4. 다음 필드를 구성합니다.

    필드 값
    이름 인터넷 NEG의 이름을 입력합니다.
    네트워크 엔드포인트 그룹 유형 네트워크 엔드포인트 그룹(인터넷)을 선택합니다.
    새 네트워크 엔드포인트

  5. 남은 필드는 기본 설정 그대로 유지할 수 있습니다.

  6. 만들기를 클릭합니다.

인터넷 NEG가 생성됩니다.

5단계: 부하 분산기 만들기

인터넷 NEG를 가리키는 부하 분산기를 만들고 수신되는 클라이언트 요청에 사용할 IP를 예약합니다.

구성 시작

  1. Google Cloud 콘솔에서 부하 분산 페이지로 이동합니다.

    부하 분산으로 이동

  2. 부하 분산기 만들기를 클릭합니다.
  3. 부하 분산기 유형에서 애플리케이션 부하 분산기(HTTP/HTTPS)를 선택하고 다음을 클릭합니다.
  4. 공개 또는 내부에서 공개(외부)를 선택하고 다음을 클릭합니다.
  5. 전역 또는 단일 리전 배포에서 전역 워크로드에 적합을 선택하고 다음을 클릭합니다.
  6. 부하 분산기 생성에서 전역 외부 애플리케이션 부하 분산기를 선택하고 다음을 클릭합니다.
  7. 구성을 클릭합니다.

부하 분산기 구성

  1. 다음 테이블에 설명된 대로 각 카테고리를 클릭하고 부하 분산기를 구성합니다.

    카테고리 단계
    프런트엔드 구성

    수신되는 클라이언트 요청의 IP 주소를 예약하고 2단계: TLS 인증서 만들기에서 만든 TLS 인증서를 업로드합니다.

    1. 전역 외부 애플리케이션 부하 분산기 만들기 섹션에서 프런트엔드 구성 위에 커서를 두고 화살표를 클릭합니다.
    2. 이름 필드에 프런트엔드 이름을 입력합니다.
    3. 프로토콜 드롭다운 메뉴에서 HTTPS를 선택합니다.
    4. IP 주소 드롭다운 메뉴에서 IP 주소 만들기를 선택합니다.
      새 고정 IP 주소 예약 대화상자가 표시됩니다.
    5. 이름 필드에 고정 IP 주소의 이름을 입력합니다.
    6. 원하는 경우 설명을 입력합니다.
    7. 예약을 클릭합니다.
    8. DNS 레코드를 설정할 때 사용하려고 예약한 IP 주소를 저장합니다.
    9. 인증서 드롭다운에서 새 인증서 만들기를 선택합니다.
      새 인증서 만들기 창 슬라이드가 열립니다.
    10. 이름 필드에 새 인증서 이름을 입력합니다.
    11. 생성 모드에서 인증서 업로드를 선택합니다.
    12. 공개 키, 인증서 체인, 비공개 키를 포함한 TLS 인증서 세부정보를 업로드합니다.
    13. 만들기를 클릭합니다.
    14. 완료를 클릭하여 새 프런트엔드 IP 및 포트를 만듭니다.
    백엔드 구성

    4단계: 인터넷 네트워크 엔드포인트 그룹 만들기(NEG)에서 만든 인터넷 NEG로 수신 트래픽을 보내도록 백엔드 구성을 구성합니다.

    1. 전역 외부 애플리케이션 부하 분산기 만들기 섹션에서 백엔드 구성 위에 커서를 두고 화살표를 클릭합니다.
    2. 백엔드 서비스 및 백엔드 버킷 섹션의 드롭다운에서 백엔드 서비스 > 백엔드 서비스 만들기를 선택합니다.
      백엔드 서비스 만들기 창 슬라이드가 열립니다.
    3. 이름 필드에 이름을 입력합니다.
    4. 백엔드 유형 드롭다운에서 인터넷 네트워크 엔드포인트 그룹을 선택합니다.
    5. 프로토콜로 HTTPS를 선택합니다.
    6. 새 백엔드 섹션의 인터넷 네트워크 엔드포인트 그룹 드롭다운 메뉴에서 4단계: 인터넷 네트워크 엔드포인트 그룹 만들기(NEG)에서 만든 인터넷 NEG를 선택하고 완료를 클릭합니다.
    7. Cloud CDN 사용 설정 체크박스를 선택 취소합니다.
    8. 다른 모든 값은 기본 설정 그대로 유지할 수 있습니다.
    9. 만들기를 클릭합니다.
    호스트 및 경로 규칙

    호스트 및 경로 규칙을 구성하여 트래픽 전달 방식을 결정합니다.

    1. 전역 외부 애플리케이션 부하 분산기 만들기 섹션에서 호스트 및 경로 규칙 위에 커서를 두고 화살표를 클릭합니다.
    2. 모드에서 고급 호스트 및 경로 규칙(URL 리디렉션, URL 재작성)을 클릭합니다.
    3. 새 호스트 및 경로 규칙 섹션에서 다음 안내를 따르세요.
      1. 작업 드롭다운에서 단일 백엔드로 트래픽 라우팅을 선택합니다.
      2. 부가 작업(URL 재작성)을 펼칩니다.
      3. 호스트 재작성 필드에 3단계: 포털의 기본 호스트 이름 확인에서 복사한 기본 도메인 이름을 입력합니다.
      4. 백엔드 드롭다운에서 구성한 백엔드 서비스를 선택합니다.
      5. 완료를 클릭합니다.

  2. 전역 외부 애플리케이션 부하 분산기 만들기 페이지에서 만들기를 클릭합니다.

6단계: 포털의 커스텀 도메인 구성

포털의 커스텀 도메인을 구성하려면 다음 안내를 따르세요.

  1. Apigee UI의 측면 탐색 메뉴에서 게시 > 포털을 선택합니다.
    포털 목록이 표시됩니다.
  2. 목록에서 포털을 선택합니다.
  3. 방문 페이지 또는 상단 탐색 메뉴의 드롭다운에서 설정을 선택합니다.
  4. Domains(도메인) 탭을 클릭합니다.
  5. 도메인 필드에 커스텀 도메인 이름을 입력합니다.
  6. 사용 설정을 클릭합니다.

브라우저에서 커스텀 도메인에 액세스하면 통합 포털로 연결되는지 테스트합니다.

커스텀 도메인 수정과 커스텀 도메인 사용 중지도 참조하세요.

7단계: DNS 업데이트

DNS 시스템에서 커스텀 도메인 호스트에 대해 새 레코드를 만듭니다.

Cloud DNS 영역을 만들려면 영역 관리에 설명된 단계를 따릅니다. 아래에 설명된 대로 다음 필드를 구성해야 합니다.

필드 설명
영역 유형 공개를 선택합니다.
영역 이름 영역의 의미 있는 이름을 입력합니다. 예를 들면 mycompany-zone입니다.
DNS 이름 소유하고 있는 도메인 이름을 사용하여 영역의 서픽스를 입력합니다. 예를 들면 mycompany.com입니다.

영역을 만든 후 영역 세부정보 페이지에서 레코드 모음 추가를 클릭하고 레코드 관리에 설명된 단계를 따릅니다. 아래에 설명된 대로 다음 필드를 구성해야 합니다.

필드 설명
DNS 이름 DNS 이름의 프리픽스를 지정합니다. Cloud DNS 영역에 정의된 서픽스도 표시되지만 이를 수정할 수 없습니다. 예를 들면 developers.mycompany.com입니다.
리소스 레코드 유형 A(기본값)를 선택합니다.
TTL 원하는 값으로 설정하거나 5(기본값)로 설정된 상태로 둡니다.
TTL 단위 원하는 값으로 설정하거나 분(기본값)으로 설정된 상태로 둡니다.
IPv4 주소 부하 분산기를 만들 때 예약한 외부 IP 주소를 입력합니다.

포털의 커스텀 도메인 수정

포털의 커스텀 도메인을 수정하려면 다음 안내를 따르세요.

  1. Apigee UI의 측면 탐색 메뉴에서 게시 > 포털을 선택합니다.
    포털 목록이 표시됩니다.
  2. 목록에서 포털을 선택합니다.
  3. 상단 탐색 메뉴 또는 방문 페이지의 드롭다운 메뉴에서 설정을 선택합니다.
  4. Domains(도메인) 탭을 클릭합니다.
  5. 커스텀 도메인 정보를 수정합니다.
  6. 저장을 클릭합니다.

포털의 커스텀 도메인 사용 중지

포털의 커스텀 도메인 이름을 사용 중지하려면 다음 안내를 따르세요.

  1. Apigee UI의 측면 탐색 메뉴에서 게시 > 포털을 선택합니다. 포털 목록이 표시됩니다.
  2. 목록에서 포털을 선택합니다.
  3. 상단 탐색 메뉴 또는 방문 페이지의 드롭다운 메뉴에서 설정을 선택합니다.
  4. Domains(도메인) 탭을 클릭합니다.
  5. 사용 중지를 클릭합니다.
  6. 프롬프트에서 사용 중지를 클릭하여 작업을 확인합니다.

커스텀 도메인이 사용 중지되고 필드가 삭제됩니다.