Google używa technologii AI do tłumaczenia treści na Twój preferowany język. Tłumaczenia wygenerowane przez AI mogą zawierać błędy.

Zarządzanie użytkownikami, rolami i uprawnieniami

W witrynie z dokumentacją Apigee znajdziesz szczegółowe informacje o zarządzaniu rolami i uprawnieniami użytkowników. Użytkownikami można zarządzać za pomocą nowego interfejsu Edge i interfejsu Management API. Rolami i uprawnieniami można zarządzać tylko za pomocą interfejsu Management API.

Więcej informacji o użytkownikach i tworzeniu użytkowników znajdziesz w tych artykułach:

Wiele operacji wykonywanych w celu zarządzania użytkownikami wymaga uprawnień administratora systemu. W instalacji Edge w chmurze Apigee pełni rolę administratora systemu. W instalacji Edge for Private Cloud administrator systemu musi wykonać te czynności zgodnie z opisem poniżej.

Dodawanie użytkownika

Użytkownika możesz utworzyć za pomocą interfejsu API Edge, nowego interfejsu Edge lub poleceń Edge. W tej sekcji opisujemy, jak korzystać z interfejsu API Edge i poleceń Edge. Informacje o tworzeniu użytkowników w nowym interfejsie Edge znajdziesz w artykule Tworzenie użytkowników globalnych.

Po utworzeniu użytkownika w organizacji musisz przypisać mu rolę. Role określają prawa dostępu użytkownika w Edge.

Aby utworzyć użytkownika za pomocą interfejsu API Edge, użyj tego polecenia:

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>'

Aby utworzyć użytkownika za pomocą polecenia Edge, użyj tego polecenia:

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

Plik configFile tworzy użytkownika, jak pokazano w tym przykładzie:

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

Następnie możesz użyć tego wywołania, aby wyświetlić informacje o użytkowniku:

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

Przypisywanie użytkownika do roli w an organizacji

Zanim nowy użytkownik będzie mógł cokolwiek zrobić, musi zostać przypisany do roli w organizacji. Możesz przypisać użytkownika do różnych ról, w tym: orgadmin, businessuser, opsadmin, user lub do roli niestandardowej zdefiniowanej w organizacji.

Przypisanie użytkownika do roli w organizacji powoduje automatyczne dodanie go do tej organizacji. Aby przypisać użytkownika do wielu organizacji, przypisz go do roli w każdej z nich.

Aby przypisać użytkownika do roli w organizacji, użyj tego polecenia:

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

To wywołanie wyświetla wszystkie role przypisane do użytkownika. Jeśli chcesz dodać użytkownika, ale wyświetlić tylko nową rolę, użyj tego wywołania:

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

Role użytkownika możesz wyświetlić za pomocą tego polecenia:

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

Aby usunąć użytkownika z organizacji, usuń wszystkie jego role w tej organizacji. Aby usunąć rolę użytkownika, użyj tego polecenia:

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

Dodawanie administratora systemu

Administrator systemu może:

tworzyć organizacje;
dodawać routery, procesory komunikatów i inne komponenty do instalacji Edge;
konfigurować protokół TLS/SSL;
tworzyć dodatkowych administratorów systemu;
wykonywać wszystkie zadania administracyjne Edge.

Domyślnie tylko 1 użytkownik jest użytkownikiem domyślnym do wykonywania zadań administracyjnych, ale może być więcej niż 1 administrator systemu. Każdy użytkownik, który jest członkiem roli „sysadmin”, ma pełne uprawnienia do wszystkich zasobów.

Użytkownika dla administratora systemu możesz utworzyć w nowym interfejsie Edge lub za pomocą interfejsu API. Aby jednak przypisać użytkownika do roli „sysadmin”, musisz użyć interfejsu API Edge. Nie można przypisać użytkownika do roli „sysadmin” w nowym interfejsie Edge.

Aby dodać administratora systemu:

Utwórz użytkownika w nowym interfejsie Edge lub za pomocą interfejsu API.

Dodaj użytkownika do roli „sysadmin”:

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

Sprawdź, czy nowy użytkownik ma rolę „sysadmin”:

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

Zwraca adres e-mail użytkownika:

[ " foo@bar.com " ]

Sprawdź uprawnienia nowego użytkownika:

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

Zwraca:

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

Po dodaniu nowego administratora systemu możesz dodać użytkownika do dowolnej organizacji.

Uwaga: nowy administrator systemu nie może zalogować się w nowym interfejsie Edge, dopóki nie dodasz go do co najmniej 1 organizacji.
Jeśli później chcesz usunąć użytkownika z roli administratora systemu, możesz użyć tego interfejsu API:
```
curl -X DELETE -u SYS_ADMIN_EMAIL:SYS_ADMIN_PASSWORD \
  http://ms_IP:8080/v1/userroles/sysadmin/users/foo@bar.com
```
Pamiętaj, że to wywołanie tylko usuwa użytkownika z roli, a nie usuwa go.

Zmienianie domyślnego administratora systemu

Podczas instalowania Edge podajesz adres e-mail administratora systemu. Edge tworzy użytkownika z tym adresem e-mail i ustawia go jako domyślnego administratora systemu. Później możesz dodać dodatkowych administratorów systemu zgodnie z opisem powyżej.

W tej sekcji opisujemy, jak zmienić domyślnego administratora systemu na innego użytkownika, oraz jak zmienić adres e-mail konta użytkownika dla obecnego domyślnego administratora systemu.

Aby wyświetlić listę użytkowników skonfigurowanych obecnie jako administratorzy systemu, użyj tego wywołania interfejsu API:

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

Aby określić obecnego domyślnego administratora systemu, wyświetl /opt/apigee/customer/defaults.sh plik. Plik zawiera ten wiersz z adresem e-mail obecnego domyślnego administratora systemu:

ADMIN_EMAIL=foo@bar.com

Aby zmienić domyślnego administratora systemu na innego użytkownika:

Utwórz nowego administratora systemu zgodnie z opisem powyżej lub upewnij się, że konto użytkownika nowego administratora systemu jest już skonfigurowane jako administrator systemu.
Edytuj /opt/apigee/customer/defaults.sh, aby ustawić ADMIN_EMAIL na adres e-mail nowego administratora systemu.
Edytuj cichy plik konfiguracyjny, którego używasz do instalowania nowego interfejsu Edge, aby ustawić te właściwości:
```
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
```
Pamiętaj, że musisz uwzględnić właściwości SMTP, ponieważ wszystkie właściwości w nowym interfejsie Edge zostaną zresetowane.

Ponownie skonfiguruj nowy interfejs Edge:

/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

Jeśli chcesz tylko zmienić adres e-mail konta użytkownika dla obecnego domyślnego administratora systemu, najpierw zaktualizuj konto użytkownika, aby ustawić nowy adres e-mail, a następnie zmień domyślny adres e-mail administratora systemu:

Zaktualizuj konto użytkownika obecnego domyślnego administratora systemu, podając nowy adres e-mail:

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"}'

Powtórz kroki 2, 3 i 4 z poprzedniej procedury, aby zaktualizować plik /opt/apigee/customer/defaults.sh i nowy interfejs Edge.

Określanie domeny e-mail administratora systemu

Aby zapewnić dodatkowy poziom bezpieczeństwa, możesz określić wymaganą domenę e-mail administratora systemu Edge. Jeśli podczas dodawania administratora systemu adres e-mail użytkownika nie znajduje się w określonej domenie, dodanie użytkownika do roli „sysadmin” nie powiedzie się.

Domyślnie wymagana domena jest pusta, co oznacza, że do "sysadmin" roli możesz dodać dowolny adres e-mail.

Aby ustawić domenę e-mail:

Otwórz plik management-server.properties w edytorze:
```
vi /opt/apigee/customer/application/management-server.properties
```
Jeśli ten plik nie istnieje, utwórz go.
Ustaw właściwość conf_security_rbac.global.roles.allowed.domains na rozdzieloną przecinkami listę dozwolonych domen. Na przykład:
```
conf_security_rbac.global.roles.allowed.domains=myCo.com,yourCo.com
```
Zapisz zmiany.
Ponownie uruchom serwer zarządzania Edge:
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-server restart
```
Jeśli teraz spróbujesz dodać użytkownika do roli „sysadmin”, a jego adres e-mail nie będzie się znajdować w żadnej z określonych domen, dodanie nie powiedzie się.

Usuwanie użytkownika

Użytkownika możesz utworzyć za pomocą interfejsu API Edge lub nowego interfejsu Edge. Użytkownika możesz jednak usunąć tylko za pomocą interfejsu API.

Aby wyświetlić listę obecnych użytkowników, w tym ich adresy e-mail, użyj tego curl polecenia:

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

Aby usunąć użytkownika, użyj tego polecenia curl:

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