Informationen zu Organisationen

<ph type="x-smartling-placeholder"></ph> Sie sehen die Dokumentation zu Apigee Edge.
Gehen Sie zur Apigee X-Dokumentation.
Weitere Informationen

Eine Organisation ist der übergeordnete Container in Apigee Edge. Sie enthält alle Ihre API-Proxys und die zugehörigen Ressourcen. Im weiteren Verlauf dieses Themas werden Organisationen ausführlicher behandelt. Hier ein paar nützliche Hinweise:

  • Standardmäßig ist der Name Ihrer Organisation in der URL enthalten, die zum Aufrufen Ihrer API-Proxys verwendet wird, wie wie unter Informationen zu virtuellen Hosts beschrieben. Beispiel:
    http(s)://your_org_name-environment.apigee.net/proxy_base_path/...
  • Der Name Ihrer Organisation ist in der URL der Edge-Verwaltungsbenutzeroberfläche enthalten. Die folgende URL zeigt beispielsweise die API-Proxys für die Organisation docs an:

    In der URL apigee.com/organizations/docs/proxies ist /docs/ eingekreist.

  • Sie haben zwar nur eine Organisation erstellt, können aber zu anderen Organisationen als Nutzer oder Administrator mit bestimmten Berechtigungen gehören. Wenn Sie in der Edge-Management-Benutzeroberfläche Organisationen zu verwalten, können Sie zu einer anderen Organisation wechseln, wie unter Zwischen Organisationen wechseln beschrieben.

  • Wenn Sie als Nutzer im Organisationsadministrator Aufrufe mit der Verwaltungs-API tätigen ist die Organisation bei den meisten Aufrufen ein erforderlicher Bestandteil des Pfads. Beispiel: Verwaltungs-API-cURL-Anfrage gibt eine Liste aller API-Proxys in einer Organisation zurück:
    curl https://api.enterprise.apigee.com/v1/organizations/your_org_name/apis -u org_admin_email_address

Video: In einem kurzen Video erfahren Sie, wie Organisationen eine mandantenfähige Architektur für die API-Verwaltung unterstützen.

Organisationskomponenten

Wenn Sie ein Edge-Konto erstellen, erstellt Edge automatisch eine Organisation für Sie. Einmal können Sie Ihrer Organisation Nutzer hinzufügen, API-Proxys und API-Produkte erstellen und Entwickler und Apps zu registrieren.

Die folgende Abbildung zeigt die Hauptkomponenten des Edge-Organisationsmodells. Dieses definiert, wie Ihre APIs, API-Produkte, Apps und App-Entwickler Edge

Ein Flussdiagramm zeigt, wie die Umgebung, der Nutzer, das API-Produkt und die Entwicklerin oder der Entwickler
    die Anwendung, den API-Schlüssel/OAuth-Token und den API-Proxy.

Dieses Modell zeigt nicht alle Funktionen von Apigee Edge. Wenn du die Monetarisierung nutzt, hat das Modell zusätzliche Komponenten. Weitere Informationen finden Sie unter Monetarisierung: Übersicht Weitere Informationen finden Sie unter Unternehmen und Entwickler verwalten finden Sie Informationen zur Verwaltung von Unternehmen und Entwicklern durch Monetarisierung.

<ph type="x-smartling-placeholder">

Organisationsnamen

Der Name der Organisation lautet:

  • Evaluierungsorganisation: username-eval
  • Kostenpflichtige Organisation:Benutzerdefiniert bei der ersten Bereitstellung

Nachdem eine Organisation erstellt wurde, können Sie sie nicht mehr umbenennen.

Der Organisationsname wird Teil der URL zu Ihren API-Proxys und Teil der URL, wenn eine Anfrage an die Edge-Verwaltungs-API senden. Beispiel: Eine typische URL für den Zugriff auf eine API Proxy hat die Form:

http://org-name-env.apigee.net/v1/weather/forecastrss

Dabei gilt:

  • org-name ist der Name Ihrer Organisation.
  • env ist die Bereitstellungsumgebung des API-Proxys, die entweder Test- oder prod.

Beispiel:

http://myorg-test.apigee.net/v1/weather/forecastrss

Organisationskomponenten

In der folgenden Tabelle werden die Komponenten des Organisationsmodells näher beschrieben:

Komponente Beschreibung

Organisation

Jedes Apigee-Konto ist einer oder mehreren Organisationen auf Apigee Edge zugeordnet. Die Organisation enthält eine Darstellung aller Komponenten, einschließlich API-Proxys, API Produkten, API-Paketen, Apps und Entwicklern.

Kontoinhaber sind nicht auf eine einzelne Organisation beschränkt. Einige Kontoinhaber definieren oder definieren mehrere Organisationen, die unterschiedliche Communitys für App-Entwickler unterstützen.

Umgebung Ein Laufzeitkontext für die API-Proxys in einer Organisation. Weitere Informationen finden Sie im Abschnitt unten finden Sie weitere Informationen zu Umgebungen.

Nutzer

Innerhalb einer Organisation, in der die Person, die das Konto erstellt, automatisch ein Administrator ist, können Sie weitere Nutzer erstellen. Nutzer bilden das API-Team der Organisation, z. B. Administratoren, API-Proxy und API-Produktersteller, Nutzer, die Analysen und andere Statistiken überwachen usw.

Unterschiedliche Nutzer haben unterschiedliche Rollen und Zugriffsberechtigungen. Definieren Sie beispielsweise einige Nutzer als Organisationsadministratoren und Betriebsadministratoren mit Berechtigungen die Organisation und ihre Komponenten modifizieren können. Definieren Sie andere Nutzer mit Berechtigungen für API-Proxys und API-Produkte zu erstellen, aber ohne die Berechtigung, andere Nutzenden.

Nutzer können Mitglieder mehrerer Organisationen sein. Zum Beispiel könnte Ihr Unternehmen mehrere Organisationen auf Apigee Edge, um verschiedene Entwickler-Communitys zu unterstützen. Intern erstellen jedoch dieselben Personen alle API-Proxys und API-Produkte und werden daher Mitglieder all Ihrer Organisationen.

Sie müssen kein Apigee-Konto erstellen, also ein Apigee-Konto. Organisation – als Nutzer zu sein. Ein Administrator kann Sie einer vorhandenen Unternehmen.

Alle Nutzer melden sich hier bei Apigee Edge an: https://enterprise.apigee.com.

API-Proxy

Die Nutzer in einer Organisation erstellen einen oder mehrere API-Proxys. Ein API-Proxy definiert eine Zuordnung eines öffentlich verfügbaren HTTP-Endpunkts zu einem Back-End-Dienst. API-Proxys können auch so konfiguriert sein, dass sie Sicherheitsmaßnahmen wie OAuth einschließt, Nachrichtentransformationen ausführen (z. B. als XML zu JSON), den Traffic zu Back-End-Diensten beschränken und andere wertvolle Vorgänge ausführen in der Anfrage, in der Antwort und mit Dienst-Callouts.

Edge erfasst Daten für Analysen zu API-Proxys.

API-Produkt

Die Nutzer in einer Organisation erstellen ein oder mehrere API-Produkte, wobei ein API-Produkt Ein Paket von API-Proxys in Kombination mit einem Serviceplan. Mit diesem Tarif können Sie bei API-Proxys, bieten Sicherheit, ermöglichen Monitoring und Analysen zusätzliche Funktionen.

Edge sammelt Daten für Analysen von API-Produkten.

Entwickler

Eine Organisation hat einen oder mehrere Entwickler, die die Anwendungen erstellen, die die in Ihrer Organisation definierten APIs (in API-Produkten) nutzen. Entwickler nutzen APIs, können jedoch keine APIs erstellen oder andere Aktionen in der Organisation ausführen.

Entwickler können zu Ihrem Unternehmen gehören, Partner oder externe Entwickler sein, die für den Zugriff auf Ihre APIs bezahlen.

Entwickler müssen in Ihrer Organisation registriert sein, bevor sie eine App registrieren und einen API-Schlüssel für den Zugriff auf Ihre APIs erhalten können. Als API-Anbieter können Sie Entwickler in Ihrer Organisation hinzufügen, aktualisieren oder entfernen. Sie können sie manuell hinzufügen Edge-Management-Benutzeroberfläche verwenden, erstellen Sie ein Entwicklerportal, um sie über eine Website oder definieren Sie Ihren eigenen Registrierungsmechanismus mithilfe der Edge-Verwaltung der API erstellen.

Ein Entwickler muss kein Konto bei Edge haben und die meisten Entwickler werden auch die Sie über Edge wissen müssen. Wenn der Entwickler ein Edge-Konto hat, in der Regel als Nutzer in einer anderen Organisation oder um die Edge API-Dienste zu verwenden.

App

Entwickler erstellen eine oder mehrere Clientanwendungen, die Ihre APIs nutzen.

Entwickler müssen ihre Anwendungen in Ihrer Organisation registrieren. Eine App in Edge ist ein Darstellung der eigentlichen App eines Entwicklers, die dem Entwickler einen API-Schlüssel für die Nutzung gibt die bei jeder Anfrage an Ihre APIs übergeben werden.

Da alle Apps in Ihrer Organisation registriert sind, können Sie mithilfe von Edge Analysedaten zur App und deren Nutzung überwachen und erfassen.

API-Schlüssel/OAuth-Token

Abhängig von dem Autorisierungsmechanismus, den Sie für Ihre APIs definieren, übergibt die App eine API-Schlüssel bei jeder Anfrage an Ihre APIs verwenden. Wenn der Schlüssel gültig ist, ist die Anfrage zulässig. Edge unterstützt verschiedene Arten der Authentifizierung, z. B. einen einfachen API-Schlüssel, zweibeiniges OAuth, dreibeiniges OAuth und weitere.

Als API-Anbieter müssen Sie festlegen, wie Entwickler ihre Apps registrieren. Dazu wird die App registriert, die Sie an den Entwickler zurückgeben, um den Schlüssel für den Zugriff auf Ihre APIs zu erhalten.

Bei der Registrierung der App kann der Entwickler auf ein einzelnes API-Produkt oder auf mehrere API-Produkte zugreifen. Die tatsächliche App des Entwicklers verwendet für den Zugriff auf alle API-Produkte, die mit der App verknüpft sind (die registrierte Darstellung der App des Entwicklers in Edge).

Sie können den Schlüssel jederzeit widerrufen, sodass die Anwendung des Entwicklers nicht mehr auf Ihre APIs zugreifen kann. Die registrierte Darstellung der Anwendung des Entwicklers ist jedoch weiterhin in Ihrer Organisation vorhanden. Alternativ können Sie ein Zeitlimit für einen Schlüssel definieren, sodass der Entwickler den Schlüssel nach einer bestimmten Zeit aktualisieren muss.

Informationen zu Umgebungen

Eine Umgebung ist ein Kontext zur Laufzeitausführung für die API-Proxys in einer Organisation. Bevor Sie auf einen API-Proxy zugreifen können, müssen Sie ihn in einer Umgebung bereitstellen. Sie können einen API-Proxy in einer einzelnen Umgebung oder in mehreren Umgebungen bereitstellen.

Eine Organisation kann mehrere Umgebungen enthalten. Sie können z. B. dev definieren, test- und prod-Umgebung in einer Organisation.

<ph type="x-smartling-placeholder">

Die Organisation bietet einen Bereich für einige Apigee-Funktionen. Beispiel: Schlüsselwertzuordnung (KVM) Daten können auf Organisationsebene zur Verfügung gestellt werden, was bedeutet, dass API-Proxys, die auf beliebigen dieselben Daten von KVM erhalten. Einige Funktionen, z. B. das Caching, können auf das Unternehmen oder eine bestimmte Umgebung innerhalb des Unternehmens. Apigee-Analysedaten sind nach einer Kombination aus Organisation und Umgebung partitioniert.

Unten sehen Sie die wichtigsten Rechtssubjekte, die Sie innerhalb einer Organisation verwalten, einschließlich der definierten Rechtssubjekte global innerhalb der Organisation und für Umgebungen, die speziell für eine bestimmte Umgebung definiert wurden: