Edge for Private Cloud v4.18.05
После завершения установки вы можете сбросить пароли OpenLDAP, системного администратора Apigee Edge, пользователя организации Edge и Cassandra.
Как сбросить пароль OpenLDAP
В зависимости от конфигурации Edge OpenLDAP можно установить как:
- Один экземпляр OpenLDAP, установленный на узле сервера управления. Например, в конфигурации Edge с 2, 5 или 9 узлами.
- Несколько экземпляров OpenLDAP, установленных на узлах сервера управления и настроенных с репликацией OpenLDAP. Например, в конфигурации Edge с 12 узлами.
- Несколько экземпляров OpenLDAP, установленных на собственных узлах и настроенных с репликацией OpenLDAP. Например, в конфигурации Edge с 13 узлами.
Способ сброса пароля OpenLDAP зависит от конфигурации.
Для одного экземпляра OpenLDAP, установленного на сервере управления, выполните следующие действия:
- На узле Management Server выполните следующую команду, чтобы создать новый пароль OpenLDAP:
/opt/apigee/apigee-service/bin/apigee-service apigee-openldap change-ldap-password -o OLD_PASSWORD -n NEW_PASSWORD
- Чтобы сохранить новый пароль для доступа к серверу управления, выполните следующую команду:
/opt/apigee/apigee-service/bin/apigee-service edge-management-server store_ldap_credentials -p NEW_PASSWORD
Эта команда перезапускает сервер управления.
В конфигурации репликации OpenLDAP с OpenLDAP, установленным на узлах сервера управления, выполните описанные выше действия на обоих узлах сервера управления, чтобы обновить пароль.
В настройке репликации OpenLDAP, где OpenLDAP находится на узле, отличном от сервера управления, сначала измените пароль на обоих узлах OpenLDAP, а затем на обоих узлах сервера управления.
Сброс пароля системного администратора
Чтобы сбросить пароль системного администратора, необходимо выполнить сброс в двух местах:
- Сервер управления
- Интерфейс
Чтобы сбросить пароль системного администратора:
- На узле пользовательского интерфейса остановите пользовательский интерфейс Edge:
/opt/apigee/apigee-service/bin/apigee-service edge-ui stop
- Чтобы сбросить пароль, выполните на сервере управления следующую команду:
/opt/apigee/apigee-service/bin/apigee-service edge-management-server change_sysadmin_password -o currentPW -n newPW
- Отредактируйте файл конфигурации, который вы использовали для установки Edge UI, чтобы задать следующие свойства:
APIGEE_ADMINPW=NEW_PASSWORD SMTPHOST=smtp.gmail.com SMTPPORT=465 SMTPUSER=foo@gmail.com SMTPPASSWORD=bar SMTPSSL=y SMTPMAILFROM="My Company <myco@company.com>"
Обратите внимание, что при передаче нового пароля необходимо указать свойства SMTP, поскольку все свойства в пользовательском интерфейсе сбрасываются.
- Используйте утилиту
apigee-setup, чтобы сбросить пароль в Edge UI из файла конфигурации:/opt/apigee/apigee-setup/bin/setup.sh -p ui -f configFile
- (Только если TLS включен в пользовательском интерфейсе) Повторно включите TLS в пользовательском интерфейсе Edge, как описано в разделе Настройка TLS для пользовательского интерфейса управления.
В среде репликации OpenLDAP с несколькими серверами управления сброс пароля на одном сервере управления автоматически обновляет другой сервер управления. Однако вам необходимо обновить все узлы Edge UI отдельно.
Сбросить пароль пользователя организации
Чтобы сбросить пароль пользователя организации, используйте утилиту apigee-service для вызова apigee-setup:
/opt/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]
Пример:
/opt/apigee/apigee-service/bin/apigee-service apigee-setup reset_user_password -u user@myCo.com -p Foo12345 -a admin@myCo.com -P adminPword
Ниже приведен пример файла конфигурации, который можно использовать с параметром -f.
USER_NAME= user@myCo.com USER_PWD="Foo12345" APIGEE_ADMINPW=ADMIN_PASSWORD
Вы также можете использовать API Update user, чтобы изменить пароль пользователя.
Правила в отношении паролей для системных администраторов и пользователей организации
В этом разделе можно задать требования к длине и надежности паролей для пользователей API Management. В настройках используется ряд предварительно настроенных (и уникально пронумерованных) регулярных выражений для проверки содержимого пароля (например, заглавных и строчных букв, цифр и специальных символов). Запишите эти настройки в файл /opt/apigee/customer/application/management-server.properties. Если такого файла нет, создайте его.
После изменения management-server.properties перезапустите сервер управления:
/opt/apigee/apigee-service/bin/apigee-service edge-management-server restart
Затем вы можете задать оценки надежности паролей, сгруппировав разные комбинации регулярных выражений. Например, вы можете указать, что пароль, содержащий хотя бы одну заглавную и одну строчную букву, получает оценку надежности "3", а пароль, содержащий хотя бы одну строчную букву и одну цифру, получает более высокую оценку "4".
| Свойство | Описание |
|---|---|
conf_security_password.validation.minimum.password.length=8 conf_security_password.validation.default.rating=2 conf_security_password.validation.minimum.rating.required=3 |
Они определяют общие характеристики действительных паролей. По умолчанию минимальная оценка надежности пароля (описана ниже в таблице) равна 3. Обратите внимание, что значение password.validation.default.rating=2 ниже минимально допустимого. Это означает, что если введенный пароль не соответствует настроенным правилам, он получает оценку 2 и считается недопустимым (ниже минимальной оценки 3). |
|
Ниже приведены регулярные выражения, которые определяют характеристики пароля. Обратите внимание, что каждый из них пронумерован. Например, |
|
conf_security_password.validation.regex.1=^(.)\\1+$ |
1 – все символы повторяются. |
conf_security_password.validation.regex.2=^.*[a-z]+.*$ |
2 – хотя бы одна строчная буква; |
conf_security_password.validation.regex.3=^.*[A-Z]+.*$ |
3 – хотя бы одна заглавная буква; |
conf_security_password.validation.regex.4=^.*[0-9]+.*$ |
4. Хотя бы одна цифра. |
conf_security_password.validation.regex.5=^.*[^a-zA-z0-9]+.*$ |
5: хотя бы один специальный символ (не включая символ подчеркивания "_"). |
conf_security_password.validation.regex.6=^.*[_]+.*$ |
6: хотя бы один символ подчеркивания; |
conf_security_password.validation.regex.7=^.*[a-z]{2,}.*$ |
7 – более одной строчной буквы; |
conf_security_password.validation.regex.8=^.*[A-Z]{2,}.*$ |
8 – более одной заглавной буквы. |
conf_security_password.validation.regex.9=^.*[0-9]{2,}.*$ |
9 – несколько цифр. |
conf_security_password.validation.regex.10=^.*[^a-zA-z0-9]{2,}.*$ |
10: более одного специального символа (не считая символа подчеркивания) |
conf_security_password.validation.regex.11=^.*[_]{2,}.*$ |
11: несколько символов подчеркивания |
|
Надежность пароля определяется по следующим правилам: Каждое правило включает одно или несколько регулярных выражений из предыдущего раздела и назначает им числовое значение надежности. Чтобы определить, является ли пароль действительным, его числовая надежность сравнивается со значением conf_security_password.validation.minimum.rating.required в верхней части этого файла. |
|
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 |
Каждое правило пронумеровано. Например, Каждое правило использует следующий формат (справа от знака равенства): regex-index-list,[AND|OR],rating regex-index-list – список регулярных выражений (по номерам из предыдущего раздела) и оператор rating – это числовая оценка надежности, присвоенная каждому правилу. Например, правило 5 означает, что любой пароль, содержащий хотя бы один специальный символ ИЛИ один символ подчеркивания, получает оценку надежности 4. Если в верхней части файла указано |
conf_security_rbac.password.validation.enabled=true |
Если включена система единого входа, отключите проверку пароля для управления доступом на основе ролей. Значение по умолчанию – true. |
Сброс пароля Cassandra
По умолчанию в Cassandra аутентификация отключена. Если вы включите аутентификацию, будет использоваться стандартное имя пользователя cassandra с паролем cassandra. Вы можете использовать этот аккаунт, задать для него другой пароль или создать нового пользователя Cassandra. Добавляйте, удаляйте и изменяйте пользователей с помощью операторов CREATE/ALTER/DROP USER Cassandra.
Инструкции по включению аутентификации Cassandra приведены в этой статье.
Чтобы сбросить пароль Cassandra, необходимо:
- Задайте пароль на любом узле Cassandra, и он будет передан на все узлы Cassandra в кольце.
- Обновите пароль на сервере управления, процессорах сообщений, маршрутизаторах, серверах Qpid и Postgres на каждом узле.
Дополнительную информацию можно найти на странице http://www.datastax.com/documentation/cql/3.0/cql/cql_reference/cqlCommandsTOC.html.
Чтобы сбросить пароль Cassandra:
- Войдите в любой узел Cassandra, используя инструмент
cqlshи учетные данные по умолчанию. Вам нужно изменить пароль только на одном узле Cassandra, и он будет передан на все узлы Cassandra в кольце:/opt/apigee/apigee-cassandra/bin/cqlsh cassIP 9042 -u cassandra -p cassandra
Где:
cassIP– IP-адрес узла Cassandra.9042– порт Cassandra.- Пользователь по умолчанию –
cassandra. - Пароль по умолчанию –
cassandra. Если вы меняли пароль ранее, используйте текущий пароль.
- Чтобы обновить пароль, выполните следующую команду в командной строке
cqlsh>:ALTER USER cassandra WITH PASSWORD 'NEW_PASSWORD';
Если новый пароль содержит символ одинарной кавычки, экранируйте его, добавив перед ним символ одинарной кавычки.
- Выйти из инструмента "
cqlsh":exit
- На узле Management Server выполните следующую команду:
/opt/apigee/apigee-service/bin/apigee-service edge-management-server store_cassandra_credentials -u CASS_USERNAME -p CASS_PASSWORD
При необходимости вы можете передать команде файл, содержащий новое имя пользователя и пароль:
apigee-service edge-management-server store_cassandra_credentials -f configFile
где configFile содержит следующее:
CASS_USERNAME=CASS_USERNAME CASS_PASSWORD=CASS_PASSWROD
Эта команда автоматически перезапускает сервер управления.
- Повторите шаг 4 на следующих устройствах:
- Все процессоры сообщений
- Все маршрутизаторы
- Все серверы Qpid (edge-qpid-server)
- Серверы Postgres (edge-postgres-server)
Пароль Cassandra изменен.
Сброс пароля PostgreSQL
По умолчанию в базе данных PostgreSQL определены два пользователя: postgres и apigee. Для обоих пользователей по умолчанию задан пароль postgres. Чтобы изменить пароль по умолчанию, выполните следующие действия:
Измените пароль на всех главных узлах Postgres. Если у вас есть два сервера Postgres, настроенных в режиме master/standby, то вам нужно изменить пароль только на главном узле. Подробнее о том, как настроить репликацию Master-Standby для Postgres…
- На главном узле Postgres перейдите в каталог
/opt/apigee/apigee-postgresql/pgsql/bin. - Задайте пароль пользователя postgres в PostgreSQL:
- Войдите в базу данных PostgreSQL с помощью следующей команды:
psql -h localhost -d apigee -U postgres
- При появлении запроса введите пароль пользователя postgres – postgres.
- В командной строке PostgreSQL введите следующую команду, чтобы изменить пароль по умолчанию:
ALTER USER postgres WITH PASSWORD 'apigee1234';
- Выйдите из базы данных PostgreSQL с помощью команды:
\q
- Войдите в базу данных PostgreSQL с помощью следующей команды:
- Задайте пароль пользователя apigee в PostgreSQL:
- Войдите в базу данных PostgreSQL с помощью следующей команды:
psql -h localhost -d apigee -U apigee
- При появлении запроса введите пароль пользователя apigee – postgres.
- В командной строке PostgreSQL введите следующую команду, чтобы изменить пароль по умолчанию:
ALTER USER apigee WITH PASSWORD 'NEW_PASSWORD';
- Выйдите из базы данных PostgreSQL с помощью команды:
\q
- Войдите в базу данных PostgreSQL с помощью следующей команды:
- Подход
APIGEE_HOME:export APIGEE_HOME=/opt/apigee/edge-postgres-server
- Зашифруйте новый пароль:
sh /opt/apigee/edge-postgres-server/utils/scripts/utilities/passwordgen.sh apigee1234
Эта команда возвращает зашифрованный пароль, как показано ниже. Зашифрованный пароль начинается после двоеточия и не включает его.
Encrypted string:WheaR8U4OeMEM11erxA3Cw==
- Обновите узел сервера управления, указав новые зашифрованные пароли для пользователей postgres и apigee.
- На сервере управления перейдите в каталог
/opt/apigee/customer/application. - Измените файл
management-server.properties, чтобы задать следующие свойства. Если такого файла нет, создайте его. - Убедитесь, что файл принадлежит пользователю apigee:
chown apigee:apigee management-server.properties
- На сервере управления перейдите в каталог
- Обновите все узлы Postgres Server и Qpid Server, указав новый зашифрованный пароль.
- На узле Postgres Server или Qpid Server перейдите в каталог
/opt/apigee/customer/application. - Измените следующие файлы. Если этих файлов нет, создайте их:
postgres-server.propertiesqpid-server.properties
- Добавьте в файлы следующие свойства:
- Убедитесь, что владельцем файлов является пользователь apigee:
chown apigee:apigee postgres-server.properties
chown apigee:apigee qpid-server.properties
- На узле Postgres Server или Qpid Server перейдите в каталог
- Перезапустите следующие компоненты в указанном порядке:
- База данных PostgreSQL:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
- Сервер Qpid:
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
- Сервер Postgres:
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart
- Сервер управления:
/opt/apigee/apigee-service/bin/apigee-service edge-management-server restart
- База данных PostgreSQL: