Edge dla chmury prywatnej w wersji 4.16.09
Po zakończeniu instalacji możesz zresetować hasła OpenLDAP, administratora systemu Apigee Edge, użytkownika organizacji Edge i Cassandra.
Resetowanie hasła OpenLDAP
W zależności od konfiguracji Edge OpenLDAP można zainstalować jako:
- Pojedyncza instancja OpenLDAP zainstalowana w węźle serwera zarządzania. na przykład w konfiguracji Edge z 2, 5 lub 9 węzłami.
- Wiele instancji OpenLDAP zainstalowanych w węzłach serwera zarządzania, skonfigurowanych z replikacją OpenLDAP. Na przykład w konfiguracji Edge z 12 węzłami.
- Wiele instancji OpenLDAP zainstalowanych w osobnych węzłach i skonfigurowanych z replikacją OpenLDAP. Na przykład w konfiguracji Edge z 13 węzłami.
Sposób resetowania hasła OpenLDAP zależy od konfiguracji.
W przypadku pojedynczej instancji OpenLDAP zainstalowanej na serwerze zarządzania wykonaj te czynności:
- Na węźle serwera zarządzania uruchom to polecenie, aby utworzyć nowe hasło OpenLDAP:
> /<inst_root>/apigee/apigee-service/bin/apigee-service apigee-openldap change-ldap-password -o oldPword -n newPword - Uruchom to polecenie, aby zapisać nowe hasło, które będzie używane przez serwer zarządzania:
> /<inst_root>/apigee/apigee-service/bin/apigee-service edge-management-server store_ldap_credentials -p newPword
To polecenie spowoduje ponowne uruchomienie serwera zarządzania.
W konfiguracji replikacji OpenLDAP z OpenLDAP zainstalowanym na węzłach serwera zarządzania wykonaj powyższe czynności na obu węzłach serwera zarządzania, aby zaktualizować hasło.
W przypadku konfiguracji replikacji OpenLDAP, w której OpenLDAP znajduje się na węźle innym niż serwer zarządzania, najpierw zmień hasło na obu węzłach OpenLDAP, a następnie na obu węzłach serwera zarządzania.
Resetowanie hasła administratora systemu
Aby zresetować hasło administratora systemu, musisz je zresetować w 2 miejscach:
- Serwer zarządzania
- UI
Ostrzeżenie: przed zresetowaniem hasła administratora systemu należy zatrzymać interfejs Edge. Ponieważ najpierw resetujesz hasło na serwerze zarządzania, przez krótki czas interfejs może nadal używać starego hasła. Jeśli interfejs wykona więcej niż 3 wywołania przy użyciu starego hasła, serwer OpenLDAP zablokuje konto administratora systemu na 3 minuty.
Aby zresetować hasło administratora systemu:
- Na węźle interfejsu zatrzymaj interfejs Edge:
> /<inst_root>/apigee/apigee-service/bin/apigee-service edge-ui stop - Na serwerze zarządzania uruchom to polecenie, aby zresetować hasło:
> /<inst_root>/apigee/apigee-service/bin/apigee-service edge-management-server change_sysadmin_password -o currentPW -n newPW - Zmodyfikuj plik konfiguracji instalacji dyskretnej, który został użyty do zainstalowania interfejsu Edge, aby ustawić te właściwości:
APIGEE_ADMINPW=newPW
SMTPHOST=smtp.gmail.com
SMTPPORT=465
SMTPUSER=foo@gmail.com
SMTPPASSWORD=bar
SMTPSSL=y
Pamiętaj, że podczas przekazywania nowego hasła musisz uwzględnić właściwości SMTP, ponieważ wszystkie właściwości w interfejsie są resetowane. - Użyj narzędzia apigee-setup, aby zresetować hasło w interfejsie Edge z pliku konfiguracji:
> /<inst_root>/apigee/apigee-setup/bin/setup.sh -p ui -f configFile - Uruchom interfejs Edge w węźle interfejsu:
> /<inst_root>/apigee/apigee-service/bin/apigee-service edge-ui start - (Tylko jeśli protokół TLS jest włączony w interfejsie użytkownika) Ponownie włącz protokół TLS w interfejsie Edge zgodnie z opisem w artykule Konfigurowanie protokołu TLS dla interfejsu zarządzania.
W środowisku replikacji OpenLDAP z wieloma serwerami zarządzania zresetowanie hasła na jednym serwerze zarządzania powoduje automatyczną aktualizację drugiego serwera zarządzania. Musisz jednak zaktualizować wszystkie węzły interfejsu Edge oddzielnie.
Resetowanie hasła użytkownika organizacji
Aby zresetować hasło użytkownika organizacji, użyj narzędzia apigee-service do wywołania apigee-setup:
/<inst_root>/apigee/apigee-service/bin/apigee-service apigee-setup reset_user_password [-h] [-u USER_EMAIL] [-p USER_PWD] [-a ADMIN_EMAIL] [-P APIGEE_ADMINPW] [-f configFile]
Na przykład:
> /<inst_root>/apigee/apigee-service/bin/apigee-service apigee-setup reset_user_password -u user@myCo.com -p foo12345 -a admin@myCo.com -P adminPword
Poniżej znajduje się przykładowy plik konfiguracji, którego możesz użyć z opcją „-f”:
USER_NAME= user@myCo.com USER_PWD= "foo12345" APIGEE_ADMINPW= adminPword
Możesz też użyć interfejsu API Update user, aby zmienić hasło użytkownika.
Reguły dotyczące haseł administratora systemu i użytkownika organizacji
W tej sekcji możesz wymusić odpowiednią długość i siłę haseł użytkowników zarządzania interfejsami API. Ustawienia używają serii wstępnie skonfigurowanych (i jednoznacznie ponumerowanych) wyrażeń regularnych do sprawdzania zawartości hasła (np. wielkich i małych liter, cyfr i znaków specjalnych). Zapisz te ustawienia w pliku /<inst_root>/apigee/customer/application/management-server.properties. Jeśli ten plik nie istnieje, utwórz go.
Po zmodyfikowaniu pliku management-server.properties uruchom ponownie serwer zarządzania:
> /<inst_root>/apigee/apigee-service/bin/apigee-service edge-management-server restart
Następnie możesz ustawić oceny siły hasła, grupując różne kombinacje wyrażeń regularnych. Możesz na przykład określić, że hasło zawierające co najmniej 1 wielką i 1 małą literę otrzyma ocenę siły „3”, ale hasło zawierające co najmniej 1 małą literę i 1 cyfrę otrzyma wyższą ocenę „4”.
|
Usługi |
Opis |
|---|---|
|
conf_security_password.validation.minimum. conf_security_password.validation.default.rating=2 conf_security_password.validation.minimum. |
Użyj ich, aby określić ogólne cechy prawidłowych haseł. Domyślna minimalna ocena siły hasła (opisana w tabeli poniżej) to 3. Zauważ, że wartość password.validation.default.rating=2 jest niższa niż wymagana ocena minimalna, co oznacza, że jeśli wprowadzone hasło nie spełnia skonfigurowanych reguł, otrzymuje ocenę 2 i jest nieprawidłowe (poniżej minimalnej oceny 3). |
|
Poniżej znajdziesz wyrażenia regularne, które identyfikują cechy haseł. Zwróć uwagę, że każdy z nich jest ponumerowany. Na przykład „password.validation.regex.5=…” to wyrażenie numer 5. Użyjesz tych liczb w dalszej części pliku, aby ustawić różne kombinacje, które określają ogólną siłę hasła. |
|
|
conf_security_password.validation.regex.1=^(.)\\1+$ |
1 – wszystkie znaki się powtarzają, |
|
conf_security_password.validation.regex.2=^.*[a-z]+.*$ |
2 – co najmniej 1 małą literę, |
|
conf_security_password.validation.regex.3=^.*[A-Z]+.*$ |
3 – co najmniej 1 wielką literę, |
|
conf_security_password.validation.regex.4=^.*[0-9]+.*$ |
4 – co najmniej 1 cyfra, |
|
conf_security_password.validation.regex.5=^.*[^a-zA-z0-9]+.*$ |
5 – co najmniej 1 znak specjalny (z wyjątkiem podkreślenia _). |
|
conf_security_password.validation.regex.6=^.*[_]+.*$ |
6 – co najmniej 1 podkreślenie, |
|
conf_security_password.validation.regex.7=^.*[a-z]{2,}.*$ |
7 – więcej niż 1 mała litera, |
|
conf_security_password.validation.regex.8=^.*[A-Z]{2,}.*$ |
8 – więcej niż 1 wielka litera, |
|
conf_security_password.validation.regex.9=^.*[0-9]{2,}.*$ |
9 – więcej niż 1 cyfra |
|
conf_security_password.validation.regex.10=^.*[^a-zA-z0-9]{2,}.*$ |
10 – więcej niż 1 znak specjalny (nie licząc podkreślenia) |
|
conf_security_password.validation.regex.11=^.*[_]{2,}.*$ |
11 – więcej niż 1 podkreślenie, |
|
Te reguły określają siłę hasła na podstawie jego zawartości. Każda reguła zawiera co najmniej 1 wyrażenie regularne z poprzedniej sekcji i przypisuje mu wartość liczbową. The numeric strength of a password is compared to the conf_security_password.validation.minimum.rating.required number at the top of this file to determine whether or not a password is valid. |
|
|
conf_security_password.validation.rule.1=1,AND,0 conf_security_password.validation.rule.2=2,3,4,AND,4 conf_security_password.validation.rule.3=2,9,AND,4 conf_security_password.validation.rule.4=3,9,AND,4 conf_security_password.validation.rule.5=5,6,OR,4 conf_security_password.validation.rule.6=3,2,AND,3 conf_security_password.validation.rule.7=2,9,AND,3 conf_security_password.validation.rule.8=3,9,AND,3 |
Każda reguła jest ponumerowana. Na przykład „password.validation.rule.3=…” to reguła numer 3. Każda reguła ma ten format (po prawej stronie znaku równości): <regex-index-list>,<AND|OR>,<rating> regex-index-list to lista wyrażeń regularnych (według numeru z poprzedniej sekcji) wraz z operatorem AND|OR (co oznacza, że należy uwzględnić wszystkie lub dowolne z wymienionych wyrażeń). rating to liczbowa ocena siły przypisana do każdej reguły. Na przykład reguła 5 oznacza, że każde hasło zawierające co najmniej 1 znak specjalny LUB 1 podkreślenie otrzymuje ocenę siły 4. Z wartością password.validation.minimum. |
|
conf_security_rbac.password.validation.enabled=true |
Gdy włączone jest logowanie jednokrotne, ustaw weryfikację hasła kontroli dostępu opartej na rolach na wartość false. Wartość domyślna to true. |
Resetowanie hasła Cassandra
Domyślnie Cassandra jest dostarczana z wyłączonym uwierzytelnianiem. Jeśli włączysz uwierzytelnianie, będzie ono używać wstępnie zdefiniowanej nazwy użytkownika 'cassandra' z hasłem 'cassandra'. Możesz użyć tego konta, ustawić dla niego inne hasło lub utworzyć nowego użytkownika Cassandra. Dodawanie, usuwanie i modyfikowanie użytkowników za pomocą instrukcji Cassandra CREATE/ALTER/DROP USER.
Informacje o tym, jak włączyć uwierzytelnianie Cassandra, znajdziesz w artykule Włączanie uwierzytelniania Cassandra.
Aby zresetować hasło do systemu Cassandra, musisz:
- Ustaw hasło na dowolnym węźle Cassandra, a zostanie ono rozesłane do wszystkich węzłów Cassandra w pierścieniu.
- Zaktualizuj serwer zarządzania, procesory komunikatów, routery, serwery Qpid, serwery Postgres i stos BaaS w każdym węźle, podając nowe hasło.
Więcej informacji znajdziesz na stronie http://www.datastax.com/documentation/cql/3.0/cql/cql_reference/cqlCommandsTOC.html.
Aby zresetować hasło Cassandra:
- Zaloguj się w dowolnym węźle Cassandra za pomocą narzędzia cqlsh i domyślnych danych logowania. Hasło musisz zmienić tylko na jednym węźle Cassandra, a zostanie ono rozesłane do wszystkich węzłów Cassandra w pierścieniu:
> /<inst_root>/apigee/apigee-cassandra/bin/cqlsh cassIP 9042 -u cassandra -p cassandra
Gdzie:- cassIP to adres IP węzła Cassandra.
- 9042 to port Cassandra.
- Domyślny użytkownik to cassandra.
- Domyślne hasło to cassandra. Jeśli hasło zostało wcześniej zmienione, użyj bieżącego hasła.
- Uruchom to polecenie w wierszu poleceń cqlsh>, aby zaktualizować hasło:
cqlsh> ALTER USER cassandra WITH PASSWORD 'NEW_PASSWORD';
Jeśli nowe hasło zawiera znak pojedynczego cudzysłowu, poprzedź go znakiem pojedynczego cudzysłowu. - Zamknij narzędzie cqlsh:
cqlsh> exit - Na węźle serwera zarządzania uruchom to polecenie:
> /<inst_root>/apigee/apigee-service/bin/apigee-service edge-management-server store_cassandra_credentials -u CASS_USERNAME -p CASS_PASSWORD
Opcjonalnie możesz przekazać do polecenia plik zawierający nową nazwę użytkownika i hasło:
> apigee-service edge-management-server store_cassandra_credentials -f configFile
Gdzie configFile zawiera te informacje:
CASS_USERNAME=CASS_USERNAME
CASS_PASSWORD=CASS_PASSWROD
To polecenie automatycznie ponownie uruchamia serwer zarządzania. - Powtórz krok 4 na:
- Wszystkie procesory komunikatów
- Wszystkie routery
- Wszystkie serwery Qpid (edge-qpid-server)
- Serwery Postgres (edge-postgres-server)
- W węźle stosu BaaS w wersji 4.16.05.04 i nowszych:
- Uruchom to polecenie, aby wygenerować zaszyfrowane hasło:
> /opt/apigee/apigee-service/bin/apigee-service baas-usergrid secure_password
To polecenie poprosi o podanie hasła w postaci zwykłego tekstu i zwróci zaszyfrowane hasło w postaci:
SECURE:ae1b6dedbf6b26aaab8bee815a910737c1c15b55f3505c239e43bc09f8050 - Ustaw te tokeny w pliku /opt/apigee/customer/application/usergrid.properties.
Jeśli ten plik nie istnieje, utwórz go:
usergrid-deployment_cassandra.username=cassandra
usergrid-deployment_cassandra.password=SECURE:ae1b6dedbf6b26aaab8bee815a910737c1c15b55f3505c239e43bc09f8050
W tym przykładzie użyto domyślnej nazwy użytkownika Cassandra. Jeśli nazwa użytkownika została zmieniona, odpowiednio ustaw wartość usergrid-deployment_cassandra.username.
Upewnij się, że hasło zawiera prefiks „SECURE:”. W przeciwnym razie stos BaaS interpretuje wartość jako niezaszyfrowaną.
Uwaga: każdy węzeł stosu BaaS ma własny unikalny klucz używany do szyfrowania hasła. Dlatego musisz wygenerować zaszyfrowaną wartość osobno na każdym węźle stosu BaaS. - Zmień właściciela pliku usergrid.properties na użytkownika „apigee”:
> chown apigee:apigee /opt/apigee/customer/application/usergrid.properties - Skonfiguruj węzeł Stack:
> /<inst_root>/apigee/apigee-service/bin/apigee-service baas-usergrid configure - Uruchom ponownie stos BaaS:
> /<inst_root>/apigee/apigee-service/bin/apigee-service baas-usergrid restart - Powtórz te czynności w przypadku wszystkich węzłów stosu BaaS.
- Uruchom to polecenie, aby wygenerować zaszyfrowane hasło:
Hasło do bazy danych Cassandra zostało zmienione.
Resetowanie hasła PostgreSQL
Domyślnie baza danych PostgreSQL ma zdefiniowanych 2 użytkowników: „postgres” i „apigee”. Obaj użytkownicy mają domyślne hasło „postgres”. Aby zmienić domyślne hasło, wykonaj te czynności.
Zmień hasło na wszystkich węzłach głównych Postgres. Jeśli masz skonfigurowane 2 serwery Postgres w trybie głównym/czuwania, musisz zmienić hasło tylko w węźle głównym. Więcej informacji znajdziesz w artykule Konfigurowanie replikacji master-standby w Postgres.
- Na węźle głównym Postgres zmień katalog na /<inst_root>/apigee/apigee-postgresql/pgsql/bin, gdzie /<inst_root> domyślnie ma wartość /opt.
- Ustaw hasło użytkownika „postgres” w PostgreSQL:
- Zaloguj się w bazie danych PostgreSQL za pomocą polecenia:
> psql -h localhost -d apigee -U postgres - Gdy pojawi się prośba, wpisz hasło użytkownika „postgres” jako „postgres”.
- W wierszu poleceń PostgreSQL wpisz to polecenie, aby zmienić domyślne hasło:
apigee=> ALTER USER postgres WITH PASSWORD 'apigee1234'; - Zamknij bazę danych PostgreSQL za pomocą polecenia:
apigee=> \q
- Zaloguj się w bazie danych PostgreSQL za pomocą polecenia:
- Ustaw hasło użytkownika „apigee” w PostgreSQL:
- Zaloguj się w bazie danych PostgreSQL za pomocą polecenia:
> psql -h localhost -d apigee -U apigee - Gdy pojawi się prośba, wpisz hasło użytkownika „apigee” jako „postgres”.
- Aby zmienić domyślne hasło, w wierszu poleceń PostgreSQL wpisz to polecenie:
apigee=> ALTER USER apigee WITH PASSWORD 'apigee1234'; - Zamknij bazę danych PostgreSQL za pomocą polecenia:
apigee=> \q
- Zaloguj się w bazie danych PostgreSQL za pomocą polecenia:
- Ustaw APIGEE_HOME:
> export APIGEE_HOME=/<inst_root>/apigee/edge-postgres-server - Zaszyfruj nowe hasło:
> sh /<inst_root>/apigee/edge-postgres-server/utils/scripts/utilities/passwordgen.sh apigee1234
To polecenie zwraca zaszyfrowane hasło, jak pokazano poniżej. Zaszyfrowane hasło zaczyna się po znaku „:” i nie zawiera znaku „:”.
Zaszyfrowany ciąg znaków :WheaR8U4OeMEM11erxA3Cw== - Zaktualizuj węzeł serwera zarządzania, podając nowe zaszyfrowane hasła użytkowników „postgres” i „apigee”.
- Na serwerze zarządzania przejdź do katalogu /<inst_root>/apigee/customer/application.
- Zmodyfikuj plik management-server.properties, aby ustawić te właściwości. Jeśli ten plik nie istnieje, utwórz go:
Uwaga: niektóre właściwości wymagają zaszyfrowanego hasła użytkownika „postgres”, a inne zaszyfrowanego hasła użytkownika „apigee”.- conf_pg-agent_password=newEncryptedPasswordForPostgresUser
- conf_pg-ingest_password=newEncryptedPasswordForPostgresUser
- conf_query-service_pgDefaultPwd=newEncryptedPasswordForApigeeUser
- conf_query-service_dwDefaultPwd=newEncryptedPasswordForApigeeUser
- conf_analytics_aries.pg.password=newEncryptedPasswordForPostgresUser
- Upewnij się, że plik należy do użytkownika „apigee”:
> chown apigee:apigee management-server.properties
- Zaktualizuj wszystkie węzły serwera Postgres i serwera Qpid, używając nowego zaszyfrowanego hasła.
- Na węźle serwera Postgres lub Qpid zmień katalog na /<inst_root>/apigee/customer/application.
- Zmodyfikuj te pliki. Jeśli te pliki nie istnieją, utwórz je:
- postgres-server.properties
- qpid-server.properties
- Dodaj do plików te właściwości:
Uwaga: wszystkie te właściwości przyjmują zaszyfrowane hasło użytkownika „postgres”.- conf_pg-agent_password=newEncryptedPasswordForPostgresUser
- conf_pg-ingest_password=newEncryptedPasswordForPostgresUser
- conf_query-service_pgDefaultPwd=newEncryptedPasswordForPostgresUser
- conf_query-service_dwDefaultPwd=newEncryptedPasswordForPostgresUser
- conf_analytics_aries.pg.password=newEncryptedPasswordForPostgresUser
- Upewnij się, że właścicielem plików jest użytkownik „apigee”:
> chown apigee:apigee postgres-server.properties
> chown apigee:apigee qpid-server.properties
- Uruchom ponownie te komponenty w podanej kolejności:
- Baza danych PostgreSQL:
> /<inst_root>/apigee/apigee-service/bin/apigee-service apigee-postgresql restart - Serwer Qpid:
> /<inst_root>/apigee/apigee-service/bin/apigee-service edge-qpid-server restart - Serwer Postgres:
> /<inst_root>/apigee/apigee-service/bin/apigee-service edge-postgres-server restart - Serwer zarządzania:
> /<inst_root>/apigee/apigee-service/bin/apigee-service edge-management-server restart
- Baza danych PostgreSQL: