환경 키-값 맵 만들기 및 수정

현재 Apigee Edge 문서가 표시되고 있습니다.
Apigee X 문서로 이동 정보

이 주제에서는 UI에서 키-값 맵 (KVM)을 만들고 수정하는 방법을 보여줍니다. UI에서 만드는 KVM은 환경 범위가 지정되어 있습니다. KVM 및 범위에 관한 자세한 내용은 키-값 맵 작업을 참고하세요.

프라이빗 클라우드용 Edge를 사용하여 Edge UI에서 암호화된 KVM 사용 설정

암호화된 KVM은 Edge for Private Cloud 버전 4.17.01 이상에서 지원됩니다. 그러나 Edge UI의 암호화된 KVM 지원은 기본적으로 사용 중지되어 있습니다. 암호화된 KVM을 지원하도록 Edge UI를 사용 설정하려면 다음 안내를 따르세요.

  1. Edge UI 서버에서 편집기에서 ui.properties 파일을 엽니다. 파일이 존재하지 않으면 만듭니다.
    > vi /opt/apigee/customer/application/ui.properties
  2. conf_apigee_apigee.feature.kvmencryption 토큰을 true로 설정합니다.
    conf_apigee_apigee.feature.kvmencryption=true
  3. 변경사항을 저장합니다.
  4. ui.properties의 소유자를 'apigee":
    > chown apigee:apigee /opt/apigee/customer/application/ui.properties로 변경합니다.
  5. Edge UI를 다시 시작합니다.
    > /<inst_root>/apigee/apigee-service/bin/apigee-serviceedge-ui restart

환경 키-값 맵 관리

아래에 설명된 대로 KVM을 관리합니다. KVM은 환경 범위에서 정의됩니다. 예를 들어 'test' 환경에서 KVM을 만드는 경우 'prod' 환경에서 실행되는 API 프록시는 KVM에 액세스할 수 없습니다.

에지

Edge UI를 사용하여 KVM을 관리하려면 다음 안내를 따르세요.

  1. apigee.com/edge에 로그인합니다.
  2. 왼쪽 탐색 메뉴에서 관리 > 환경 > 키-값 맵을 선택합니다.
  3. KVM을 만들려면 다음 안내를 따르세요.
    1. + 키-값 맵을 클릭합니다.
    2. 새 KVM의 속성 값을 입력합니다. 다음 표에서는 설정을 설명합니다.
      속성 이름 설명
      이름 KVM의 이름입니다. 환경에서 고유해야 하며, KVM과 상호작용하는 정책에서 이 이름을 참조합니다.
      암호화됨KVM의 암호화 여부를 지정하는 플래그입니다. UI에서 암호화된 값은 별표 (*****)로 표시됩니다. 암호화는 지도 전체에 설정됩니다. 항목별로 암호화 항목을 설정할 수 없습니다.
      참고: KVM은 만들 때만 암호화할 수 있습니다. 키-값 맵은 생성된 후에는 암호화하거나 복호화할 수 없습니다.
    3. Add를 클릭합니다.
  4. KVM에 항목을 추가하려면 다음 안내를 따르세요.
    1. 목록에서 KMV 이름을 클릭하여 현재 항목을 표시합니다.
    2. +를 클릭합니다.
    3. 아래에 설명된 대로 새 KVM 항목의 속성 값을 입력합니다.
      속성 이름 설명
      키

      API 프록시의 데이터 값에 액세스하는 데 사용할 키 이름입니다.

      퍼블릭 클라우드용 Apigee Edge에서 키 이름은 2KB를 초과할 수 없습니다.

      Edge UI에서 이름에는 '/'를 포함할 수 없습니다.
      값

      키 값입니다. 숫자, 문자 또는 특수문자를 조합하여 입력하세요.

      참고: KVM의 총 크기는 15MB 이하여야 합니다.
    4. Add를 클릭합니다.
  5. KVM에서 키 항목을 관리하려면 다음 안내를 따르세요.
    1. 목록에서 KVM의 이름을 클릭하여 현재 항목을 표시합니다.
    2. KVM 항목 위에 커서를 가져가 작업 메뉴를 표시하고 다음 작업 중 하나를 실행합니다.
      • 항목의 값을 복사하려면 를 클릭합니다.
      • 항목을 수정하려면 를 클릭하세요. 그런 다음 항목을 수정하고 업데이트를 클릭합니다.
      • 항목을 삭제하려면 를 클릭합니다. 그런 다음 삭제를 클릭하여 작업을 확인합니다.

Classic Edge (Private Cloud)

Classic Edge UI를 사용하여 KVM을 만들고 수정하려면 다음 안내를 따르세요.

  1. http://ms-ip:9000에 로그인합니다. 여기서 ms-ip는 관리 서버 노드의 IP 주소 또는 DNS 이름입니다.
  2. API > 환경 구성 > 키-값 맵을 선택합니다.
  3. test 또는 prod와 같이 캐시를 구성할 환경을 선택합니다.
  4. KVM을 만들려면 다음 안내를 따르세요.
    1. + 키-값 맵을 클릭합니다.
    2. 아래에 설명된 대로 새 KVM의 속성 값을 입력합니다.
      속성 이름 설명
      이름 KVM의 이름입니다. 환경에서 고유해야 하며, KVM과 상호작용하는 정책에서 이 이름을 참조합니다.
      암호화됨KVM의 암호화 여부를 지정하는 플래그입니다. UI에서 암호화된 값은 별표 (*****)로 표시됩니다. 암호화는 지도 전체에 설정됩니다. 항목별로 암호화 항목을 설정할 수 없습니다.
      참고: KVM은 만들 때만 암호화할 수 있습니다. 키-값 맵은 생성된 후에는 암호화하거나 복호화할 수 없습니다.
    3. Add를 클릭합니다.
  5. KVM에 항목을 추가하려면 다음 안내를 따르세요.
    1. 목록에서 KVM의 이름을 클릭하여 항목 목록을 펼칩니다.
    2. + 항목을 클릭합니다.
    3. 아래에 설명된 대로 새 KVM 항목의 속성 값을 입력합니다.
      속성 이름 설명
      키

      API 프록시의 데이터 값에 액세스하는 데 사용할 키 이름입니다. Edge UI에서 이름에는 '/'를 포함할 수 없습니다.

      참고: 퍼블릭 클라우드용 Edge를 사용하는 경우 키 이름이 2KB를 초과할 수 없습니다.
      값

      키 값입니다. 숫자, 문자 또는 특수문자를 조합하여 입력하세요.

      참고: KVM의 총 크기는 15MB 이하여야 합니다.
    4. 저장을 클릭합니다.
  6. KVM에서 키 항목을 수정하거나 삭제하려면 다음 안내를 따르세요.
    1. 목록에서 KVM의 이름을 클릭하여 키 항목 목록을 펼칩니다.
    2. 다음 작업 중 하나를 실행합니다.
      • 항목을 수정하려면 수정을 클릭하고 항목을 수정한 다음 저장을 클릭합니다.
      • 항목을 삭제하려면 삭제를 클릭합니다.