UI を使用した DNS プロバイダー構成の追加

Secrets Manager UI を使用して、DNS プロバイダー構成をサービス・インスタンスに追加することができます。

1. コンソールで、**「メニュー」**アイコン **>「リソース・リスト」**をクリックします。

2. サービスのリストから、Secrets Manager のインスタンスを選択します。

3. **「シークレット・エンジン」ページで、「パブリック証明書」**タブをクリックします。

4. 「DNS プロバイダー」テーブルで、**「追加」**をクリックします。

5. 使用する DNS プロバイダーを選択します。

   現時点では、Cloud Internet Services (CIS) と IBM Cloud クラシック・インフラストラクチャーの構成を追加できます。 独自の DNS プロバイダーを使用することもできますが、この場合は構成する必要はありません。

6. Secrets Manager と選択された DNS プロバイダー間のサービス・アクセス権限を付与します。

   1. CIS を選択した場合は、許可されている CIS インスタンスのリストから選択するか、API キーを入力して、アクセス権限を付与します。

      まだ許可されませんか。 IAM コンソールで作成できます。 あるいは、API キーとインスタンスの CRN を指定して、CIS へのアクセス権限を付与することも可能です。 CRN は、CIS サービス・インスタンスの**「概要」**ページで見つけることができます。 CIS の API キーの作成について詳しくは、API キーを使用したサービス・アクセス権限の付与を参照してください。

   2. クラシック・インフラストラクチャーを選択する場合は、アカウントに関連付けられているユーザー名および API キーを入力します。

   3. 独自の DNS プロバイダーを使用する場合は、ご使用のプロバイダーの資料で手順を参照してください。 Secrets Managerでは DNS プロバイダーの構成は必要ありません。

7. 追加 をクリックします。

CLIからのDNSプロバイダー設定の追加

DNSプロバイダ設定をサービスインスタンスに追加するには、Secrets Managerを使用します。CLIを使用します。 手動 DNS プロバイダーは、API を使用することによってのみ構成できます。

シークレット・エンジンをIBM CloudCLIから構成するには、*コマンドを実行します。ibmcloud secrets-manager configuration-create を実行する。

ibmcloud secrets-manager configuration-create {
  "cloud_internet_services_apikey": "MY_APIKEY_WITH_MANAGER_ACCESS_TO_CIS",
  "cloud_internet_services_crn": "MY_CIS_CRN",
  "config_type": "public_cert_configuration_dns_cloud_internet_services",
  "name": "my-cloud-internet-services-config"}'

独自の DNS プロバイダーを使用する場合は、ご使用のプロバイダーの資料で手順を参照してください。 Secrets Managerでは DNS プロバイダーの構成は必要ありません。

API を使用した DNS プロバイダー構成の追加

Secrets Manager API を使用して、DNS プロバイダー構成をサービス・インスタンスに追加することができます。

独自の DNS プロバイダーを使用する場合は、ご使用のプロバイダーの資料で手順を参照してください。 Secrets Managerでは DNS プロバイダーの構成は必要ありません。

curl -X POST
  --H "Authorization: Bearer {iam_token}" \
  --H "Accept: application/json" \
  --H "Content-Type: application/json" \
  --d '{
    "cloud_internet_services_apikey": "5ipu_ykv0PMp2MhxQnDMn7VzrkSlBwi3BOI8uthi_EXZ",
    "cloud_internet_services_crn": "crn:v1:bluemix:public:internet-svcs:global:a/128e84fcca45c1224aae525d31ef2b52:009a0357-1460-42b4-b903-10580aba7dd8::",
    "config_type": "public_cert_configuration_dns_cloud_internet_services",
    "name": "cloud-internet-services-config"
  }' \  
  "https://{instance_ID}.{region}.secrets-manager.appdomain.cloud/api/v2/configurations"

curl -X POST
  --H 'Authorization: Bearer {iam_token}" \
  --H "Accept: application/json" \
  --H "Content-Type: application/json" \
  --d '{
  "classic_infrastructure_password": "sRBm1jkHOH2kn9oBnK5R0ODsRBm1jkHOH2kn9oBnK5R0ODsRBm1jkHOH2kn9oBnK5R0OD",
  "classic_infrastructure_username": "1234567_JohnDoe@mail.com",
  "config_type": "public_cert_configuration_dns_classic_infrastructure",
  "name": "classic-infrastructure-config"
}' \  
  "https://{instance_ID}.{region}.secrets-manager.appdomain.cloud/api/v2/configurations"

TerraformでDNSプロバイダの設定を追加する

TerraformでSecrets ManagerのDNSプロバイダ設定をサービスインスタンスに追加できます。

