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

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

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

Private Cloud용 Edge를 사용하여 Edge UI에서 암호화된 KVM 사용 설정

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

  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-service edge-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. 추가 를 클릭합니다.
  4. KVM에 항목을 추가하려면 다음 단계를 따르세요.
    1. 목록에서 KMV의 이름을 클릭하여 현재 항목을 표시합니다.
    2. + 를 클릭합니다.
    3. 아래 설명에 따라 새 KVM 항목의 속성 값을 입력합니다.
      속성 이름 설명
      키

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

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

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

      키의 값입니다. 숫자, 문자, 특수 문자를 조합하여 입력합니다.

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

기존 Edge (Private Cloud)

기존 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. 추가 를 클릭합니다.
  5. KVM에 항목을 추가하려면 다음 단계를 따르세요.
    1. 목록에서 KVM의 이름을 클릭하여 항목 목록을 펼칩니다.
    2. + 항목 을 클릭합니다.
    3. 아래 설명에 따라 새 KVM 항목의 속성 값을 입력합니다.
      속성 이름 설명
      키

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

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

      키의 값입니다. 숫자, 문자, 특수 문자를 조합하여 입력합니다.

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