App-Entwickler registrieren

Sie sehen die Dokumentation zu Apigee Edge.
Zur Apigee X-Dokumentation
weitere Informationen

Registrieren und verwalten Sie Ihre App-Entwickler wie in folgenden Abschnitten beschrieben. (Die App-Registrierung ist ein separater Prozess, der unter Apps registrieren und API-Schlüssel verwalten beschrieben wird).

Einführung

Edge 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ß Edge, 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.

So registrieren Sie App-Entwickler

Registrieren Sie App-Entwickler mit einer folgender Methoden:

Empfehlungen für die Verwaltung von Entwicklerkonten auf Entwicklerportalen

Apigee empfiehlt, dass Sie Entwicklerkonten direkt in Ihrem Entwicklerportal verwalten.

Wenn Sie das integrierte Portal verwenden, ist dies die einzige Möglichkeit, um sicherzustellen, dass die Entwicklerkonten im integrierten Portal und in Edge synchron bleiben.

Wenn Sie das Drupal-basierte Entwicklerportal nutzen, bietet die Verwaltung von Entwicklerkonten 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 mithilfe von Edge hinzufügen oder ändern, wird keine E-Mail an den Entwickler gesendet und Sie können kein Passwort für den Entwickler im Portal festlegen. Daher müssen Entwickler ihr Passwort im Portal zurücksetzen, bevor sie sich im Portal anmelden können.

  • Alle Änderungen, die im Portal am Entwicklerkonto vorgenommen werden, werden automatisch an Edge gesendet.

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

Die Entwicklerseite ansehen

Greifen Sie über die Edge-Benutzeroberfläche und die klassische Edge-Benutzeroberfläche auf die Entwicklerseite zu.

Edge

So greifen Sie über die Edge-Benutzeroberfläche auf die Entwicklerseite zu:

  1. Melden Sie sich unter apigee.com/edge an.
  2. Wählen Sie in der linken Navigationsleiste Veröffentlichen > Apps aus.

Die Entwicklerseite wird angezeigt.

Wie in der Abbildung hervorgehoben, können Sie auf der Entwicklerseite Folgendes tun:

Classic Edge (Private Cloud)

So greifen Sie über die Classic Edge-Benutzeroberfläche auf die Entwicklerseite zu:

  1. Melden Sie sich bei http://ms-ip:9000 an, wobei ms-ip die IP-Adresse oder der DNS-Name des Knotens des Verwaltungsservers ist.
  2. Wählen Sie in der oberen Navigationsleiste Veröffentlichen > Entwickler aus.

Die Entwicklerseite wird angezeigt.

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.

Entwicklerdetails ansehen und bearbeiten

Entwicklerdetails ansehen und bearbeiten. Bei Organisationen mit aktivierter Monetarisierung können Sie die unter Monetarisierungsattribute konfigurieren definierten benutzerdefinierten Monetarisierungsattribute 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 Bereich „Details“ werden die folgenden Informationen angezeigt. Bearbeiten Sie die Entwicklerdetails je nach Bedarf.
    Detailierte Informationen Beschreibung
    Details Vor- und Nachname, Nutzername und E-Mail-Adresse des Entwicklers; Registrierungsstatus und Dauer; und Entwickler-ID.
    Klicke 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:
    Apps Apps, die vom Entwickler registriert wurden. Siehe Apps registrieren.
  4. Aktivieren oder deaktivieren Sie den Entwickler im Feld "Status".
    Weitere Informationen finden sich unter Entwickler aktivieren und deaktivieren.

Mit Apigee Edge for Public Cloud behält Edge die folgenden Entitäten mindestens 180 Sekunden lang im Cache, nachdem auf die Entitäten zugegriffen wurde.

  • OAuth Zugriffstoken Dies bedeutet, dass ein widerrufenes Token möglicherweise weiterhin bis zu drei Minuten gültig ist, bis sein Cache-Limit abgelaufen ist.
  • 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

Du kannst für jeden Entwickler bis zu 18 benutzerdefinierte Attribute hinzufügen, einschließlich der unter Monetarisierungsattribute konfigurieren beschriebenen Monetarisierungsattribute.

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.

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

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 dem Portal und Edge synchronisieren

Wenn Sie ein Drupal-basiertes Entwicklerportal verwenden, um Ihre APIs zu veröffentlichen, werden Änderungen an App-Entwicklern, die Edge verwenden, nicht an das Portal weitergegeben. Sie müssen sich als Portaladministrator im Portal anmelden und das Portal mit Edge synchronisieren, damit diese Änderungen im Portal angezeigt werden.

Informationen zum Synchronisieren Ihres Entwicklerportals mit den in Edge definierten App-Entwicklern finden Sie in den folgenden Abschnitten:

Entwickler in Unternehmen gruppieren

Bei der Monetarisierung besteht ein Unternehmen aus mehreren Entwicklern, die als eine Einheit verwaltet werden. Ein Unternehmen kann eine beliebige Gruppierung sein, die für Ihre Organisation geeignet ist, z. B. Geschäftseinheit, Produktlinie oder Abteilung. Das Gruppieren von Entwicklern in Unternehmen ist nützlich, wenn mehrere Entwickler einer einzigen Unternehmenseinheit zugeordnet sein müssen. Es kann beispielsweise sein, dass Sie zu Abrechnungszwecken unterschiedliche Unternehmen einrichten müssen. Entwickler in Ihrer Organisation müssen jedoch nicht mit einem Unternehmen verknüpft sein. Ein Entwickler ist immer eine einzelne Entität, die durch das E-Mail-Element eindeutig identifiziert wird. Wenn ein Entwickler zu einem Unternehmen gehört, wird der Name des Unternehmens auf der Seite „Entwickler“ angezeigt.

Weitere Informationen zum Verwalten von Unternehmen und Entwicklern für die Monetarisierung findest du unter Unternehmen und Entwickler verwalten.

Monetarisierungsattribute konfigurieren

Wenn Sie einen Entwickler über die Benutzeroberfläche bearbeiten oder über die API erstellen oder bearbeiten, können Sie die in der folgenden Tabelle definierten Monetarisierungseigenschaften konfigurieren. Zuerst konfigurieren Sie die Monetarisierungseigenschaften für die Organisation, wenn Sie das Organisationsprofil bearbeiten.

Feldname Name des benutzerdefinierten Attributs Beschreibung
Adresse MINT_DEVELOPER_ADDRESS

Adresse des Entwicklers, einschließlich der folgenden Felder: Adresse (Zeilen 1 und 2), Stadt, Bundesland, Postleitzahl und Land.

Abrechnungsprofil MINT_BILLING_PROFILE

Abrechnungszeitraum für Ihre Organisation. Gültige Werte sind:

  • PRORATED: Die Abrechnung basiert auf der Anzahl der Tage, an denen ein API-Produkt in einem Kalendermonat genutzt wird.
  • CALENDAR_MONTH: Die Abrechnung erfolgt monatlich.
Abrechnungsart MINT_BILLING_TYPE

Das für die Abrechnung verwendete Zahlungsmodell des Entwicklers. Der Wert kann einer der folgenden sein:

  • Vorauszahlung: Der Entwickler zahlt im Voraus für die Nutzung eines API-Produkts. Wenn das API-Produkt verwendet wird, wird der Betrag vom Guthaben des Entwicklers abgezogen. Der Entwickler muss über ein ausreichendes Prepaidguthaben für den Kauf des API-Produkts verfügen.
  • Nachträgliche Abrechnung: Die Nutzung von API-Produkten wird dem Entwickler monatlich (über eine Rechnung) in Rechnung gestellt. Der Entwickler bezahlt die Kosten für die Nutzung von API-Produkten gemäß den Zahlungsbedingungen, die in den Tarifen auf der Rechnung festgelegt sind.
  • BOTH (Beides): Unterstützt beide Abrechnungstypen. Die Standardeinstellung ist PREPAID.

Siehe Prepaid- und Postpaid-Abrechnungstypen mit der API konfigurieren.

Kategorie MINT_DEVELOPER_CATEGORY Entwicklerkategorie, der Sie den Entwickler hinzufügen möchten. Eine Entwicklerkategorie ist eine Gruppe von Entwicklern oder Unternehmen mit ähnlichen Merkmalen. Weitere Informationen findest du unter Entwicklerkategorien verwalten.
Unternehmens-ID MINT_COMPANY_ID Unternehmens-ID, falls zutreffend. Weitere Informationen finden Sie unter Entwickler in Unternehmen gruppieren.
Entwicklertyp MINT_DEVELOPER_TYPE Dieses Attribut wird von Apigee nicht verwendet.

Entwicklertyp. Gültige Werte: TRUSTED oder UNTRUSTED

Ist Makler MINT_IS_BROKER Flag, das angibt, ob der Umsatz auf Nettobasis basiert.
Rechtsgültiger Name MINT_DEVELOPER_LEGAL_NAME Vollständiger Name des Entwicklers, der in allen Berichten verwendet wird.
Hinweis: Dieses Attribut ist erforderlich, wenn der Entwickler nicht mit einem Unternehmen verknüpft ist und einen veröffentlichten Preisplan abonnieren möchte.
Selbstabrechnung MINT_HAS_SELF_BILLING Flag, das angibt, ob Rechnungen mit Selbstabrechnung aktiviert sind. Wenn diese Option aktiviert ist (true), wird bei der Monetarisierung anstelle einer Umsatzbeteiligung eine eigene Rechnung erstellt. Eine Rechnung zur Selbstabrechnung ist ein Finanzdokument, in dem der an den Entwickler fällige Betrag aufgeführt ist. Sie dient dem API-Anbieter als Rechnung im Namen des Entwicklers.
Steuerbefreiungsnummer MINT_TAX_EXEMPT_AUTH_NO Ggf. amtliche Steuerbefreiungsnummer.
Steuersatz MINT_APPROX_TAX_RATE Ungefährer Steuersatz für den Entwickler. Geben Sie einen Dezimalwert mit maximal drei Zeichen vor dem Dezimaltrennzeichen und vier nach dem Dezimalzeichen an.

Entwickler mit der API verwalten

Verwalten Sie Entwickler mit den APIs für Entwickler.

Wenn Sie einen Entwickler mithilfe der API erstellen und aktualisieren, können Sie die unter Monetarisierungsattribute konfigurieren beschriebenen Monetarisierungsattribute nach Bedarf konfigurieren.