<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: - 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
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.
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: