Secrets Manager 인스턴스 관리 CLI

IBM Cloud® Secrets Manager 인스턴스 관리 명령줄 인터페이스(CLI)를 사용하여 명령줄에서 Secrets Manager Vault Dedicated 인스턴스를 관리할 수 있습니다.

현재 버전: 2.0.7

Vault Dedicated 요금제는 현재 공개 베타 버전으로 제공되고 있습니다. 베타 기능은 평가 및 테스트 목적으로 제공되며, 일반에 공개된 기능에 비해 일부 제한 사항이 있습니다.

시작하기 전에

시작하기 전에 IBM Cloud CLI를 설치한 다음, 다음 명령을 실행하여 Secrets Manager 인스턴스 관리 CLI 플러그인을 설치하십시오:

ibmcloud plugin install secrets-manager-instance-management

IBM Cloud CLI 및 플러그인에 대한 업데이트가 사용 가능한 경우 명령행에서 알림을 받습니다. 최신 명령어를 사용할 수 있도록 CLI를 최신 상태로 유지하세요. ibmcloud plugin list를 실행하여 설치된 모든 플러그인의 현재 버전을 볼 수 있습니다.

Secrets Manager 인스턴스를 대상으로 설정

Secrets Manager Vault 전용 인스턴스를 대상으로 하려면 다음 옵션 중 하나를 사용하십시오.

  • ibmcloud secrets-manager-instance-management config set 명령을 실행하십시오.

    ibmcloud secrets-manager-instance-management config set service-url https://{instance_ID}.{region}.secrets-manager.cloud.ibm.com

  • Secrets Manager 제어 플레인 서비스 엔드포인트( URL )가 포함된 환경 변수를 내보내세요.

    export SECRETS_MANAGER_INSTANCE_MANAGEMENT_URL=https://{instance_ID}.{region}.secrets-manager.cloud.ibm.com

  • 명령에서 서비스 엔드포인트를 설정하십시오.

    ibmcloud secrets-manager-instance-management instance --service-url https://{instance_ID}.{region}.secrets-manager.cloud.ibm.com

{instance_ID} 및 {region} 을 사용자의 Secrets Manager Vault Dedicated 서비스 인스턴스에 해당하는 값으로 대체하십시오. 인스턴스에 특정한 엔드포인트 URL을 찾으려면 Secrets Manager UI의 엔드포인트 페이지에서 복사할 수 있습니다. 자세한 정보는 엔드포인트 URL 보기를 참조하십시오.

글로벌

명령

ibmcloud secrets-manager-instance-management docs

웹 브라우저에서 플러그인 설명서를 엽니다.

ibmcloud secrets-manager-instance-management docs
예
ibmcloud secrets-manager-instance-management docs

옵션

--region (문자열)
Vault Dedicated 인스턴스를 프로비저닝한 지역입니다. 이용 가능한 지역: us-south, eu-de.
--output (문자열)
출력 형식을 선택하십시오. 'json', 'yaml' 또는 'table'일 수 있습니다. 기본값은 'table'입니다.
-j, --jmes-query (문자열)
출력을 사용자 정의하도록 JMESPath 조회를 제공합니다.
--service-url (문자열)
API의 기본 엔드포인트 URL을 제공합니다.
-q, --quiet
자세한 메시지를 표시하지 않습니다.
-v, --version
플러그인 버전을 출력합니다.

예

ibmcloud secrets-manager-instance-management \
    --region=us-south \
    --output=json \
    --jmes-query="[:10]" \
    --service-url="https://myservice.cloud.ibm.com" \
    --quiet

이 예제는 모든 하위 명령어에서 사용할 수 있는 전역 옵션을 보여주기 위한 것일 뿐, 그 자체로는 유효한 명령어가 아닙니다.

Config

글로벌 매개변수는 영구 설정에 저장할 수도 있으므로, 플러그인이 호출될 때마다 수동으로 지정할 필요가 없습니다. 각 매개변수는 config 명령어와 해당 하위 명령어를 사용하여 구성할 수 있습니다.

ibmcloud secrets-manager-instance-management config

ibmcloud secrets-manager-instance-management config set

특정 옵션에 대한 새 구성 값을 설정합니다. set 명령어의 각 하위 명령어는 전역 옵션과 대응됩니다. 각 하위 명령어는 하나의 인수를 받으며, 이 인수는 해당 옵션에 저장할 값을 문자열로 나타낸 것입니다.

ibmcloud secrets-manager-instance-management config set <option> <value>

예제

ibmcloud secrets-manager-instance-management config set service-url \
    'https://{region}.secrets-manager.cloud.ibm.com'

ibmcloud secrets-manager-instance-management config get

특정 옵션에 대해 현재 설정된 값을 출력합니다. get 명령어의 각 하위 명령어는 전역 옵션과 대응됩니다.

ibmcloud secrets-manager-instance-management config get <option>

예제

ibmcloud secrets-manager-instance-management config get service-url

ibmcloud secrets-manager-instance-management config unset

특정 옵션에 대해 현재 설정된 값을 설정 해제합니다. unset 명령어의 각 하위 명령어는 전역 옵션과 대응됩니다.

이 서비스에서 사용할 수 있는 하위 명령어는 다음과 같습니다: service-url,.

ibmcloud secrets-manager-instance-management config unset <option>

예제

ibmcloud secrets-manager-instance-management config unset service-url

ibmcloud secrets-manager-instance-management config list

현재 설정된 구성 값을 모두 나열합니다.

ibmcloud secrets-manager-instance-management config list

예제

ibmcloud secrets-manager-instance-management config list

토큰

관리자 토큰 관리.

ibmcloud secrets-manager-instance-management admin-token-create

Vault Dedicated 클러스터에 인증하기 위한 Vault 관리자 토큰을 생성합니다. 이 토큰은 1시간 동안 유효하며, 관리자 권한을 부여합니다. 초기 설정 및 클러스터 관리 용도로만 사용하고, 사용 후에는 즉시 권한을 취소하십시오.

ibmcloud secrets-manager-instance-management admin-token-create --id ID [--region REGION] [-j, --jmes-query JMES-QUERY] [--output OUTPUT] [-q, --quiet]

명령 옵션

--id (문자열)

Secrets Manager 인스턴스 ID. 필수.

길이는 36 자여야 합니다. 값은 정규 표현식 /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/ 과 일치해야 합니다.

예

요청 예제

ibmcloud secrets-manager-instance-management admin-token-create --id bfc50c2e-d66d-4f37-9ccf-9713f8325b39

ibmcloud secrets-manager-instance-management admin-tokens-delete

모든 활성 Vault 관리자 토큰을 취소하십시오. 이로 인해 기존의 모든 관리자 토큰이 즉시 무효화됩니다.

ibmcloud secrets-manager-instance-management admin-tokens-delete --id ID [--region REGION] [-j, --jmes-query JMES-QUERY] [--output OUTPUT] [-q, --quiet]

명령 옵션

--id (문자열)

Secrets Manager 인스턴스 ID. 필수.

길이는 36 자여야 합니다. 값은 정규 표현식 /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/ 과 일치해야 합니다.

예

요청 예제

ibmcloud secrets-manager-instance-management admin-tokens-delete --id bfc50c2e-d66d-4f37-9ccf-9713f8325b39

인스턴스

코드가 수정되었습니다.

ibmcloud secrets-manager-instance-management instance-details

클러스터 상태, 엔드포인트 및 키 관리 서비스를 포함한 서비스 인스턴스 세부 정보를 확인합니다.

ibmcloud secrets-manager-instance-management instance-details --id ID [--region REGION] [-j, --jmes-query JMES-QUERY] [--output OUTPUT] [-q, --quiet]

명령 옵션

--id (문자열)

Secrets Manager 인스턴스 ID. 필수.

길이는 36 자여야 합니다. 값은 정규 표현식 /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/ 과 일치해야 합니다.

예

요청 예제

ibmcloud secrets-manager-instance-management instance-details --id bfc50c2e-d66d-4f37-9ccf-9713f8325b39

출력 예

응답 예시

{
  "id" : "12345678-abcd-1234-abcd-1234567890ab",
  "name" : "Example Instance",
  "href" : "https://us-south.secrets-manager.cloud.ibm.com/v2/instances/12345678-abcd-1234-abcd-1234567890ab",
  "instance_crn" : "crn:v1:bluemix:public:secrets-manager:us-south:a/a1b2c3d4e5f61234567890abcdef1234:12345678-abcd-1234-abcd-1234567890ab::",
  "plan" : "dedicated",
  "vault_cluster" : {
    "status" : "healthy",
    "version" : "1.21.2+ent.hsm"
  },
  "endpoints" : {
    "public" : {
      "vault_api" : "https://12345678-abcd-1234-abcd-1234567890ab.us-south.secrets-manager.appdomain.cloud",
      "vault_ui" : "https://12345678-abcd-1234-abcd-1234567890ab.us-south.secrets-manager.appdomain.cloud/ui"
    },
    "private" : {
      "vault_api" : "https://private.12345678-abcd-1234-abcd-1234567890ab.us-south.secrets-manager.appdomain.cloud",
      "vault_ui" : "https://private.12345678-abcd-1234-abcd-1234567890ab.us-south.secrets-manager.appdomain.cloud/ui"
    }
  },
  "encryption" : {
    "mode" : "customer_managed",
    "provider" : "key_protect",
    "key_crn" : "crn:v1:bluemix:public:kms:us-south:a/a1b2c3d4e5f61234567890abcdef1234:abcd1234-ab12-ab12-ab12-abcdef123456:key:12ab34cd-12ab-12ab-12ab-123456abcdef"
  }
}