Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

가상 호스트 구성

Apigee Edge 문서입니다.
Go to the Apigee X 문서로 이동합니다. info

유료 계정이 있는 Cloud 고객과 모든 Edge for Private Cloud 고객 은 조직에서 가상 호스트를 만들 수 있습니다. 가상 호스트를 만드는 사용자는 조직 관리자 역할 또는 가상 호스트를 수정할 수 있는 권한이 있는 커스텀 역할이어야 합니다. 다른 역할의 사용자는 가상 호스트를 만들 권한이 없습니다.

가상 호스트 소개 동영상을 시청하세요.

가상 호스트 만들기

다음 기본 절차에 따라 가상 호스트를 만듭니다. 실제 절차는 Cloud 또는 Private Cloud 고객인지, TLS를 사용 설정하는지에 따라 다릅니다.

공개 도메인의 DNS 항목 및 CNAME 레코드를 만듭니다.
참고: Private Cloud 고객은 DNS 항목 및 CNAME 레코드 없이 IP 주소에서 가상 호스트를 만들 수 있습니다. 자세한 내용은 Private Cloud용 가상 호스트 구성 을 참조하세요.
가상 호스트에서 TLS를 사용 설정하는 경우:

여기에 설명된 절차( 키 저장소 및 트러스트 저장소)를 사용하여 키 저장소를 만들고 구성합니다.
참고: 유료 Edge for Cloud 계정이 있고 아직 TLS 인증서와 키가 없는 경우 Apigee 무료 체험판 인증서 및 키를 사용하는 가상 호스트를 만들 수 있습니다. Cloud용 가상 호스트 구성을 참조하세요.
인증서와 키를 키 저장소에 업로드합니다. 인증서에 지정된 도메인 이름이 가상 호스트에 사용할 호스트 별칭과 일치하는지 확인합니다.
Edge UI 또는 API를 사용하여 키 저장소에 대한 참조를 만듭니다. 참조는 키 저장소의 이름과 참조 유형을 KeyStore로 지정합니다. 참조를 만들고 수정하는 방법에 대한 자세한 내용은 참조 작업을참조하세요.
양방향 TLS를 수행하는 경우 트러스트 저장소를 만들고 인증서를 업로드하고 트러스트 저장소에 대한 참조를 만듭니다. 여기에 설명된 절차(키 저장소 및 트러스트 저장소)를 사용하여 트러스트 저장소를 만듭니다.

가상 호스트 만들기 API를 사용하여 가상 호스트를 만듭니다. TLS를 사용 설정하는 경우 올바른 키 저장소 참조, 트러스트 저장소 참조, 키 별칭을 지정해야 합니다.
기존 API 프록시가 있는 경우 가상 호스트를 ProxyEndpoint에 추가합니다. 가상 호스트는 모든 새 API 프록시에 자동으로 추가됩니다. 가상 호스트를 사용하도록 API 프록시 구성을 참조하세요.

주의: 모든 가상 호스트는 모든 새 API 프록시에 자동으로 추가됩니다. 따라서 특정 가상 호스트를 통해 액세스할 수 없는 새 API 프록시를 만드는 경우 API 프록시를 수정하여 해당 가상 호스트를 ProxyEndpoint에서 삭제해야 합니다.

가상 호스트를 사용하도록 API 프록시를 업데이트하고 호스트 별칭의 DNS 항목 및 CNAME 레코드를 만든 후에는 아래와 같이 API 프록시에 액세스할 수 있습니다.

https://api.myCompany.com/v1/project-base-path/resource-path

예를 들면 다음과 같습니다.

https://api.myCompany.com/v1/weather/forecastrss?w=12797282

API 또는 UI를 사용하여 가상 호스트 만들기

Edge API 또는 Edge UI를 사용하여 가상 호스트를 만들 수 있습니다.

아래 예시 대부분은 Edge API를 사용합니다. Edge UI에서 가상 호스트를 만들고 수정하고 삭제하는 UI에 액세스하려면 다음 안내를 따르세요.

apigee.com/edge에 로그인합니다.
Edge for Private Cloud 고객은 http://ms-ip:9000 (온프레미스)을 사용합니다. 여기서 ms-ip는 관리 서버 노드의 IP 주소 또는 DNS 이름입니다.
왼쪽 탐색 메뉴에서 관리 > 가상 호스트 를 선택합니다.
prod 또는 test 와 같은 환경을 선택합니다.
환경에 정의된 가상 호스트가 표시됩니다.
+ 가상 호스트를 선택하여 가상 호스트를 만들거나 기존 가상 호스트의 이름을 선택하여 수정합니다.

HTTP용 가상 호스트 만들기

Edge for Private Cloud 고객은 HTTP를 사용하여 가상 호스트를 만들 수 있습니다.

TLS를 지원하지 않는 가상 호스트를 만들려면 가상 호스트를 정의하는 XML 객체를 만듭니다. 예를 들어 다음 XML 객체는 HTTP 프로토콜을 사용하는 가상 호스트를 정의합니다.

<VirtualHost name="myVHost">
   <HostAliases>
     <HostAlias>api.myCompany.com</HostAlias>
   </HostAliases>
   <Interfaces/>
   <Port>80</Port>
</VirtualHost>

이 정의에서 다음을 수행합니다.

이름 을 myVHost 로 지정합니다. 이름을 사용하여 API 프록시 또는 API 호출에서 가상 호스트를 참조합니다.
호스트 별칭을 api.myCompany.com으로 지정합니다. 이는 DNS 정의 및 CNAME 레코드에 정의된 대로 API에 액세스하는 데 사용되는 공개 도메인입니다.
포트 번호를 80 으로 지정합니다. 생략하면 기본적으로 포트가 443으로 설정됩니다.
가상 호스트에서 설정할 수 있는 추가 속성이 있습니다. 모든 속성의 참조는 가상 호스트 속성 참조를 확인하세요.

기존 API 프록시가 있는 경우 가상 호스트를 <HTTPConnection> 요소 프록시 엔드포인트에 추가합니다. 가상 호스트는 모든 새 API 프록시에 자동으로 추가됩니다. 가상 호스트를 사용하도록 API 프록시 구성을 참조하세요. 특정 가상 호스트를 통해 액세스할 수 없는 새 API 프록시를 만드는 경우, API 프록시를 수정하여 해당 가상 호스트를 ProxyEndpoint에서 삭제해야 합니다.

그런 다음 다음 주소로 요청을 보내 이 가상 호스트를 통해 API 프록시에 액세스할 수 있습니다.

http://api.myCompany.com/proxy-base-path/resource-path
https://api.myCompany.com/proxy-base-path/resource-path

가상 호스트 만들기 가상 호스트 API를 사용하여 가상 호스트를 만듭니다.

curl -X POST -H "Content-Type:application/xml" \
  http://ms-IP:8080/v1/o/org_name/environments/env_name/virtualhosts \
  -d '<VirtualHost name="myVHost">
        <HostAliases>
            <HostAlias>api.myCompany.com</HostAlias>
        </HostAliases>
        <Interfaces/>
        <Port>80</Port>
    </VirtualHost>' \
  -u sysAdminEmail:password

참고: Edge for Private Cloud에서는 도메인 이름 ms-ip:8080에 API 호출을 합니다. 여기서 ms-ip는 Edge 관리 서버의 IP입니다. Cloud용 Edge 고객은 도메인 api.enterprise.apigee.com

에 요청을 보냅니다.

단방향 TLS용 가상 호스트 만들기

다음 XML 객체는 단방향 TLS용 가상 호스트를 정의합니다.

<VirtualHost name="myTLSVHost">
    <HostAliases>
        <HostAlias>api.myCompany.com</HostAlias>
    </HostAliases>
    <Port>443</Port>
    <SSLInfo>
        <Enabled>true</Enabled>
        <ClientAuthEnabled>false</ClientAuthEnabled>
        <KeyStore>ref://myTestKeystoreRef</KeyStore>
        <KeyAlias>myKeyAlias</KeyAlias>
    </SSLInfo>
</VirtualHost>

이 정의에서 <Enable> 요소를 true로 설정하여 TLS를 사용 설정하고 <KeyStore> 및 <KeyAliase> 요소를 사용하여 TLS 연결에서 사용하는 키 저장소 및 키 별칭을 지정합니다.

참고: Edge는 원래 SSL을 지원했으므로 TLS를 구성하는 데 사용하는 태그의 이름은 <SSLInfo>입니다.

TLS 사용에 대한 자세한 내용은 TLS/SSL을 참조하세요.

가상 호스트에서 키 저장소 및 트러스트 저장소 이름을 지정하는 방법 결정

TLS를 지원하도록 가상 호스트를 구성할 때는 참조를 사용하여 키 저장소를 지정합니다. 참조는 아래와 같이 키 저장소 또는 트러스트 저장소 이름을 직접 지정하는 대신 키 저장소 또는 트러스트 저장소의 이름이 포함되는 변수입니다.

    <SSLInfo>
        <Enabled>true</Enabled>
        <ClientAuthEnabled>false</ClientAuthEnabled>
        <KeyStore>ref://myTestKeystoreRef</KeyStore>
        <KeyAlias>myKeyAlias</KeyAlias>
    </SSLInfo>

참조를 사용하면 현재 키 저장소의 인증서가 곧 만료될 때 참조 값을 변경하여 가상 호스트에서 사용되는 키 저장소를 변경할 수 있다는 장점이 있습니다. 참조의 값을 변경할 때는 Edge 라우터를 다시 시작할 필요가 없습니다 참조를 만들고 수정하는 방법에 대한 자세한 내용은 참조 작업을 참조하세요.

키 저장소와 트러스트 저장소에 대한 참조만 사용할 수 있습니다. 별칭에 대한 참조를 사용할 수 없습니다. 키 저장소에 대한 참조를 변경하는 경우 인증서의 별칭 이름이 이전 키 저장소 이름과 동일해야 합니다.

키 저장소 및 트러스트 저장소 사용에 대한 제한

키 저장소 및 트러스트 저장소에 대한 참조를 사용할 때는 다음 제한사항을 고려해야 합니다.

SNI를 지원하고 Apigee 라우터에서 SSL을 종료하는 경우에만 가상 호스트에서 키 저장소 및 트러스트 저장소 참조를 사용할 수 있습니다.
Apigee 라우터 앞에 부하 분산기가 있고 부하 분산기에서 TLS를 종료한 경우 가상 호스트에서 키 저장소 및 트러스트 저장소 참조를 사용할 수 없습니다.

양방향 TLS용 가상 호스트 만들기

양방향 TLS를 사용 설정하려면 <ClientAuthEnabled> 요소를 true로 설정하고 <TrustStore> 요소와 함께 참조를 사용하여 트러스트 저장소를 지정합니다. 트러스트 저장소 에는 클라이언트의 인증서 발급기관과 인증서의 CA 체인이 포함되어야 합니다. 또한 클라이언트는 양방향 TLS에 맞게 올바르게 구성되어야 합니다.

양방향 TLS용 가상 호스트를 만들려면 가상 호스트를 정의하는 XML 객체를 만듭니다.

<VirtualHost name="myTLSVHost">
    <HostAliases>
        <HostAlias>api.myCompany.com</HostAlias>
    </HostAliases>
    <Port>443</Port>
    <SSLInfo>
        <Enabled>true</Enabled>
        <ClientAuthEnabled>true</ClientAuthEnabled>
        <KeyStore>ref://myTestKeystoreRef</KeyStore>
        <KeyAlias>myKeyAlias</KeyAlias>
        <TrustStore>ref://myTestTruststoreRef</TrustStore>
    </SSLInfo>
</VirtualHost>

이 정의에서 다음을 수행합니다.

<ClientAuthEnabled>를 true로 설정하여 양방향 TLS를 사용 설정합니다.
<TrustStore> 요소를 사용하여 트러스트 저장소에 대한 참조를 지정합니다. 트러스트 저장소 에는 클라이언트의 인증서 발급기관과 인증서의 CA 체인이 포함되어야 합니다.

TLS 사용에 대한 자세한 내용은 TLS/SSL을 참조하세요.

가상 호스트 수정

유료 계정이 있는 Cloud 고객과 모든 Edge for Private Cloud 고객은 가상 호스트 업데이트 API를 사용하여 가상 호스트를 업데이트할 수 있습니다. 이 API를 사용하면 가상 호스트 속성 참조에 설명된 가상 호스트의 모든 속성을 설정할 수 있습니다.

가상 호스트 업데이트 API를 사용하여 가상 호스트를 업데이트합니다. API를 사용할 때는 변경할 요소뿐만 아니라 요청 본문에 가상 호스트의 전체 정의를 지정해야 합니다.

이 예시에서는 proxy_read_timeout 속성의 값을 설정합니다.

curl -X PUT -H "Content-Type:application/xml" \
    https://api.enterprise.apigee.com/v1/o/org_name/e/env_name/virtualhosts/vhost_name \
    -d '<VirtualHost  name="myTLSVHost">
         <HostAliases>
           <HostAlias>api.myCompany.com</HostAlias>
         </HostAliases>
         <Port>443</Port>
         <SSLInfo>
           <Enabled>true</Enabled>
           <ClientAuthEnabled>false</ClientAuthEnabled>
           <KeyStore>ref://myTestKeystoreRef</KeyStore>
           <KeyAlias>myKeyAlias</KeyAlias>
         </SSLInfo>
         <Properties>
           <Property name="proxy_read_timeout">50</Property>
         </Properties>
     </VirtualHost>' \
    -u orgAdminEmail:password

가상 호스트 삭제

환경에서 가상 호스트를 삭제하려면 먼저 가상 호스트를 참조하는 API 프록시를 업데이트하여 참조를 삭제해야 합니다. 가상 호스트를 사용하도록 API 프록시 구성을 참조하세요.

가상 호스트 삭제 API를 사용하여 가상 호스트를 삭제합니다.

curl -X DELETE \
  https://api.enterprise.apigee.com/v1/o/org_name/e/env_name/virtualhosts/vhost_name \
  -u orgAdminEmail:password

가상 호스트에 대한 정보 보기

아래 설명된 대로 환경에 정의된 가상 호스트에 대한 정보를 봅니다.

Edge

Edge UI를 사용하여 가상 호스트에 대한 정보를 보려면 다음 안내를 따르세요.

apigee.com/edge에 로그인합니다.
Edge for Private Cloud 고객은 http://ms-ip:9000 (온프레미스)을 사용합니다. 여기서 ms-ip는 관리 서버 노드의 IP 주소 또는 DNS 이름입니다.
왼쪽 탐색 메뉴에서 관리 > 가상 호스트 를 선택합니다.
prod 또는 test 와 같은 환경을 선택합니다.
환경에 정의된 가상 호스트가 표시됩니다. 키 저장소 또는 트러스트 저장소를 사용하도록 가상 호스트가 구성된 경우 표시를 클릭하여 자세한 내용을 확인합니다.

TLS/SSL을 사용하도록 가상 호스트가 구성된 경우 가상 호스트 이름 옆에 자물쇠 아이콘이 표시됩니다. 즉, TLS/SSL 인증서, 키, 인증서 체인이 Edge에 업로드되어 가상 호스트와 연결되었습니다. 사용 가능한 인증서에 대한 정보를 보려면 다음 안내를 따르세요.

왼쪽 탐색 메뉴에서 관리 > 환경 > TLS 키 저장소 를 선택합니다.
환경을 선택합니다 (일반적으로 prod 또는 test).
키 저장소를 펼쳐 인증서를 확인합니다.

기존 Edge (Private Cloud)

기존 Edge UI를 사용하여 가상 호스트에 대한 정보를 보려면 다음 안내를 따르세요.

http://ms-ip:9000에 로그인합니다. 여기서 ms-ip는 관리 서버 노드의 IP 주소 또는 DNS 이름입니다.
왼쪽 탐색 메뉴에서 관리 > 가상 호스트 를 선택합니다.
prod 또는 test 와 같은 환경을 선택합니다.
가상 호스트 탭을 클릭합니다.
환경에 정의된 가상 호스트가 표시됩니다. 키 저장소 또는 트러스트 저장소를 사용하도록 가상 호스트가 구성된 경우 표시를 클릭하여 자세한 내용을 확인합니다.

상단 탐색 메뉴에서 관리 > TLS 인증서 를 선택합니다.
환경을 선택합니다 (일반적으로 prod 또는 test).
키 저장소를 펼쳐 인증서를 확인합니다.

Edge API로 가상 호스트 보기

Edge API를 사용하여 가상 호스트에 대한 정보를 볼 수도 있습니다. 예를 들어 가상 호스트 나열 API는 모든 가상 호스트 목록을 반환합니다.

curl -X GET -H "accept:application/xml" \
    https://api.enterprise.apigee.com/v1/o/org_name/environments/env_name/virtualhosts \
    -u orgAdminEmail:pWord

여기서 orgAdminEmail:pWord는 조직 관리자의 사용자 이름과 비밀번호이고 org_name/env_name은 가상 호스트가 포함된 조직 및 환경을 지정합니다. 샘플 응답:

[
 "default",
 "secure"
]

특정 가상 호스트에 대한 정보를 보려면 가상 호스트 가져오기 API를 사용합니다.

curl -X GET -H "accept:application/xml" \
    https://api.enterprise.apigee.com/v1/o/org_name/environments/env_name/virtualhosts/vhost_name \
    -u orgAdminEmail:pWord

여기서 vhost_name은 가상 호스트의 이름입니다. 예를 들어 vhost_name을 'secure'로 지정하여 Apigee에서 만든 기본 보안 가상 호스트의 구성을 볼 수 있습니다.

<VirtualHost name="secure">
    <HostAliases>
        <HostAlias>api.myCompany.com</HostAlias>
    </HostAliases>
    <Port>443</Port>
    <Properties/>
    <Interfaces/>
    <RetryOptions/>
    <SSLInfo>
        <ClientAuthEnabled>false</ClientAuthEnabled>
        <Enabled>true</Enabled>
        <KeyAlias>freetrial</KeyAlias>
        <KeyStore>ref://freetrial</KeyStore>
        <IgnoreValidationErrors>false</IgnoreValidationErrors>
    </SSLInfo>
</VirtualHost>

참고: Edge for Private Cloud에서 api.enterprise.apigee.com 도메인 이름을 ms-ip:8080으로 바꿉니다. 여기서 ms-ip는 Edge 관리 서버의 IP입니다.

가상 호스트를 사용하도록 API 프록시 구성

새 API 프록시를 만들면 Edge는 조직에서 사용 가능한 모든 가상 호스트를 사용하도록 자동으로 구성합니다. 가상 호스트를 통한 API 프록시 요청은 다음 형식을 사용합니다.

https://host-alias/proxy-base-path/resource-path

각 항목의 의미는 다음과 같습니다.

host-alias는 일반적으로 가상 호스트의 DNS 이름입니다.
proxy-base-path는 API 프록시를 만들 때 정의되며 각 API 프록시에 고유합니다.
resource-path는 API 프록시를 통해 액세스할 수 있는 리소스의 경로입니다.

API 프록시에서 사용하는 가상 호스트 제어

API 프록시의 XML 구성에서 virtualhost 태그를 사용하여 API 프록시와 연결된 가상 호스트의 이름 을 지정합니다.

<HTTPProxyConnection>
  <BasePath>/v1/my/proxy/basepath</BasePath>
  <VirtualHost>secure</VirtualHost>
  <VirtualHost>default</VirtualHost>
</HTTPProxyConnection>

예를 들어 <VirtualHost>secure</VirtualHost>는 클라이언트가 "secure" 가상 호스트의 호스트 별칭을 사용하여 API 프록시를 호출할 수 있음을 의미합니다.

일반적으로 다음과 같은 경우 API 프록시와 연결된 가상 호스트를 수정합니다.

새 가상 호스트를 만들고 기존 API 프록시가 있습니다. 새 가상 호스트를 추가하려면 기존 API 프록시를 수정해야 합니다.
특정 가상 호스트를 통해 액세스할 수 없는 새 API 프록시를 만듭니다. API 프록시를 수정하여 정의에서 해당 가상 호스트를 삭제해야 합니다.

API 프록시와 연결된 가상 호스트를 수정하려면 다음 안내를 따르세요.

아래 설명된 대로 API 프록시 편집기에 액세스합니다.
Edge

Edge UI를 사용하여 API 프록시 편집기에 액세스하려면 다음 안내를 따르세요.
1. apigee.com/edge에 로그인합니다.
  Edge for Private Cloud 고객은 http://ms-ip:9000 (온프레미스)을 사용합니다. 여기서 ms-ip는 관리 서버 노드의 IP 주소 또는 DNS 이름입니다.
2. 왼쪽 탐색 메뉴에서 개발 > API 프록시 를 선택합니다.
3. 목록에서 수정할 API 프록시를 선택합니다.
기존 Edge (Private Cloud)

참고: 기존 Edge UI는 Edge for Private Cloud에서만 사용할 수 있습니다.

기존 Edge UI를 사용하여 API 프록시 편집기에 액세스하려면 다음 안내를 따르세요.
1. http://ms-ip:9000에 로그인합니다. 여기서 ms-ip는 관리 서버 노드의 IP 주소 또는 DNS 이름입니다.
2. 상단 탐색 메뉴에서 API > API 프록시 를 선택합니다.
3. 목록에서 수정할 API 프록시를 선택합니다.
개발 탭을 클릭합니다.
프록시 엔드포인트에서 기본값을 선택합니다.
코드 영역에서 다음을 수행합니다.
1. API 프록시에서 지원하지 않는 가상 호스트의 <VirtualHost> 요소를 삭제합니다.
2. 새 가상 호스트의 이름으로 새 <VirtualHost> 요소 를 추가합니다. 예를 들어 새 가상 호스트의 이름이 MyVirtualHost인 경우 다음 태그를 추가합니다.
```
<HTTPProxyConnection>
  <BasePath>/v1/my/proxy/basepath</BasePath>
  <VirtualHost>default</VirtualHost>
  <VirtualHost>secure</VirtualHost>
  <VirtualHost>MyVirtualHost</VirtualHost>
</HTTPProxyConnection>
```
API 프록시를 저장합니다. API 프록시가 배포된 경우 저장하면 새 설정으로 다시 배포됩니다.

API 프록시에 대해 Edge UI에 표시되는 기본 URL 설정

Edge UI는 프록시가 배포된 위치에 해당하는 가상 호스트 의 설정을 기반으로 API 프록시의 URL을 표시합니다. 이 표시에는 가상 호스트의 라우터 포트 번호가 포함될 수 있습니다.

대부분의 경우 Edge UI에 표시되는 URL은 프록시에 외부 요청을 보내는 데 사용되는 올바른 URL입니다. 하지만 일부 구성에서는 표시된 URL이 올바르지 않습니다. 예를 들어 다음 구성 중 하나라도 있으면 표시된 URL이 프록시에 외부 요청을 보내는 데 사용되는 실제 URL과 일치하지 않을 수 있습니다.

SSL 종료가 부하 분산기에서 발생합니다.
포트 매핑이 부하 분산기와 Apigee 라우터 간에 발생합니다.
경로 재작성으로 구성된 부하 분산기

Edge는 Edge UI에 표시되는 URL을 재정의할 수 있는 가상 호스트의 속성인 <BaseUrl>을(를) 지원합니다. 다음은 가상 호스트 객체 에 <BaseUrl> 속성이 있는 예시입니다. 이 예시에서 Edge UI에는 'http://myCo.com' 값이 표시됩니다.

<VirtualHost name="myTLSVHost">
  <HostAliases>
    <HostAlias>api.myCompany.com</HostAlias>
  </HostAliases>
  <BaseUrl>http://myCo.com</BaseUrl>
  <Port>443</Port>
  <SSLInfo>
    <Enabled>true</Enabled>
    <ClientAuthEnabled>false</ClientAuthEnabled>
    <KeyStore>ref://myTestKeystoreRef</KeyStore>
    <KeyAlias>myKeyAlias</KeyAlias>
  </SSLInfo>
</VirtualHost>

<BaseUrl> 값에는 프로토콜 (예: "http://" 또는 "https://")이 포함되어야 합니다.

<BaseUrl>이 설정되지 않은 경우 Edge UI에서 렌더링되는 기본 URL은 "api.myCompany.com"으로 표시되지만 실제 호스트 별칭은 "http://myCo.com"입니다.