App-Entwickler registrieren

Sie lesen gerade die Dokumentation zu Apigee Edge.
Zur Dokumentation zu Apigee X. info

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, Entwicklerkonten direkt in Ihrem Entwicklerportal zu verwalten.

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

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-Nachricht an den Entwickler senden lassen.

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

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

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

Die Entwicklerseite ansehen

Über die Edge-Benutzeroberfläche und die Classic Edge-Benutzeroberfläche auf die Entwicklerseite zugreifen und diese kennenlernen.

Edge

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

  1. Melden Sie sich bei 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 Management Server-Knotens ist.
  2. Wählen Sie in der oberen Navigationsleiste Veröffentlichen > Apps 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, für die die Monetarisierung aktiviert ist, können Sie die benutzerdefinierten Monetarisierungsattribute bearbeiten, die unter Monetarisierungsattribute konfigurieren definiert sind.

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.
    Detail 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 finden Sie unter:
    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.

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

  • OAuth Zugriffstoken Das bedeutet, dass ein widerrufenes Token bis zu drei Minuten lang erfolgreich sein kann, bis die Cache-Beschränkung abläuft.
  • 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, einschließlich der Monetarisierungsattribute, die unter Monetarisierungsattribute konfigurieren beschrieben sind.

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

Wenn Sie APIs mit einem Drupal-basierten Entwicklerportal veröffentlichen, werden Änderungen an App-Entwicklern, die Edge verwenden, 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 Edge synchronisieren.

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

Entwickler in Unternehmen gruppieren

Bei der Monetarisierung ist ein Unternehmen eine Sammlung von Entwicklern, die als eine einzelne Entität verwaltet werden. Ein Unternehmen kann jede 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 unter einer einzelnen juristischen Person zusammengefasst werden müssen. Beispielsweise müssen Sie möglicherweise verschiedene Unternehmen für Abrechnungszwecke einrichten. Entwickler in Ihrer Organisation müssen jedoch nicht mit einem Unternehmen verknüpft sein. Ein Entwickler ist immer eine einzelne Entität, die eindeutig durch das Element „E-Mail“ identifiziert wird. Wenn ein Entwickler Teil eines Unternehmens ist, wird der Name des Unternehmens auf der Seite „Entwickler“ angezeigt.

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

Monetarisierungsattribute konfigurieren

Wenn Sie einen Entwickler über die Benutzeroberfläche bearbeiten oder einen Entwickler ü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 (Zeile 1 und 2), Ort, 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 verwendet wird.
  • CALENDAR_MONTH: Die Abrechnung erfolgt monatlich.
Abrechnungsart MINT_BILLING_TYPE

Zahlungsmodell für Entwickler, das für die Abrechnung verwendet wird. Der Wert kann einer der folgenden sein:

  • PREPAID: Der Entwickler bezahlt im Voraus für die Nutzung eines API-Produkts. Wenn das API-Produkt verwendet wird, werden die Mittel vom Guthaben des Entwicklers abgezogen. Der Entwickler muss über ein Prepaidguthaben verfügen, das zum Kauf des API-Produkts ausreicht.
  • POSTPAID: Dem Entwickler wird die Nutzung von API Produkten monatlich in Rechnung gestellt. Der Entwickler bezahlt für die Nutzung von API-Produkten basierend auf den Zahlungsbedingungen, die in den auf der Rechnung enthaltenen Tarifen angegeben sind.
  • BOTH: Unterstützt beide Abrechnungsarten. Die Standardeinstellung ist PREPAID.

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

Kategorie MINT_DEVELOPER_CATEGORY Entwicklerkategorie, der Sie den Entwickler hinzufügen möchten. Eine Entwicklerkategorie ist eine Gruppierung von Entwicklern oder Unternehmen mit ähnlichen Merkmalen. Weitere Informationen finden Sie unter Entwicklerkategorien verwalten.
Unternehmens-ID MINT_COMPANY_ID Unternehmens-ID, falls zutreffend. Weitere Informationen finden Sie unter Grouping developers into companies.
Entwicklertyp MINT_DEVELOPER_TYPE Diese Property wird von Apigee nicht verwendet.

Entwicklertyp. Gültige Werte sind: TRUSTED oder UNTRUSTED
Ist Wettvermittler MINT_IS_BROKER Flag, das angibt, ob der Umsatz auf dem Nettobetrag basiert.
Rechtsgültiger Name MINT_DEVELOPER_LEGAL_NAME Rechtsgültiger Name des Entwicklers, der in allen Berichten verwendet wird.
Hinweis: Dieses Attribut ist erforderlich, wenn der Entwickler nicht mit einem Unternehmen gruppiert ist und einen veröffentlichten Tarif 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 eine Rechnung mit Selbstabrechnung anstelle einer Umsatz beteiligung erstellt. Eine Rechnung mit Selbstabrechnung ist ein Finanzdokument, in dem der dem Entwickler geschuldete Betrag aufgeführt ist. Sie fungiert als Rechnung an den API-Anbieter im Namen des Entwicklers.
Steuerbefreiungsnummer MINT_TAX_EXEMPT_AUTH_NO Steuerbefreiungsnummer der Regierung, falls zutreffend.
Steuersatz MINT_APPROX_TAX_RATE Ungefährer Steuersatz für den Entwickler. Geben Sie einen Dezimalwert mit maximal 3 Zeichen vor dem Dezimaltrennzeichen und 4 Zeichen nach dem Dezimaltrennzeichen an.

Entwickler mit der API verwalten

Verwalten Sie Entwickler mit den APIs für Entwickler.

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