Edge for Private Cloud версии 4.17.01
После завершения установки вы можете сбросить пароли 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 oldPword -n newPword - Выполните следующую команду, чтобы сохранить новый пароль для доступа к серверу управления:
> /opt/apigee/apigee-service/bin/apigee-service edge-management-server store_ldap_credentials -p newPword
Эта команда перезапускает сервер управления.
В конфигурации репликации OpenLDAP с OpenLDAP, установленным на узлах сервера управления, выполните описанные выше действия на обоих узлах сервера управления, чтобы обновить пароль.
В настройке репликации OpenLDAP, где OpenLDAP находится на узле, отличном от сервера управления, сначала измените пароль на обоих узлах OpenLDAP, а затем на обоих узлах сервера управления.
Сброс пароля системного администратора
Чтобы сбросить пароль системного администратора, необходимо выполнить сброс в двух местах:
- Сервер управления
- Интерфейс
Предупреждение. Перед сбросом пароля системного администратора необходимо остановить Edge UI. Поскольку вы сначала сбросили пароль на сервере управления, может пройти некоторое время, прежде чем новый пароль начнет использоваться в интерфейсе. Если интерфейс выполнит более трех вызовов со старым паролем, сервер OpenLDAP заблокирует аккаунт системного администратора на три минуты.
Чтобы сбросить пароль системного администратора:
- На узле пользовательского интерфейса остановите Edge UI:
> /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=newPW
SMTPHOST=smtp.gmail.com
SMTPPORT=465
SMTPUSER=foo@gmail.com
SMTPPASSWORD=bar
SMTPSSL=y
Обратите внимание, что при передаче нового пароля необходимо включить свойства SMTP, поскольку все свойства в пользовательском интерфейсе сбрасываются. - Сбросьте пароль в Edge UI из файла конфигурации с помощью утилиты apigee-setup:
> /opt/apigee/apigee-setup/bin/setup.sh -p ui -f configFile - (Только если TLS включен в интерфейсе Edge) Снова включите 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= adminPword
Вы также можете использовать 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. conf_security_password.validation.default.rating=2 conf_security_password.validation.minimum. |
Они определяют общие характеристики действительных паролей. По умолчанию минимальная оценка надежности пароля (описана ниже в таблице) равна 3. Обратите внимание, что значение password.validation.default.rating=2 ниже минимально допустимого. Это означает, что если введенный пароль не соответствует настроенным правилам, он получает оценку 2 и считается недопустимым (ниже минимальной оценки 3). |
|
Ниже приведены регулярные выражения, которые определяют характеристики пароля. Обратите внимание, что каждый из них пронумерован. Например, "password.validation.regex.5=…" – это выражение номер 5. Эти числа используются в другом разделе файла для настройки различных комбинаций, определяющих общую надежность пароля. |
|
|
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 |
Каждое правило пронумеровано. Например, "password.validation.rule.3=…" – это правило номер 3. Каждое правило использует следующий формат (справа от знака равенства): <regex-index-list>,<AND|OR>,<rating> regex-index-list – список регулярных выражений (по номерам из предыдущего раздела) с оператором AND|OR (означает, что нужно учитывать все или любое из перечисленных выражений). rating – числовое значение, которое вы назначаете определенному правилу. Например, правило 5 означает, что любой пароль, содержащий хотя бы один специальный символ ИЛИ один символ подчеркивания, получает оценку надежности 4. С помощью password.validation.minimum. |
|
conf_security_rbac.password.validation.enabled=true |
Если включена система единого входа, отключите проверку пароля для управления доступом на основе ролей. Значение по умолчанию – true. |
Сброс пароля Cassandra
По умолчанию в Cassandra аутентификация отключена. Если вы включите аутентификацию, будет использоваться предопределенный пользователь с именем cassandra и паролем cassandra. Вы можете использовать этот аккаунт, задать для него другой пароль или создать нового пользователя Cassandra. Добавляйте, удаляйте и изменяйте пользователей с помощью инструкций CREATE/ALTER/DROP USER.
Инструкции по включению аутентификации Cassandra приведены в этой статье.
Чтобы сбросить пароль Cassandra, выполните следующие действия:
- Задайте пароль на любом узле Cassandra, и он будет передан на все узлы Cassandra в кольце.
- Обновите Management Server, Message Processors, Routers, серверы Qpid, серверы Postgres и BaaS Stack на каждом узле, указав новый пароль.
Дополнительную информацию можно найти на странице 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>:
cqlsh> ALTER USER cassandra WITH PASSWORD 'NEW_PASSWORD';
Если новый пароль содержит одинарную кавычку, экранируйте ее, добавив перед ней ещё одну одинарную кавычку. - Выйдите из инструмента cqlsh:
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
Эта команда автоматически перезапускает Management Server. - Повторите шаг 4 на следующих устройствах:
- Все процессоры сообщений
- Все маршрутизаторы
- Все серверы Qpid (edge-qpid-server)
- Серверы Postgres (edge-postgres-server)
- На узле BaaS Stack для версии 4.16.05.04 и более поздних:
- Выполните следующую команду, чтобы сгенерировать зашифрованный пароль:
> /opt/apigee/apigee-service/bin/apigee-service baas-usergrid secure_password
Эта команда запрашивает пароль в виде обычного текста и возвращает зашифрованный пароль в следующем формате:
SECURE:ae1b6dedbf6b26aaab8bee815a910737c1c15b55f3505c239e43bc09f8050 - Задайте следующие токены в файле /opt/apigee/customer/application/usergrid.properties.
Если файла нет, создайте его:
usergrid-deployment_cassandra.username=cassandra
usergrid-deployment_cassandra.password=SECURE:ae1b6dedbf6b26aaab8bee815a910737c1c15b55f3505c239e43bc09f8050
В этом примере используется имя пользователя по умолчанию для Cassandra. Если вы изменили имя пользователя, задайте соответствующее значение для параметра usergrid-deployment_cassandra.username.
Убедитесь, что вы добавили префикс SECURE: к паролю. В противном случае стек BaaS интерпретирует значение как незашифрованное.
Примечание. У каждого узла BaaS Stack есть собственный уникальный ключ, используемый для шифрования пароля. Поэтому вам необходимо сгенерировать зашифрованное значение на каждом узле BaaS Stack отдельно. - Измените владельца файла usergrid.properties на пользователя apigee:
> chown apigee:apigee /opt/apigee/customer/application/usergrid.properties - Настройте узел Stack:
> /opt/apigee/apigee-service/bin/apigee-service baas-usergrid configure - Перезапустите стек BaaS:
> /opt/apigee/apigee-service/bin/apigee-service baas-usergrid restart - Повторите эти действия для всех узлов BaaS Stack.
- Выполните следующую команду, чтобы сгенерировать зашифрованный пароль:
Пароль 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 введите следующую команду, чтобы изменить пароль по умолчанию:
apigee=> ALTER USER postgres WITH PASSWORD 'apigee1234'; - Выйдите из базы данных PostgreSQL с помощью команды:
apigee=> \q
- Войдите в базу данных PostgreSQL с помощью команды
- Задайте пароль пользователя apigee в PostgreSQL:
- Войдите в базу данных PostgreSQL с помощью команды:
> psql -h localhost -d apigee -U apigee - Когда появится запрос, введите пароль пользователя apigee – postgres.
- В командной строке PostgreSQL введите следующую команду, чтобы изменить пароль по умолчанию:
apigee=> ALTER USER apigee WITH PASSWORD 'apigee1234'; - Выйдите из базы данных PostgreSQL с помощью команды:
apigee=> \q
- Войдите в базу данных PostgreSQL с помощью команды:
- Задайте переменную APIGEE_HOME:
> export APIGEE_HOME=/opt/apigee/edge-postgres-server - Зашифруйте новый пароль:
> sh /opt/apigee/edge-postgres-server/utils/scripts/utilities/passwordgen.sh apigee1234
Эта команда возвращает зашифрованный пароль, как показано ниже. Зашифрованный пароль начинается после символа ":" и не включает его.
Зашифрованная строка :WheaR8U4OeMEM11erxA3Cw== - Обновите узел сервера управления, указав новые зашифрованные пароли для пользователей postgres и apigee.
- На сервере управления перейдите в каталог /opt/apigee/customer/application.
- Измените файл management-server.properties, чтобы задать следующие свойства: Если этого файла нет, создайте его:
Примечание. Некоторые свойства принимают зашифрованный пароль пользователя postgres, а некоторые – зашифрованный пароль пользователя 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
- Убедитесь, что файл принадлежит пользователю apigee:
> chown apigee:apigee management-server.properties
- Обновите все узлы Postgres Server и Qpid Server, указав новый зашифрованный пароль.
- На узле Postgres Server или Qpid Server перейдите в каталог /opt/apigee/customer/application.
- Измените следующие файлы. Если этих файлов нет, создайте их:
- postgres-server.properties
- qpid-server.properties
- Добавьте в файлы следующие свойства:
Примечание. Все эти свойства принимают зашифрованный пароль пользователя 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
- Убедитесь, что владельцем файлов является пользователь apigee:
> chown apigee:apigee postgres-server.properties
> chown apigee:apigee qpid-server.properties
- Перезапустите следующие компоненты в указанном порядке:
- База данных PostgreSQL:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart - Сервер Qpid:
> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart - Postgres Server:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart - Management Server:
> /opt/apigee/apigee-service/bin/apigee-service edge-management-server restart
- База данных PostgreSQL: