Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

Nutzer, Rollen und Berechtigungen verwalten

Die Apigee-Dokumentationswebsite enthält ausführliche Informationen zum Verwalten von Nutzerrollen und ‑berechtigungen. Nutzer können sowohl über die neue Edge-UI als auch über die Management API verwaltet werden. Rollen und Berechtigungen können nur mit der Management API verwaltet werden.

Informationen zu Nutzern und zum Erstellen von Nutzern finden Sie unter:

Für viele der Vorgänge, die Sie zum Verwalten von Nutzern ausführen, sind Systemadministrator Berechtigungen erforderlich. In einer cloudbasierten Installation von Edge fungiert Apigee als System administrator. In einer Edge for Private Cloud-Installation muss Ihr Systemadministrator diese Aufgaben wie unten beschrieben ausführen.

Nutzer hinzufügen

Sie können einen Nutzer entweder über die Edge API, die neue Edge-UI oder Edge-Befehle erstellen. In diesem Abschnitt wird beschrieben, wie Sie die Edge API und Edge-Befehle verwenden. Informationen zum Erstellen von Nutzern in der neuen Edge-UI finden Sie unter Globale Nutzer erstellen.

Nachdem Sie den Nutzer in einer Organisation erstellt haben, müssen Sie ihm eine Rolle zuweisen. Rollen bestimmen die Zugriffsrechte des Nutzers in Edge.

Verwenden Sie den folgenden Befehl, um einen Nutzer mit der Edge API zu erstellen:

curl -H "Content-Type:application/xml" \
  -u SYS_ADMIN_EMAIL:SYS_ADMIN_PASSWORD -X POST http://ms_IP:8080/v1/users \
  -d '<User> \
    <FirstName>New</FirstName> \
    <LastName>User</LastName> \
    <Password>NEW_USER_PASSWORD</Password> \
    <EmailId>foo@bar.com</EmailId> \
  </User>'

Oder verwenden Sie den folgenden Edge-Befehl, um einen Nutzer zu erstellen:

/opt/apigee/apigee-service/bin/apigee-service apigee-provision create-user -f configFile

Dabei erstellt die Datei „configFile“ den Nutzer, wie im folgenden Beispiel gezeigt:

APIGEE_ADMINPW=SYS_ADMIN_PASSWORD    # If omitted, you will be prompted.
USER_NAME=foo@bar.com
FIRST_NAME=New
LAST_NAME=User
USER_PWD="NEW_USER_PASSWORD"
ORG_NAME=myorg

Anschließend können Sie diesen Aufruf verwenden, um Informationen zum Nutzer aufzurufen:

curl -u SYS_ADMIN_EMAIL:SYS_ADMIN_PASSWORD http://ms_IP:8080/v1/users/foo@bar.com

Nutzer einer Rolle in einer Organisation zuweisen

Bevor ein neuer Nutzer etwas tun kann, muss er einer Rolle in einer Organisation zugewiesen werden. Sie können den Nutzer verschiedenen Rollen zuweisen, darunter: orgadmin, businessuser, opsadmin, user, oder einer benutzerdefinierten Rolle, die in der Organisation definiert ist.

Wenn Sie einen Nutzer einer Rolle in einer Organisation zuweisen, wird dieser Nutzer automatisch der Organisation hinzugefügt. Weisen Sie einen Nutzer mehreren Organisationen zu, indem Sie ihm in jeder Organisation eine Rolle zuweisen.

Verwenden Sie den folgenden Befehl, um den Nutzer einer Rolle in einer Organisation zuzuweisen:

curl -X POST -H "Content-Type:application/x-www-form-urlencoded" \
  http://ms_IP:8080/v1/o/org_name/userroles/role/users?id=foo@bar.com \
  -u SYS_ADMIN_EMAIL:SYS_ADMIN_PASSWORD

Dieser Aufruf zeigt alle Rollen an, die dem Nutzer zugewiesen sind. Wenn Sie den Nutzer hinzufügen, aber nur die neue Rolle anzeigen möchten, verwenden Sie den folgenden Aufruf:

curl -X POST -H "Content-Type: application/xml" \
  http://ms_IP:8080/v1/o/org_name/users/foo@bar.com/userroles \
  -d '<Roles><Role name="role"/><Roles>' \
  -u SYS_ADMIN_EMAIL:SYS_ADMIN_PASSWORD

Sie können die Rollen des Nutzers mit dem folgenden Befehl aufrufen:

curl -u SYS_ADMIN_EMAIL:SYS_ADMIN_PASSWORD http://ms_IP:8080/v1/users/foo@bar.com/userroles

Wenn Sie einen Nutzer aus einer Organisation entfernen möchten, entfernen Sie alle Rollen in dieser Organisation vom Nutzer. Verwenden Sie den folgenden Befehl, um eine Rolle von einem Nutzer zu entfernen:

curl -X DELETE -u SYS_ADMIN_EMAIL:SYS_ADMIN_PASSWORD \
  http://ms_IP:8080/v1/o/org_name/userroles/role/users/foo@bar.com

Systemadministrator hinzufügen

Ein Systemadministrator kann Folgendes tun:

Organisationen erstellen
Router, Message Processor und andere Komponenten zu einer Edge-Installation hinzufügen
TLS/SSL konfigurieren
Zusätzliche Systemadministratoren erstellen
Alle administrativen Aufgaben für Edge ausführen

Standardmäßig ist nur ein Nutzer für administrative Aufgaben vorgesehen, aber es kann mehr als einen Systemadministrator geben. Jeder Nutzer, der Mitglied der Rolle „sysadmin“ ist, hat uneingeschränkte Berechtigungen für alle Ressourcen.

Sie können den Nutzer für den Systemadministrator entweder in der neuen Edge-UI oder über die API erstellen. Sie müssen jedoch die Edge API verwenden, um den Nutzer der Rolle „sysadmin“ zuzuweisen. Die Zuweisung eines Nutzers zur Rolle „sysadmin“ ist in der neuen Edge-UI nicht möglich.

So fügen Sie einen Systemadministrator hinzu:

Erstellen Sie einen Nutzer in der neuen Edge-UI oder über die API.

Fügen Sie den Nutzer der Rolle „sysadmin“ hinzu:

curl -u SYS_ADMIN_EMAIL:SYS_ADMIN_PASSWORD \
  -X POST http://ms_IP:8080/v1/userroles/sysadmin/users -d 'id=foo@bar.com'

Prüfen Sie, ob der neue Nutzer die Rolle „sysadmin“ hat:

curl -u SYS_ADMIN_EMAIL:SYS_ADMIN_PASSWORD http://ms_IP:8080/v1/userroles/sysadmin/users

Gibt die E-Mail-Adresse des Nutzers zurück:

[ " foo@bar.com " ]

Berechtigungen des neuen Nutzers prüfen:

curl -u SYS_ADMIN_EMAIL:SYS_ADMIN_PASSWORD http://ms_IP:8080/v1/users/foo@bar.com/permissions

Liefert:

{
  "resourcePermission" : [ {
  "path" : "/",
    "permissions" : [ "get", "put", "delete" ]
  } ]
}

Nachdem Sie den neuen Systemadministrator hinzugefügt haben, können Sie den Nutzer zu beliebigen Organisationen hinzufügen.

Hinweis: Der neue Systemadministrator kann sich erst in der neuen Edge-UI anmelden, wenn Sie den Nutzer mindestens einer Organisation hinzugefügt haben.
Wenn Sie den Nutzer später aus der Rolle des Systemadministrators entfernen möchten, können Sie die folgende API verwenden:
```
curl -X DELETE -u SYS_ADMIN_EMAIL:SYS_ADMIN_PASSWORD \
  http://ms_IP:8080/v1/userroles/sysadmin/users/foo@bar.com
```
Dieser Aufruf entfernt den Nutzer nur aus der Rolle, er löscht den Nutzer nicht.

Standardmäßigen Systemadministrator ändern

Bei der Installation von Edge geben Sie die E-Mail-Adresse des Systemadministrators an. Edge erstellt einen Nutzer mit dieser E-Mail-Adresse und legt diesen Nutzer als Standard-System administrator fest. Sie können später wie oben beschrieben weitere Systemadministratoren hinzufügen.

In diesem Abschnitt wird beschrieben, wie Sie den Standard-Systemadministrator in einen anderen Nutzer ändern, und wie Sie die E-Mail-Adresse des Nutzerkontos für den aktuellen Standard-System administrator ändern.

Verwenden Sie den folgenden API Aufruf, um die Liste der Nutzer aufzurufen, die derzeit als Systemadministratoren konfiguriert sind:

curl -u SYS_ADMIN_EMAIL:SYS_ADMIN_PASSWORD http://ms_IP:8080/v1/userroles/sysadmin/users

Um den aktuellen Standard-Systemadministrator zu ermitteln, rufen Sie die /opt/apigee/customer/defaults.sh Datei auf. Die Datei enthält die folgende Zeile mit der E-Mail-Adresse des aktuellen Standard-Systemadministrators:

ADMIN_EMAIL=foo@bar.com

So ändern Sie den Standard-Systemadministrator in einen anderen Nutzer:

Erstellen Sie wie oben beschrieben einen neuen Systemadministrator oder prüfen Sie, ob das Nutzerkonto des neuen Systemadministrators bereits als Systemadministrator konfiguriert ist.
Bearbeiten Sie /opt/apigee/customer/defaults.sh und legen Sie ADMIN_EMAIL auf die E-Mail-Adresse des neuen Systemadministrators fest.
Bearbeiten Sie die Datei für die automatische Konfiguration, die Sie zum Installieren der neuen Edge-UI verwendet haben, und legen Sie die folgenden Attribute fest:
```
ADMIN_EMAIL=NEW_SYS_ADMIN_EMAIL
APIGEE_ADMINPW=NEW_SYS_ADMIN_PASSWORD
SMTPHOST=smtp.gmail.com
SMTPPORT=465
SMTPUSER=foo@gmail.com
SMTPPASSWORD=bar
SMTPSSL=y
```
Die SMTP-Attribute müssen enthalten sein, da alle Attribute in der neuen Edge-UI zurückgesetzt werden.

Konfigurieren Sie die neue Edge-UI neu:

/opt/apigee/apigee-service/bin/apigee-service edge-management-ui stop
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui setup -f configFile
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui start

Wenn Sie nur die E-Mail-Adresse des Nutzerkontos für den aktuellen Standard Systemadministrator ändern möchten, aktualisieren Sie zuerst das Nutzerkonto, um die neue E-Mail-Adresse festzulegen, und ändern Sie dann die E-Mail-Adresse des Standard-Systemadministrators:

Aktualisieren Sie das Nutzerkonto des aktuellen Standard-Systemadministrators mit einer neuen E-Mail Adresse:

curl -H content-type:application/json -X PUT -u CURRENT_SYS_ADMIN_EMAIL:SYS_ADMIN_PASSWORD \
  http://ms_IP:8080/v1/users/CURRENT_SYS_ADMIN_EMAIL \
  -d '{"emailId": "NEW_SYS_ADMIN_EMAIL", "lastName": "admin", "firstName": "admin"}'

Wiederholen Sie die Schritte 2, 3 und 4 aus der vorherigen Anleitung, um die /opt/apigee/customer/defaults.sh Datei und die neue Edge-UI zu aktualisieren.

E-Mail-Domain eines System administrators angeben

Als zusätzliche Sicherheitsmaßnahme können Sie die erforderliche E-Mail-Domain eines Edge-System administrators angeben. Wenn Sie einen Systemadministrator hinzufügen und die E-Mail-Adresse des Nutzers nicht in der angegebenen Domain liegt, schlägt das Hinzufügen des Nutzers zur Rolle „sysadmin“ fehl.

Standardmäßig ist die erforderliche Domain leer. Das bedeutet, dass Sie der Rolle „sysadmin“ eine beliebige E-Mail-Adresse hinzufügen können.

So legen Sie die E-Mail-Domain fest:

Öffnen Sie die Datei management-server.properties in einem Editor:
```
vi /opt/apigee/customer/application/management-server.properties
```
Wenn diese Datei nicht vorhanden ist, erstellen Sie sie.
Legen Sie das Attribut conf_security_rbac.global.roles.allowed.domains fest auf die durch Kommas getrennte Liste der zulässigen Domains. Beispiel:
```
conf_security_rbac.global.roles.allowed.domains=myCo.com,yourCo.com
```
Speichern Sie die Änderungen.
Starten Sie den Edge Management Server neu:
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-server restart
```
Wenn Sie jetzt versuchen, einen Nutzer der Rolle „sysadmin“ hinzuzufügen, und die E-Mail-Adresse des Nutzers nicht in einer der angegebenen Domains liegt, schlägt das Hinzufügen fehl.

Nutzer löschen

Sie können einen Nutzer entweder über die Edge API oder die neue Edge-UI erstellen. Sie können einen Nutzer jedoch nur über die API löschen.

Verwenden Sie den folgenden curl Befehl, um die Liste der aktuellen Nutzer einschließlich E-Mail-Adresse aufzurufen:

curl -u SYS_ADMIN_EMAIL:SYS_ADMIN_PASSWORD http://ms-IP:8080/v1/users

Verwenden Sie den folgenden curl-Befehl, um einen Nutzer zu löschen:

curl -u SYS_ADMIN_EMAIL:SYS_ADMIN_PASSWORD -X DELETE http://ms_IP:8080/v1/users/USER_EMAIL