Globale Nutzer erstellen

Sie lesen gerade die Dokumentation zu Apigee Edge.
Apigee X-Dokumentation aufrufen. info

Erstellen Sie einen globalen Nutzer über die Edge-Benutzeroberfläche, die Edge API oder direkt über die Apigee-Website, wie unten beschrieben.

  • Edge-Benutzeroberfläche
    Sowohl für Edge for Public Cloud als auch für Edge for Private Cloud verwendet ein Organisationsadministrator die Edge-Benutzeroberfläche, um einen globalen Nutzer mit einer bestimmten Rolle zu einer bestehenden Organisation hinzuzufügen. Wenn der Nutzer bereits vorhanden ist, wird er der Organisation hinzugefügt.

    Wenn der Nutzer nicht vorhanden ist, wird er in Edge erstellt und erhält eine E-Mail-Nachricht, in der er aufgefordert wird, das Konto zu aktivieren und ein Passwort festzulegen. Der Nutzer wird sofort in der Edge-Benutzeroberfläche angezeigt, auch bevor er das Konto aktiviert.

    Der Organisationsadministrator hat zwar nicht die Berechtigung, den Nutzer direkt zu erstellen, aber wenn er einen neuen Nutzer in der Edge-Benutzeroberfläche zur Organisation hinzufügt, wird der Edge-Workflow zur Erstellung des Nutzers gestartet.
  • Edge API
    In einer Edge for Private Cloud-Installation erstellt ein Systemadministrator mit der Edge API einen globalen Nutzer.

    Nachdem Sie den Nutzer erstellt haben, müssen Sie einen zweiten API-Aufruf ausführen, um den Nutzer einer Systemadministratorrolle, einer Organisation und einer Organisationsrolle oder beidem hinzuzufügen. Der neue Nutzer kann sich erst in der Edge-Benutzeroberfläche anmelden, wenn er einer Organisation hinzugefügt wurde.

  • Apigee-Website
    Jeder kann sich unter https://login.apigee.com/sign_up für ein kostenloses Edge-Cloud-Konto registrieren. Wenn Sie ein Konto direkt in Edge erstellen, werden automatisch ein globaler Nutzer und eine Organisation für Sie erstellt und Ihrem Nutzerkonto wird die Rolle des Organisationsadministrators für Ihre Organisation zugewiesen. Nachdem Sie das Konto erstellt haben, kann ein anderer Organisationsadministrator Sie seiner Organisation hinzufügen.

    Weitere Informationen finden Sie unter Apigee Edge-Konto erstellen.

Globalen Nutzer über die Edge-Benutzeroberfläche erstellen

Ein Organisationsadministrator kann einen Nutzer in der Edge-UI erstellen und dem neuen Nutzer eine Rolle in der Organisation zuweisen:

  1. Rufen Sie die Seite „Nutzer“ wie unten beschrieben auf.

    Edge

    So greifen Sie über die Edge-Benutzeroberfläche auf die Seite „Nutzer“ zu:

    1. Melden Sie sich unter https://apigee.com/edge als Organisationsadministrator an.
    2. Wählen Sie Admin > Nutzer aus.

      Wenn Sie kein Administrator der Organisation sind, ist dieses Menü nicht verfügbar.

    Neue Edge-UI (Private Cloud)

    So greifen Sie über die neue Edge-Benutzeroberfläche auf die Seite „Nutzer“ zu:

    1. Melden Sie sich als Organisationsadministrator unter http://host:3001/edge in der neuen Edge-Benutzeroberfläche an. Dabei ist host die IP-Adresse oder der DNS-Name des Hosts, auf dem die neue Edge-Benutzeroberfläche ausgeführt wird.
    2. Wählen Sie Admin > Nutzer aus.

      Wenn Sie kein Administrator der Organisation sind, ist dieses Menü nicht verfügbar.

  2. Klicken Sie auf + Nutzer.

    Die Seite „Neuer Nutzer“ wird angezeigt.

  3. Geben Sie die E-Mail-Adresse des Nutzers ein.
  4. Wählen Sie die Rollen aus, die Sie dem Nutzer zuweisen möchten.
    Sie können einem Nutzer mehrere Rollen zuweisen.
  5. Klicken Sie auf Speichern.

    Der Nutzer wird in der Edge-Benutzeroberfläche angezeigt und Edge sendet dem neuen Nutzer eine E‑Mail mit einer Anleitung zum Aktivieren seines Kontos und zur Anmeldung.

Der Nutzer kann sich mit einer der folgenden Methoden in der Edge-Benutzeroberfläche anmelden:

  • E-Mail-Adresse
  • Der Nutzername, also der Teil der E‑Mail-Adresse vor dem @-Zeichen.

Globalen Nutzer über die Edge API erstellen

In Apigee Edge for Private Cloud ist das Hinzufügen eines neuen Nutzers über die Edge API ein zweistufiger Prozess:

  1. Als Systemadministrator führen Sie den API-Aufruf aus, um den neuen globalen Nutzer hinzuzufügen:
    curl -H "Content-Type:application/xml" -u <sysAdminEmail:pword> \
  -X POST https://<ms_IP>:8080/v1/users \
  -d '<User> \
    <FirstName>Foo</FirstName> \
    <LastName>Bar</LastName> \
    <Password>myPword</Password> \
    <EmailId>foo@bar.com</EmailId> \
  </User>'
    , wobei <ms_IP> die IP-Adresse oder der DNS-Name des Edge Management Server ist.
  2. Weisen Sie dem neuen Nutzer eine Rolle zu. Gehen Sie dazu so vor:
    1. Wenn der neue Nutzer als Systemadministrator fungieren soll, verwenden Sie als Systemadministrator den folgenden API-Aufruf, um den Nutzer der Rolle „Systemadministrator“ (sysadmin) oder der Rolle „Schreibgeschützter Systemadministrator“ (sysadmin-readonly) hinzuzufügen: 
      curl -u <sysAdminEmail>:<passwd> \
 -X POST https://<ms_IP>:8080/v1/userroles/sysadmin/users \
 -d 'id=foo@bar.com'
    2. Als Systemadministrator oder Organisationsadministrator weisen Sie dem neuen Nutzer eine Rolle in einer Organisation zu. Ein globaler Nutzer wird erst in der Edge-Benutzeroberfläche angezeigt und kann sich erst dort anmelden, wenn ihm eine Rolle in einer Organisation zugewiesen wird. 
      curl -H "Content-Type:application/x-www-form-urlencoded" \
  -u <orgOrSysAdminEmail:pword> -X POST \
  https://<ms_IP>:8080/v1/organizations/{org_name}/userroles/{role_name}/users?id=foo@bar.com
      Ersetzen Sie {role_name} durch die spezifische Rolle für den neuen Nutzer. Rollen sind unter anderem:
      • Organisationsadministrator: orgadmin
      • Administrator mit Lesezugriff für die Organisation (nur Cloud): readonlyadmin
      • Operations-Administrator: opsadmin
      • Geschäftlicher Nutzer: businessuser
      • Nutzer: user

Zusätzliche Aufgaben zur Nutzerverwaltung ausführen

In der folgenden Tabelle sind die Vorgänge aufgeführt, die Sie für einen globalen Nutzer ausführen können.

Für viele dieser Vorgänge, z. B. das Löschen eines globalen Nutzers, sind Systemadministratorberechtigungen erforderlich. Wenn Sie Edge in der Cloud installieren möchten, wenden Sie sich an den Apigee Edge-Support, um diese Aktionen auszuführen. Bei einer Edge for Private Cloud-Installation kann der Systemadministrator diese Schritte ausführen.

Aktion

Erforderliche Rolle

Wie

Globale Nutzer verwalten

Alle Nutzer aufführen

Systemadministrator

API

Nutzer hinzufügen*

Systemadministrator

API*

Nutzer löschen

Systemadministrator

API

Nutzerpasswort oder andere Informationen ändern

Systemadministrator

API

Alle Rollen für Nutzer auflisten

Systemadministrator

API
* Der Nutzer kann zwar nur vom Systemadministrator erstellt werden, ein Organisationsadministrator kann den Workflow jedoch auslösen, indem er einen neuen Nutzer über die Edge-Verwaltungsoberfläche einer Organisation hinzufügt.

Sys Administratorrollen verwalten

Systemadministratorrollen auflisten

Systemadministrator

API

Nutzer der Rolle „Systemadministrator“ hinzufügen

Systemadministrator

API

Nutzer mit der Rolle „Systemadministrator“ auflisten

Systemadministrator

API

Nutzer aus der Systemadministratorrolle entfernen

Systemadministrator

API

Organisationsrollen verwalten

Rollen der Organisation auflisten

Systemadministrator

Admin der Organisation

API/UI

Nutzer einer Rolle hinzufügen

Systemadministrator

Admin der Organisation

API/UI

Nutzer für eine Rolle abrufen

Systemadministrator

Admin der Organisation

API/UI

Nutzer in einer Organisation auflisten**

Systemadministrator

Admin der Organisation

UI-

Nutzer aus Rolle entfernen

Systemadministrator

Admin der Organisation

API/UI

Weitere Vorgänge finden Sie unter Nutzerrollen.

Systemadministrator

Admin der Organisation

API/UI
** Es gibt keinen einzelnen API-Aufruf, mit dem alle Nutzer in einer Organisation aufgelistet werden. Stattdessen rufen Sie einmal auf, um alle Rollen in der Organisation abzurufen. Anschließend durchlaufen Sie die Liste der Rollen, um alle Nutzer in jeder Rolle abzurufen.