独自の DNS プロバイダーを使用する場合は、ご使用のプロバイダーの資料で手順を参照してください。 Secrets Managerでは DNS プロバイダーの構成は必要ありません。

resource "ibm_sm_public_certificate_configuration_dns_cis" "my_dns_cis_config" {
   instance_id = local.instance_id
   region = local.region
   name = "my_DNS_CIS_config"
   cloud_internet_services_apikey = var.my_cis_apikey
   cloud_internet_services_crn = var.my_cis_crn
   }

resource "ibm_sm_public_certificate_configuration_dns_classic_infrastructure" "my_dns_classic_config" {
   instance_id = local.instance_id
   region = local.region
   name = "my_DNS_config"
   classic_infrastructure_password = "username"
   classic_infrastructure_username = "password"
}

UI を使用した DNS プロバイダー構成の削除

構成が不要になったら、Secrets Manager UI を使用して構成を削除できます。

構成を削除すると、DNS プロバイダーに関連付けられている証明書の自動ローテーションができなくなります。 実動環境のアプリやサービスの証明書に関連付けられている構成は削除しないでください。

1. コンソールで、**「メニュー」**アイコン **>「リソース・リスト」**をクリックします。

2. サービスのリストから、Secrets Manager のインスタンスを選択します。

3. **「シークレット・エンジン」ページで、「パブリック証明書」**タブをクリックします。

4. **「DNS プロバイダー・セクション」**テーブルを使用して、インスタンスの構成を表示します。

5. 削除する構成の行で、**「アクション」**メニュー **>「削除」**をクリックします。

6. 構成の名前を入力して、その削除を確認します。

7. **「削除」**をクリックします。

API を使用した DNS プロバイダー構成の削除

Secrets Manager API を呼び出すと、構成を削除できます。

インスタンスから DNS プロバイダー構成を削除するために使用できる照会の例を以下に示します。 APIを呼び出すときには、{config_name}を、削除する構成の名前に置き換えます。

構成を削除すると、DNS プロバイダーに関連付けられている証明書の自動ローテーションができなくなります。 実動環境のアプリやサービスの証明書に関連付けられている構成は削除しないでください。

curl -X DELETE
--H "Authorization: Bearer {iam_token}" \
 "https://{instance_ID}.{region}.secrets-manager.appdomain.cloud/api/v2/configurations/{name}"

正常な応答によって、サービス・インスタンスから構成が削除されます。 必須およびオプションのリクエストパラメータの詳細については、設定の削除を参照してください。

UIでDNSプロバイダーの設定を取得する

Secrets Manager UI を使用して、DNS プロバイダーの値を取得できます。

1. 「パブリック証明書」 シークレット・エンジンで、「DNS プロバイダー」テーブルの 「アクション」 メニュー をクリックして、エンジン構成のオプションのリストを開きます。
2. 構成値を表示するには、 「構成の表示」 をクリックします。
3. 安全な環境にいることを確認したら、 「確認」 をクリックします。

シークレットの値が 15 秒間表示された後、ダイアログが閉じます。

CLI を使用した DNS プロバイダー構成の取得

Secrets Manager CLI を使用して、DNS プロバイダーの値を取得できます。 以下のコマンド例では、エンジン構成名をご使用の構成の名前に置き換えます。

ibmcloud secrets-manager configuration --name EXAMPLE_CONFIG --service-url https://{instance_ID}.{region}.secrets-manager.appdomain.cloud

{instance_ID} と {region} を、ご使用の Secrets Manager サービス・インスタンスに適用される値に置き換えます。 インスタンス固有のエンドポイント URL を見つけるには、Secrets Manager UI の 「エンドポイント」 ページからエンドポイント URL をコピーします。 詳細については、エンドポイント URL の表示を参照してください。

API を使用した DNS プロバイダー構成の取得

Secrets Manager API を使用して、DNS プロバイダーの値を取得できます。 以下の要求例では、エンジン構成名をご使用の構成の名前に置き換えてください。

curl -X GET --location --header "Authorization: Bearer {iam_token}" \
--header "Accept: application/json" \
"https://{instance_ID}.{region}.secrets-manager.appdomain.cloud/api/v2/configurations/{name}"

{instance_ID} と {region} を、ご使用の Secrets Manager サービス・インスタンスに適用される値に置き換えます。 インスタンス固有のエンドポイント URL を見つけるには、Secrets Manager UI の 「エンドポイント」 ページからエンドポイント URL をコピーします。 詳細については、エンドポイント URL の表示を参照してください。

レスポンスに成功すると、他のメタデータとともにエンジン・コンフィギュレーションの値が返される。 必須およびオプションのリクエスト・パラメータの詳細については、秘密の取得 を参照のこと。