DNS-Providerkonfiguration in der Benutzerschnittstelle hinzufügen

Sie können DNS-Provider-Konfigurationen zu Ihrer Serviceinstanz hinzufügen, indem Sie die Secrets Manager-Benutzerschnittstelle verwenden.

1. Klicken Sie in der Konsole auf das Symbol Menü > Ressourcenliste.

2. Wählen Sie in der Liste der Services Ihre Instanz von Secrets Manager aus.

3. Klicken Sie auf der Seite Engines für geheime Schlüssel auf die Registerkarte Öffentliche Zertifikate.

4. Klicken Sie in der Tabelle mit den DNS-Providern auf Hinzufügen.

5. Wählen Sie den DNS-Provider aus, den Sie verwenden möchten.

   Derzeit können Sie Konfigurationen für Cloud-Internet-Services (CIS) und die klassische IBM Cloud-Infrastruktur hinzufügen. Sie können auch Ihren eigenen DNS-Anbieter verwenden, aber in diesem Fall ist keine Konfiguration erforderlich.

6. Erteilen Sie den Servicezugriff zwischen Secrets Manager und Ihrem ausgewählten DNS-Provider.

   1. Wenn Sie CIS wählen, gewähren Sie den Zugriff, indem Sie aus einer Liste von autorisierten CIS Instanzen auswählen.

      Haben Sie noch keine Berechtigung? Sie können eine Berechtigung in der IAM-Konsole erstellen. Sie können den Zugriff auf CIS gewähren, indem Sie entweder einen API-Schlüssel oder die CRN der Instanz angeben. Sie finden den CRN auf der Seite Übersicht Ihrer CIS-Serviceinstanz. Wenn Sie es vorziehen, einen API-Schlüssel für CIS zu verwenden, lesen Sie den Abschnitt Gewährung des Dienstzugangs mit einem API-Schlüssel. Andernfalls geben Sie die CRN der Instanz an, nachdem Sie die Berechtigung erstellt haben.

   2. Wenn Sie die klassische Infrastruktur auswählen, geben Sie den Benutzername und API-Schlüssel ein, der Ihrem Konto zugeordnet ist.

   3. Wenn Sie Ihren eigenen DNS-Anbieter verwenden möchten, finden Sie in der Dokumentation Ihres Anbieters entsprechende Anweisungen. Unter Secrets Manager ist keine Konfiguration des DNS-Anbieters erforderlich.

7. Klicken Sie auf Hinzufügen.

Hinzufügen einer DNS-Anbieterkonfiguration über die CLI

Sie können DNS-Anbieterkonfigurationen zu Ihrer Serviceinstanz hinzufügen, indem Sie die Secrets Manager CLI verwenden. Manuelle DNS-Anbieter können nur über die API konfiguriert werden.

Um eine Secrets-Engine über die IBM Cloud CLI zu konfigurieren, führen Sie den ibmcloud secrets-manager configuration-create befehl aus.

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"}'

Wenn Sie Ihren eigenen DNS-Anbieter verwenden möchten, finden Sie in der Dokumentation Ihres Anbieters entsprechende Anweisungen. Unter Secrets Manager ist keine Konfiguration des DNS-Anbieters erforderlich. Wenn Sie eine IAM-Dienstberechtigung verwenden möchten, lassen Sie cloud_internet_services_apikey weg.

DNS-Providerkonfiguration mit der API hinzufügen

Sie können DNS-Provider-Konfigurationen zu Ihrer Serviceinstanz hinzufügen, indem Sie die Secrets Manager-API verwenden.

Wenn Sie Ihren eigenen DNS-Anbieter verwenden möchten, finden Sie in der Dokumentation Ihres Anbieters entsprechende Anweisungen. Unter Secrets Manager ist keine Konfiguration des DNS-Anbieters erforderlich.

curl -X POST
  --H "Authorization: Bearer {iam_token}" \
  --H "Accept: application/json" \
  --H "Content-Type: application/json" \
  --d '{
    "cloud_internet_services_apikey": "5ipu..",
    "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"

Hinzufügen einer DNS-Provider-Konfiguration mit Terraform

Sie können DNS-Anbieterkonfigurationen zu Ihrer Serviceinstanz hinzufügen, indem Sie Terraform für Secrets Manager verwenden.

Wenn Sie Ihren eigenen DNS-Anbieter verwenden möchten, finden Sie in der Dokumentation Ihres Anbieters entsprechende Anweisungen. Unter Secrets Manager ist keine Konfiguration des DNS-Anbieters erforderlich.

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"
}

DNS-Providerkonfiguration in der Benutzerschnittstelle löschen

Wenn Sie eine Konfiguration nicht mehr benötigen, können Sie sie über die Secrets Manager-Benutzerschnittstelle löschen.

Nachdem Sie eine Konfiguration gelöscht haben, können die Zertifikate, die dem DNS-Provider zugeordnet sind, nicht mehr automatisch gewechselt werden. Löschen Sie keine Konfigurationen, die Zertifikate in Ihren Produktionsanwendungen oder -services zugeordnet sind.

1. Klicken Sie in der Konsole auf das Symbol Menü > Ressourcenliste.

2. Wählen Sie in der Liste der Services Ihre Instanz von Secrets Manager aus.

3. Klicken Sie auf der Seite Engines für geheime Schlüssel auf die Registerkarte Öffentliche Zertifikate.

4. Verwenden Sie die Tabelle DNS-Provider-Abschnitt, um die Konfigurationen in Ihrer Instanz anzuzeigen.

5. Klicken Sie in der Zeile für die zu löschende Konfiguration auf das Aktionen Menü > Löschen.

6. Geben Sie den Namen der Konfiguration ein, um den Löschvorgang zu bestätigen.

7. Klicken Sie auf Löschen.

DNS-Providerkonfiguration mit der API löschen

Sie können Konfigurationen löschen, indem Sie die Secrets Manager-API aufrufen.

Das folgende Beispiel zeigt eine Abfrage, die Sie verwenden können, um eine DNS-Providerkonfiguration aus Ihrer Instanz zu entfernen. Wenn Sie die API aufrufen, ersetzen Sie {config_name} durch den Namen der zu löschenden Konfiguration.

Nachdem Sie eine Konfiguration gelöscht haben, können die Zertifikate, die dem DNS-Provider zugeordnet sind, nicht mehr automatisch gewechselt werden. Löschen Sie keine Konfigurationen, die Zertifikate in Ihren Produktionsanwendungen oder -services zugeordnet sind.

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

Bei einer erfolgreichen Antwort wird die Konfiguration aus der Serviceinstanz entfernt. Weitere Informationen über die erforderlichen und optionalen Abfrageparameter finden Sie unter Entfernen einer Konfiguration.

Abrufen einer DNS-Anbieterkonfiguration in der Benutzeroberfläche

Sie können den Wert eines DNS-Anbieters über die Benutzeroberfläche Secrets Manager abrufen.

1. Klicken Sie in der Engine für öffentliche Geheimzertifikate auf das Aktionen in der Tabelle DNS-Anbieter, um eine Liste mit Optionen für die Konfiguration Ihrer Engine zu öffnen.
2. Um den Konfigurationswert anzuzeigen, klicken Sie auf Konfiguration anzeigen.
3. Klicken Sie auf Bestätigen, nachdem Sie sich vergewissert haben, dass Sie sich in einer sicheren Umgebung befinden.

Der geheime Wert wird 15 Sekunden lang angezeigt, dann wird das Dialogfeld geschlossen.

Abrufen einer DNS-Anbieterkonfiguration über CLI

Sie können den Wert eines DNS-Anbieters über die Secrets Manager CLI abrufen. Ersetzen Sie in dem folgenden Beispielbefehl den Namen der Motorkonfiguration durch den Namen Ihrer Konfiguration.

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

Ersetzen Sie {instance_ID} und {region} durch die Werte, die für Ihre Serviceinstanz von Secrets Manager gelten. Um die Endpunkt-URL zu finden, die für Ihre Instanz spezifisch ist, können Sie sie von der Seite Endpunkte in der Benutzerschnittstelle von Secrets Manager kopieren. Weitere Informationen finden Sie unter Endpunkt-URLs anzeigen.

Abrufen einer DNS-Anbieterkonfiguration über API

Sie können den Wert eines DNS-Anbieters über die API Secrets Manager abrufen. Ersetzen Sie in der folgenden Beispielanforderung den Namen der Motorkonfiguration durch den Namen Ihrer Konfiguration.

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}"

Ersetzen Sie {instance_ID} und {region} durch die Werte, die für Ihre Serviceinstanz von Secrets Manager gelten. Um die Endpunkt-URL zu finden, die für Ihre Instanz spezifisch ist, können Sie sie von der Seite Endpunkte in der Benutzerschnittstelle von Secrets Manager kopieren. Weitere Informationen finden Sie unter Endpunkt-URLs anzeigen.

Eine erfolgreiche Antwort gibt den Wert der Motorkonfiguration zusammen mit anderen Metadaten zurück. Weitere Informationen über die erforderlichen und optionalen Abfrageparameter finden Sie unter Abrufen eines Geheimnisses.