Edge dla chmury prywatnej w wersji 4.16.09
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ą interfejsu Edge i interfejsu API zarządzania Google Analytics. Rolami i uprawnieniami można zarządzać tylko za pomocą interfejsu API zarządzania Google Analytics.
Informacje o użytkownikach i tworzeniu użytkowników znajdziesz w tych artykułach:
Wiele operacji, które wykonujesz, aby zarządzać użytkownikami, wymaga uprawnień administratora systemu. W przypadku instalacji Edge w chmurze Apigee pełni rolę administratora systemu. W przypadku instalacji Edge dla chmury prywatnej administrator systemu musi wykonać te zadania w sposób opisany poniżej.
Dodawanie użytkownika
Użytkownika możesz utworzyć za pomocą interfejsu API Edge, interfejsu Edge lub poleceń Edge. W tej sekcji opisano, jak używać interfejsu API Edge i poleceń Edge. Informacje o tworzeniu użytkowników w interfejsie Edge znajdziesz w artykule Tworzenie użytkowników globalnych.
Po utworzeniu użytkownika w organizacji musisz przypisać mu rolę. Role określają uprawnienia 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 <sysAdminEmail>:<passwd> \ -X POST http://<ms_IP>:8080/v1/users \ -d '<User> \ <FirstName>New</FirstName> \ <LastName>User</LastName> \ <Password>newUserPWord</Password> \ <EmailId>foo@bar.com</EmailId> \ </User>'
Możesz też utworzyć użytkownika za pomocą tego polecenia Edge:
> /<inst_root>/apigee/apigee-service/bin/apigee-service apigee-provision create-user -f configFile
Plik configFile zawiera informacje niezbędne do utworzenia użytkownika:
APIGEE_ADMINPW=sysAdminPW # If omitted, you will be prompted. USER_NAME=foo@bar.com FIRST_NAME=New LAST_NAME=User USER_PWD="newUserPWord" ORG_NAME=myorg
Następnie możesz użyć tego wywołania, aby wyświetlić informacje o użytkowniku:
curl -u <sysAdminEmail>:<passwd> http://<ms_IP>:8080/v1/users/foo@bar.com
przypisanie użytkownika do roli w organizacji,
Zanim nowy użytkownik będzie mógł cokolwiek zrobić, musi mieć przypisaną rolę w organizacji. Możesz przypisać użytkownikowi różne role, w tym: orgadmin, businessuser, opsadmin, user lub rolę niestandardową zdefiniowaną w organizacji.
Przypisanie użytkownika do roli w organizacji powoduje automatyczne dodanie go do tej organizacji. Przypisz użytkownika do wielu organizacji, przypisując mu rolę w każdej z nich.
Aby przypisać użytkownikowi rolę 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 <sysAdminEmail>:<passwd>
Możesz wyświetlić role użytkownika za pomocą tego polecenia:
curl -u <sysAdminEmail>:<passwd> / 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 <sysAdminEmail>:<passwd> http://<ms_IP>:8080/v1/o/<org_name>/userroles/<role>/users/foo@bar.com
Dodawanie administratora systemu
Administrator systemu może:
- Tworzenie organizacji
- Dodawanie routerów, procesorów komunikatów i innych komponentów do instalacji Edge
- Konfigurowanie protokołu TLS/SSL
- Tworzenie dodatkowych administratorów systemu
- Wykonywanie wszystkich zadań administracyjnych Edge
Chociaż tylko jeden użytkownik jest domyślnym użytkownikiem do zadań administracyjnych, może być więcej niż jeden administrator systemu. Każdy użytkownik, który ma rolę sysadmin, ma pełne uprawnienia do wszystkich zasobów.
Konto użytkownika dla administratora systemu możesz utworzyć w interfejsie Edge lub interfejsie API. Musisz jednak użyć interfejsu API Edge, aby przypisać użytkownikowi rolę sysadmin. Przypisanie użytkownika do roli sysadmin nie jest możliwe w interfejsie Edge.
Aby dodać administratora systemu:
- utworzyć użytkownika w interfejsie Edge lub interfejsie API,
- Dodaj użytkownika do roli sysadmin:
curl -u <sysAdminEmail>:<passwd> \
-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 <sysAdminEmail>:<passwd> http://<ms_IP>:8080/v1/userroles/sysadmin/users
Zwraca adres e-mail użytkownika:
[ " foo@bar.com " ] - Sprawdź uprawnienia nowego użytkownika:
curl -u <sysAdminEmail>:<passwd> 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 dowolnych organizacji.
Uwaga: nowy administrator systemu nie może zalogować się w interfejsie Edge, dopóki nie dodasz go do co najmniej 1 organizacji. - Jeśli później zechcesz usunąć użytkownika z roli administratora systemu, możesz użyć tego interfejsu API:
curl -X DELETE -u <sysadminEmail:pword>
http://<ms_IP>:8080/v1/userroles/sysadmin/users/foo@bar.com
Pamiętaj, że to wywołanie usuwa tylko użytkownika z roli, a nie samego użytkownika.
określenie 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 roli sysadmin możesz dodać dowolny adres e-mail.
Aby ustawić domenę e-mail:
- Otwórz w edytorze plik management-server.properties:
vi /<inst_root>/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 listę dozwolonych domen rozdzielonych przecinkami. Na przykład:
conf_security_rbac.global.roles.allowed.domains=myCo.com,yourCo.com - Zapisz zmiany.
- Uruchom ponownie serwer zarządzania Edge:
/<inst_root>/apigee/apigee-service/bin/apigee-service edge-management-server restart
Jeśli teraz spróbujesz dodać użytkownika do roli sysadmin, a adres e-mail użytkownika nie będzie należał do jednej z określonych domen, dodanie się nie powiedzie.
Usuwanie użytkownika
Użytkownika możesz utworzyć za pomocą interfejsu API Edge lub interfejsu Edge. Użytkownika możesz jednak usunąć tylko za pomocą interfejsu API.
Aby wyświetlić listę obecnych użytkowników, w tym adresy e-mail, użyj tego polecenia cURL:
curl -u <sysAdminEmail>:<passwd> http://<ms-IP>:8080/v1/users
Aby usunąć użytkownika, użyj tego polecenia cURL:
curl -u <sysAdminEmail>:<passwd> -X DELETE http://<ms-IP>:8080/v1/users/<userEmail>