Abrufen der Verbindungsdaten für Microsoft Azure Cosmos DB

Informationen zu dieser Task

In diesem Thema finden Sie eine Anleitung zum Abrufen der Verbindungsdaten für den „ Microsoft Azure “ Cosmos DB “-Konnektor.

Tipp: Ausführliche Informationen zum Abrufen der Verbindungsdaten finden Sie unter „Get Azure Cosmos DB credentials“ auf der Dokument ationsseite „ Microsoft Azure “ unter Cosmos DB.

Vorgehensweise

  1. Melden Sie sich beim Portal Microsoft Azure an.
  2. Um die Client-ID und den geheimen Schlüssel ( BASIC ) zu erhalten, führen Sie die folgenden Schritte aus:
    1. Klicken Sie auf „App-Registrierungen “.
    2. Klicken Sie auf der Seite „App-Registrierungen “ auf „Neue Registrierung “.
    3. Geben Sie auf der Seite „App registrieren“ einen eindeutigen Namen für Ihre App an.
    4. Wählen Sie im Abschnitt „Unterstützte Kontotypen“ eine Option aus, die Ihren Anforderungen entspricht.
    5. Klicken Sie auf „Registrieren “.

      Die Übers ichtsseite der Anwendung wird angezeigt.

      Übersichtsseite für die registrierte Anwendung
    6. Notieren Sie sich den Wert der Anwendungs-ID (Client-ID), da Sie diesen bei der Erstellung des Kontos unter App Connect als Verbindungswert angeben müssen.
    7. Klicken Sie im Feld „Client-Anmeldedaten“ auf der Übers ichtsseite auf „Zertifikat oder Geheimnis hinzufügen “. Diese Aktion öffnet die Seite „Zertifikate und Geheimnisse “.
      Seite „Zertifikate und Geheimnisse“ für die registrierte Anwendung
    8. Klicken Sie auf „+ Neues Client-Geheimnis “.
    9. Geben Sie im Bereich „Client-Geheimnis hinzufügen “ eine Beschreibung für das Geheimnis ein (z. B. App Connect secret) und wählen Sie anschließend eine Gültigkeitsdauer aus.
    10. Klicken Sie auf Hinzufügen.

      Der generierte Client-Schlüssel wird auf der Seite „Zertifikate und Schlüssel“ angezeigt.

      Generiertes Client-Geheimnis für die registrierte App
    11. Kopieren Sie den Wert des Client-Geheimnisses und speichern Sie ihn. Sie müssen diesen Wert als Verbindungswert angeben, wenn Sie das Konto unter App Connect erstellen.
      Hinweis: Der Wert des Client-Geheimnisses wird nach dem Verlassen dieser Seite nicht mehr vollständig angezeigt.
  3. Um den Wert der Mieter-ID ( BASIC ) zu ermitteln, führen Sie die folgenden Schritte aus:
    1. Rufen Sie die Anmeldeseite des Portals „ Microsoft Azure “ auf und navigieren Sie dann zu „Microsoft Entra ID“ > „Eigenschaften “.
    2. Kopieren Sie die Tenant-ID und bewahren Sie sie an einem sicheren Ort auf.
      So finden Sie die Mandanten-ID in Microsoft Entra ID

      Weitere Informationen zum Abrufen der Mandanten-ID finden Sie im Artikel „So finden Sie Ihre Microsoft Entra-Mandanten-ID“ in der Microsoft Entra-Dokumentation.

  4. Um ein neues Konto ( BASIC ) unter Microsoft Azure Cosmos DB zu erstellen, führen Sie die folgenden Schritte aus:
    1. Klicken Sie in der Liste der „ Azure “-Dienste auf „ Azure Cosmos DB “.
    2. Klicken Sie auf „+ Erstellen“, um ein neues Konto bei „ Azure Cosmos DB “ zu erstellen.

      Die Seite „ Azure Cosmos DB -Konto erstellen“ wird angezeigt.

    3. Klicken Sie auf die Schaltfläche „Erstellen“ in der Kachel „ Azure Cosmos DB “ für „ NoSQL “.
    4. Wählen Sie im Feld „Workload-Typ “ den gewünschten Workload-Typ aus.
    5. Wählen Sie eine Ressourcengruppe aus dem Menü aus oder klicken Sie auf „Neu erstellen“, um eine neue Ressourcengruppe anzulegen.
    6. Geben Sie den Namen für Ihren Namespace in das Feld „Kontoname“ ein.
    7. Wählen Sie im Feld „Standort“ die Region aus, in der Ihr Konto gehostet werden soll.
    8. Klicken Sie auf „Überprüfen + erstellen “.
    9. Prüfen Sie Ihre Einstellungen und klicken Sie dann auf Erstellen.
      Tipp: Ausführliche Informationen zur Erstellung eines Kontos finden Sie unter „Ein Konto erstellen “ in der Dokumentation zu „ Azure Cosmos DB “.
  5. Um einen neuen Container ( BASIC ) in Ihrem Konto unter Microsoft Azure Cosmos DB zu erstellen, führen Sie die folgenden Schritte aus:
    1. Klicken Sie in der Liste der „ Azure “-Dienste auf „ Azure Cosmos DB “.
    2. Wählen Sie das Konto aus, das Sie in Schritt 4 erstellt haben.
    3. Klicken Sie in der Seitenleiste auf „Data Explorer “.
    4. Klicken Sie auf „+ Neuer Container “.

      Das Dialogfeld „Neuer Container“ wird angezeigt.

    5. Geben Sie die Datenbank-ID, die Container-ID und den Partitionsschlüssel wie erforderlich ein.
    6. Klicken Sie auf OK.
    7. Tipp: Ausführliche Informationen zum Erstellen eines Containers finden Sie unter „Datenbank und Container erstellen “ in der Dokumentation zu „ Azure Cosmos DB “.
  6. Um Ihrer Anwendung mithilfe der Azure rollenbasierten Zugriffskontrolle (RBAC) Zugriff auf Ihr Microsoft Azure Cosmos DB Konto zu gewähren, weisen Sie der Anwendung die Rolle „Eigentümer“ oder „Mitwirkender“ zu (BASIC).
    1. Klicken Sie in der Liste der „ Azure “-Dienste auf „ Azure Cosmos DB “.
    2. Wählen Sie das Konto aus, das Sie in Schritt 4 erstellt haben.
    3. Klicken Sie in der Seitenleiste auf „Zugriffskontrolle (IAM) “.
    4. Klicken Sie auf „+ Hinzufügen “ > „Rollenzuweisung hinzufügen “.

      Die Seite „Rollen zuweisen“ wird angezeigt.

    5. Klicken Sie auf der Registerkarte „Rolle“ auf „Privilegierte Administratorrollen“ und wählen Sie „Eigentümer“ oder „Mitwirkender“ aus.
    6. Klicken Sie auf der Registerkarte „Mitglieder “ auf „+ Mitglieder auswählen “.
    7. Wählen Sie die Anwendung aus, die Sie in Schritt 2 erstellt haben, und klicken Sie auf „Auswählen “.
    8. Überprüfen Sie Ihre Einstellungen und klicken Sie auf die Schaltfläche „Überprüfen + zuweisen “.
  7. Um die Server- URL en ( API-Schlüssel und BASIC ) zu erhalten, führen Sie die folgenden Schritte aus:
    1. Klicken Sie in der Liste der „ Azure “-Dienste auf „ Azure Cosmos DB “, um sich bei Ihrem „ Microsoft Azure “-Konto unter Cosmos DB anzumelden.
    2. Klicken Sie im Bereich „Sicherheit + Netzwerk“ Ihres Microsoft Azure -Kontos unter Cosmos DB auf „Schlüssel “.
    3. Kopieren Sie den Wert aus dem URI -Feld (der URI-Wert ist Ihre App Connect Server-Adresse URL ).
  8. Um den Schlüsselwert ( API-Schlüssel ) zu erhalten, führen Sie die folgenden Schritte aus:
    1. Klicken Sie in der Liste der „ Azure “-Dienste auf „ Azure Cosmos DB “, um sich bei Ihrem „ Microsoft Azure “-Konto unter Cosmos DB anzumelden.
    2. Klicken Sie im Bereich „Sicherheit + Netzwerk“ Ihres Microsoft Azure -Kontos unter Cosmos DB auf „Schlüssel “.
    3. Kopieren Sie den Wert des PRIMARY KEY oder SECONDARY KEY (je nach Bedarf entweder schreib- oder schreibgeschützt) und bewahren Sie ihn an einem sicheren Ort auf.
      Hinweis: Sie können den Wert entweder des PRIMARY KEY oder des SECONDARY KEY in App Connect.