App-Entwickler registrieren

Diese Seite gilt für Apigee und Apigee Hybrid.

Apigee Edge-Dokumentation aufrufen

Registrieren und verwalten Sie Ihre App-Entwickler wie in folgenden Abschnitten beschrieben. Die App-Registrierung ist ein separater Prozess, der in Zugriff auf APIs durch Registrierung von Anwendungen steuern beschrieben wird.

Einführung

Apigee bietet viele Vorteile, die vollständig davon abhängen, wer Ihre APIs aufruft. Beispielsweise hängt die API-Sicherheit, die Trafficverwaltung und eine Vielzahl von Analysedaten davon ab, wer sie aufruft. Und woher weiß Apigee, wer Ihre APIs aufruft? Durch Lesen eindeutiger Informationen in jedem API-Aufruf, z. B. einer Nutzer-ID, eines API-Schlüssels oder eines OAuth-Tokens. Diese eindeutigen Informationen sperren oder entsperren die von Ihnen in API-Proxys entwickelte Funktionalität, sodass Sie uneingeschränkten Zugriff auf API-Zugriff und Funktionsweise erhalten.

Aus diesem Grund müssen sich App-Entwickler registrieren, um Ihre APIs zu verwenden. Anschließend fügen die Entwickler ihre Anwendungen ein, wählen die APIs aus, die sie verwenden möchten, und erhalten die eindeutigen API-Anmeldedaten (Nutzerschlüssel und Secrets), die für den Zugriff auf Ihre APIs erforderlich sind.

Warnung: API-Sicherheit, Traffic-Verwaltung und Entwickler-/App-Analysen sind von der ordnungsgemäßen API-Proxy-Konfiguration abhängig. Beispiel: Sie müssen Ihren Proxys die richtigen Richtlinien hinzufügen, z. B. zur Validierung der API-Schlüssel oder OAuth-Zugriffstoken-Tokens, Kontingent-Erzwingung und Ratenbegrenzung. Mit diesen Richtlinien wird bestimmt, welcher Entwickler und welche App den Aufruf durchführt. Dies wiederum ermöglicht die Erzwingung von API-Sicherheit, Entwickler- oder App-spezifische Traffic-Verwaltung, API-Analyseerfassung und weitere Funktionen. Technisch gesehen könnte man offene APIs entwickeln, die nicht auf API-Schlüsseln oder Zugriffstoken prüfen, was bedeutet, dass keine Entwickler registriert werden müssten. Wir raten allerdings dringend davon ab, da Sie dann die API-Sicherheit, die Kontrolle über die Leistung (durch eine gute Traffic-Verwaltung), Zugriff auf Analysedaten und viele weitere wichtige Vorteile von Apigee verlieren.

So registrieren Sie App-Entwickler

Registrieren Sie App-Entwickler mit einer folgender Methoden:

• Wenn Sie ein kostenpflichtiges Apigee-Konto nutzen, können sich Entwickler selbst über ein Entwicklerportal registrieren. Weitere Informationen finden sich in einem der folgenden Abschnitte, je nach Art des Entwicklerportals:
  • Integriertes Portal: Nutzerkonto im integrierten Portal erstellen
  • Drupal 10: App-Entwickler registrieren
• Administratoren können App-Entwickler über die API registrieren.
• Als Entwicklerportal-Administrator verwalten Sie Entwickler wie in folgenden Abschnitten beschrieben direkt auf Ihrem Portal:
  • Integriertes Portal: Nutzer verwalten, um Nutzerkonten zu verwalten.
    Hinweis: Nachdem ein Nutzer eine Anwendung auf dem integrierten Portal erstellt hat, wie in diesem Abschnitt beschrieben, werden die Kontoinformationen des Nutzers mit Apigee auf der Entwicklerseite synchronisiert und sind dort verfügbar. Der App-Entwicklerdatensatz ist mit dem Konto über die E-Mail-Adresse des Nutzers verknüpft. Weitere Informationen darüber, wo das Nutzerkonto und die zugehörigen Anwendungsinformationen gespeichert sind, finden Sie unter Speichern von Appentwickler-Kontoinformationen.
  • Drupal 10: Wie App-Entwickler mit dem Apigee Edge-Modul interagieren
• Als Organisationsadministrator verwalten Sie Entwickler, wie in den folgenden Abschnitten beschrieben, mit der Benutzeroberfläche oder der API von Apigee.

Hinweis: Wenn Portalnutzer ein Team im integrierten Portal erstellen, werden die Informationen des Entwicklerteams in Apigee gespeichert. Es wird eine eindeutige, automatisch generierte E-Mail-Adresse für den primären Schlüssel erstellt, den Apigee als Primärschlüssel zur Identifikation des Entwicklerteams nutzt. Weitere Informationen finden Sie unter Speicherort der Informationen des Entwicklerteams (Beta).

Empfehlungen für die Verwaltung von Nutzerkonten auf Entwicklerportalen

Apigee empfiehlt, Nutzerkonten direkt in Ihrem Entwicklerportal zu verwalten.

Wenn Sie das integrierte Portal verwenden, ist dies die einzige Möglichkeit, sicherzustellen, dass die Nutzerkonten auf dem integrierten Portal und Apigee synchron bleiben.

Wenn Sie das Drupal-basierte Entwicklerportal nutzen, bietet die Verwaltung von Nutzerkonten direkt im Entwicklerportal folgende Vorteile:

• Wenn Sie einen Entwickler über die Administratoroberfläche im Portal hinzufügen, können Sie das Passwort des Entwicklers für das Portal festlegen und automatisch eine E-Mail an den Entwickler senden lassen.

  Wenn Sie einen Entwickler mit Apigee hinzufügen oder ändern, wird keine E-Mail an den Entwickler gesendet und Sie können das Passwort für den Entwickler nicht im Portal festlegen. Daher müssen Entwickler ihr Passwort im Portal zurücksetzen, bevor sie sich im Portal anmelden können.

• Alle am Entwicklerkonto auf dem Portal vorgenommenen Änderungen werden automatisch an Apigee gesendet.

Wenn Sie Drupal-basierte Nutzerkonten mit Apigee verwalten möchten, müssen Sie App-Entwickler zwischen dem Portal und Apigee synchronisieren.

Die Entwicklerseite ansehen

Über die Apigee-UI auf die Entwicklerseite zugreifen und diese kennenlernen.

Hinweis: Nutzerkonten werden für integrierte Portale wie unter Nutzer verwalten beschrieben verwaltet. Nachdem ein Entwickler eine Anwendung auf dem integrierten Portal erstellt hat, wie unter Apps registrieren beschrieben, wird ein separater Entwicklerdatensatz erstellt, um die mit dem Nutzerkonto verknüpften Anwendungen zu verfolgen, auf die auf der Entwicklerseite zugegriffen werden kann. Der Entwicklerdatensatz ist mit der E-Mail-Adresse des Nutzers verknüpft.

So greifen Sie auf die Entwicklerseite zu:

• Wenn Sie https://console.cloud.google.com/apigee verwenden: Wählen Sie Verteilung > Entwickler aus.
• Wenn Sie die klassische Apigee-Benutzeroberfläche verwenden: Wählen Sie Veröffentlichen > Entwickler aus.

Auf der Seite Entwickler können Sie:

• Entwickler hinzufügen
• Entwicklerdetails ansehen und bearbeiten, einschließlich folgender:
• Benutzerdefinierte Attribute verwalten
• Entwickler aktivieren oder deaktivieren
• Veröffentlichungsdaten exportieren
• Entwickler löschen
• Liste der Entwickler untersuchen

Einen Entwickler hinzufügen

So fügen Sie einen Entwickler hinzu:

1. Rufen Sie die Entwicklerseite auf.
2. Klicken Sie auf + Entwickler.
3. Geben Sie die Entwicklerdetails ein, einschließlich Vorname, Nachname, E-Mail-Adresse und Nutzername.
4. Klicken Sie auf Erstellen.

Siehe auch Nutzer verwalten.

Entwicklerdetails ansehen und bearbeiten

Entwicklerdetails ansehen und bearbeiten.

So rufen Sie Entwicklerdetails auf und bearbeiten sie:

1. Rufen Sie die Entwicklerseite auf.
2. Klicken Sie auf die Zeile des Entwicklers, den Sie aufrufen und bearbeiten möchten, um die Entwicklerdetails aufzurufen.
3. Im Abschnitt Details werden die folgenden Informationen angezeigt. Bearbeiten Sie die Entwicklerdetails je nach Bedarf.

   Detail	Beschreibung
   Details	Vor- und Nachname, Nutzername und E-Mail-Adresse des Entwicklers; Registrierungsstatus und Dauer; und Entwickler-ID. Klicken Sie zum Bearbeiten der Entwicklerdetails in eines der folgenden Felder: Vorname Nachname E-Mail Nutzername Bearbeiten Sie den Inhalt und drücken Sie die Eingabetaste, um die Änderung zu bestätigen.
   Benutzerdefinierte Attribute	Für den Entwickler definierte benutzerdefinierte Attribute. Konfigurieren Sie benutzerdefinierte Attribute, je nach Bedarf. Weitere Informationen finden Sie unter Benutzerdefinierte Zuweisungen für Entwickler verwalten.
   Apps	Apps, die vom Entwickler registriert wurden. Zugriff auf APIs durch Registrierung von Anwendungen steuern

4. Aktivieren oder deaktivieren Sie den Entwickler im Feld Status.
   Weitere Informationen finden sich unter Entwickler aktivieren und deaktivieren.

Apigee speichert die folgenden Entitäten für mindestens 180 Sekunden im Cache, nachdem die Entitäten aufgerufen wurden.

• OAuth Zugriffstoken Das bedeutet, das Element ExpiresIn in der OAuth v2-Richtlinie kann ein Zugriffstoken nicht in weniger als 180 Sekunden entwerten.
• KMS-Entitäten (Key Management Service, Anwendungen, Entwickler, API-Produkte)
• Benutzerdefinierte Attribute für OAuth-Tokens und KMS-Entitäten.

Benutzerdefinierte Attribute für einen Entwickler verwalten

Sie können für jeden Entwickler bis zu 18 benutzerdefinierte Attribute hinzufügen.

So verwalten Sie benutzerdefinierte Attribute:

1. Rufen Sie die Entwicklerseite auf.
2. Klicken Sie auf die Zeile des Entwicklers, für den Sie benutzerdefinierte Attribute verwalten möchten, um die Entwicklerdetails aufzurufen.
3. Klicken Sie im Bereich Benutzerdefinierte Attribute auf +.
4. Geben Sie Attributnamen und Wert ein.
5. Klicken Sie auf .
6. Zum Löschen eines benutzerdefinierten Attributs bewegen Sie den Mauszeiger über das Attribut und klicken im Menü "Aktionen" auf .

Entwickler aktivieren und deaktivieren

Wenn sich ein App-Entwickler in Ihrem Portal selbst registriert, können Sie festlegen, ob er standardmäßig aktiviert ist oder nicht.

Ist ein Entwickler inaktiv, kann sich der Entwickler weiterhin beim Entwicklerportal anmelden und Apps erstellen, aber keiner der API-Schlüssel funktioniert. Die Anwendungen des Entwicklers behalten, ebenso wie die API-Schlüssel, den Status "Genehmigt" (oder einen anderen Status), obwohl sie für den Entwickler inaktiv sind.

Hinweis: Wenn Sie einen Entwickler deaktivieren, kann es einige Minuten dauern, bis die Änderung auf allen Nachrichtenprozessoren übernommen wird. Bis dahin können Aufrufe über die App des Entwicklers erfolgreich sein.

So aktivieren oder deaktivieren Sie einen Entwickler:

1. Rufen Sie die Entwicklerseite auf.
2. Klicken Sie auf die Zeile des Entwicklers, den Sie aktivieren oder deaktivieren möchten, um die Entwicklerdetails aufzurufen.
3. Setzen Sie im Bereich "Details" bei Bedarf das Feld Status auf Aktiv oder Inaktiv, wie erforderlich.
4. Falls sich der Entwickler in mehreren Organisationen befindet, wiederholen Sie die Schritte.

Veröffentlichungsdaten exportieren

Exportieren Sie folgende Veröffentlichungsdaten als Datei mit kommagetrennten Werten (CSV-Datei):

• Entwicklerdetails
• Entwickler-, Anwendungs- und API-Produktdetails

So exportieren Sie Veröffentlichungsdaten:

1. Rufen Sie die Entwicklerseite auf.
2. Klicken Sie auf CSV-Datei exportieren ...
3. Wählen Sie im Drop-down-Menü Entwickler oder Entwickler, Anwendungen und Produkte aus.

Die ausgewählten Veröffentlichungsdaten werden als CSV-Datei heruntergeladen.

Entwickler löschen

Warnung: Wenn Sie einen Entwickler löschen, werden er und alle zugehörigen Artefakte (z. B. Anwendungen und API-Schlüssel) vollständig aus der Organisation entfernt. Damit Entwickler und ihre Artefakte nicht dauerhaft gelöscht werden, können Sie dieEntwickler stattdessen deaktivieren.

So löschen Sie einen Entwickler:

1. Rufen Sie die Entwicklerseite auf.
2. Bewegen Sie den Mauszeiger auf die zu löschende Zeile des Entwicklers, um das Aktionsmenü einzublenden.
3. Klicken Sie auf .
4. Klicken Sie zur Bestätigung noch einmal auf Löschen.

App-Entwickler zwischen Portal und Apigee synchronisieren

Wenn Sie APIs mit einem Drupal-basierten Entwicklerportal veröffentlichen, werden Änderungen an Apigee verwendenden App-Entwicklern nicht an das Portal weitergegeben. Damit diese Änderungen im Portal angezeigt werden müssen Sie sich als Portaladministrator beim Portal anmelden und das Portal mit Apigee synchronisieren.

Hinweis: Wenn Sie das Drupal-basierte Entwicklerportal verwenden, empfiehlt Apigee, dass Sie App-Entwickler direkt auf Ihrem Portal verwalten und Apigee nicht verwenden. Siehe Empfehlungen für die Verwaltung von Nutzerkonten auf Entwicklerportalen.

Informationen zum Synchronisieren Ihres Entwicklerportals mit den auf Apigee definierten App-Entwicklern finden sich im folgenden Abschnitt:

Drupal 10: Entwickler mit Apigee synchronisieren

Entwickler mit der API verwalten

Verwalten Sie Entwickler mit den APIs für Entwickler.