Setelah Anda menyelesaikan penginstalan, Anda dapat mereset sandi berikut:
Petunjuk untuk mengatur ulang setiap sandi ini disertakan di bagian berikut ini.
Reset sandi OpenLDAP
Cara mereset sandi OpenLDAP bergantung pada konfigurasi Anda. Bergantung pada konfigurasi Edge Anda, OpenLDAP dapat diinstal sebagai:
- Satu instance OpenLDAP yang diinstal di node Server Pengelolaan. Misalnya, dalam konfigurasi Edge 2 node, 5 node, atau 9 node.
- Beberapa instance OpenLDAP diinstal di node Server Pengelolaan, yang dikonfigurasi dengan replikasi OpenLDAP. Misalnya, dalam konfigurasi Edge 12 node.
- Beberapa instance OpenLDAP diinstal di node-nya sendiri, yang dikonfigurasi dengan replikasi OpenLDAP. Misalnya, dalam konfigurasi Edge 13 node.
Untuk satu instance OpenLDAP yang diinstal di Server Pengelolaan, lakukan hal berikut:
- Pada node Management Server, jalankan perintah berikut untuk membuat sandi OpenLDAP baru:
/opt/apigee/apigee‑service/bin/apigee‑service apigee‑openldap \ change‑ldap‑password ‑o OLD_PASSWORD ‑n NEW_PASSWORD
- Jalankan perintah berikut guna menyimpan sandi baru untuk diakses oleh Server Pengelolaan:
/opt/apigee/apigee‑service/bin/apigee‑service edge‑management‑server \ store_ldap_credentials ‑p NEW_PASSWORD
Perintah ini akan memulai ulang Server Pengelolaan.
Pada penyiapan replikasi OpenLDAP dengan OpenLDAP yang diinstal di node Server Pengelolaan, ikuti langkah-langkah di atas di kedua node Server Pengelolaan untuk memperbarui sandi.
Dalam penyiapan replikasi OpenLDAP dengan OpenLDAP berada di node selain Server Pengelolaan, pastikan Anda terlebih dahulu mengubah sandi di kedua node OpenLDAP, lalu di kedua node Server Pengelolaan.
Reset sandi admin sistem
Mereset sandi admin sistem mengharuskan Anda mereset sandi di dua tempat:
- Server Pengelolaan
- UI
Untuk mereset sandi admin sistem:
- Edit file konfigurasi senyap yang Anda gunakan untuk menginstal UI Edge untuk menetapkan properti
berikut:
APIGEE_ADMINPW=NEW_PASSWORD SMTPHOST=smtp.gmail.com SMTPPORT=465 SMTPUSER=foo@gmail.com SMTPPASSWORD=bar SMTPSSL=y SMTPMAILFROM="My Company <myco@company.com>"
Perhatikan bahwa Anda harus menyertakan properti SMTP saat meneruskan sandi baru karena semua properti di UI direset.
- Pada node UI, hentikan UI Edge:
/opt/apigee/apigee-service/bin/apigee-service edge-ui stop
- Gunakan utilitas
apigee-setup
untuk mereset sandi di UI Edge dari file konfigurasi:/opt/apigee/apigee-setup/bin/setup.sh -p ui -f configFile
- (Hanya jika TLS diaktifkan di UI) Aktifkan kembali TLS di UI Edge seperti yang dijelaskan dalam Mengonfigurasi TLS untuk UI pengelolaan.
- Di Server Pengelolaan, buat file XML baru. Dalam file ini, tetapkan ID pengguna ke "admin" dan tentukan sandi, nama depan, nama belakang, dan alamat email menggunakan format berikut:
<User id="admin"> <Password><![CDATA[password]]></Password> <FirstName>first_name</FirstName> <LastName>last_name</LastName> <EmailId>email_address</EmailId> </User>
- Di Server Pengelolaan, jalankan perintah berikut:
curl -u "admin_email_address:admin_password" -H \ "Content-Type: application/xml" -H "Accept: application/json" -X POST \ "http://localhost:8080/v1/users/admin_email_address" -d @your_data_file
Dengan your_data_file adalah file yang Anda buat di langkah sebelumnya.
Edge memperbarui sandi admin Anda di Server Pengelolaan.
- Hapus file XML yang Anda buat. Sandi tidak boleh disimpan secara permanen dalam teks yang jelas.
Dalam lingkungan replikasi OpenLDAP dengan beberapa Server Pengelolaan, mereset sandi di satu Server Pengelolaan akan otomatis memperbarui Server Pengelolaan lainnya. Namun, Anda harus mengupdate semua node UI Edge secara terpisah.
Reset sandi pengguna organisasi
Untuk mereset sandi bagi pengguna organisasi, gunakan utilitas apigee-servce
untuk memanggil apigee-setup
, seperti yang ditampilkan dalam contoh berikut:
/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]
Contoh:
/opt/apigee/apigee‑service/bin/apigee‑service apigee‑setup reset_user_password ‑u user@myCo.com ‑p Foo12345 ‑a admin@myCo.com ‑P adminPword
cp ~/Documents/tmp/hybrid_root/apigeectl_beta2_a00ae58_linux_64/README.md ~/Documents/utilities/README.md
Di bawah ini adalah contoh file konfigurasi yang dapat Anda gunakan dengan opsi "-f":
USER_NAME=user@myCo.com USER_PWD="Foo12345" APIGEE_ADMINPW=ADMIN_PASSWORD
Anda juga dapat menggunakan Update user API untuk mengubah sandi pengguna.
Aturan {i>password<i} pengguna organisasi dan SysAdmin
Gunakan bagian ini untuk menerapkan tingkat panjang dan kekuatan sandi yang diinginkan untuk pengguna
pengelolaan API Anda. Setelan ini menggunakan serangkaian ekspresi reguler yang telah dikonfigurasi (dan diberi nomor unik)
untuk memeriksa konten sandi (seperti huruf besar, huruf kecil, angka, dan karakter
khusus). Tulis setelan ini ke file /opt/apigee/customer/application/management-server.properties
. Jika file tersebut tidak ada, buatlah file tersebut.
Setelah mengedit management-server.properties
, mulai ulang server pengelolaan:
/opt/apigee/apigee-service/bin/apigee-service edge-management-server restart
Lalu, Anda dapat menetapkan rating kekuatan sandi dengan mengelompokkan berbagai kombinasi ekspresi reguler. Misalnya, Anda dapat menentukan bahwa sandi dengan setidaknya satu huruf besar dan satu huruf kecil mendapatkan rating kekuatan "3", tetapi sandi dengan setidaknya satu huruf kecil dan satu angka mendapatkan rating "4" yang lebih kuat.
Properti | Deskripsi |
---|---|
conf_security_password.validation.minimum.password.length=8 conf_security_password.validation.default.rating=2 conf_security_password.validation.minimum.rating.required=3 |
Gunakan ini untuk menentukan karakteristik keseluruhan dari {i>password<i} yang valid. Rating minimum default untuk kekuatan sandi (dijelaskan nanti dalam tabel) adalah 3. Perhatikan bahwa password.validation.default.rating=2 lebih rendah dari rating minimum yang diperlukan, yang berarti jika sandi yang dimasukkan berada di luar aturan yang Anda konfigurasikan, sandi diberi rating 2 dan karenanya tidak valid (di bawah rating minimum 3). |
Berikut adalah ekspresi reguler yang mengidentifikasi karakteristik {i>password<i}. Perhatikan
bahwa setiap project diberi nomor. Misalnya,
|
|
conf_security_password.validation.regex.1=^(.)\\1+$ |
1: Semua karakter berulang |
conf_security_password.validation.regex.2=^.*[a-z]+.*$ |
2: Minimum satu huruf kecil |
conf_security_password.validation.regex.3=^.*[A-Z]+.*$ |
3: Setidaknya satu huruf besar |
conf_security_password.validation.regex.4=^.*[0-9]+.*$ |
4: Minimal satu digit |
conf_security_password.validation.regex.5=^.*[^a-zA-z0-9]+.*$ |
5: Minimal satu karakter khusus (tidak termasuk garis bawah _) |
conf_security_password.validation.regex.6=^.*[_]+.*$ |
6: Minimal satu garis bawah |
conf_security_password.validation.regex.7=^.*[a-z]{2,}.*$ |
7: Lebih dari satu huruf kecil |
conf_security_password.validation.regex.8=^.*[A-Z]{2,}.*$ |
8: Lebih dari satu huruf besar |
conf_security_password.validation.regex.9=^.*[0-9]{2,}.*$ |
9: Lebih dari satu digit |
conf_security_password.validation.regex.10=^.*[^a-zA-z0-9]{2,}.*$ |
10: Lebih dari satu karakter khusus (tidak termasuk garis bawah) |
conf_security_password.validation.regex.11=^.*[_]{2,}.*$ |
11: Lebih dari satu garis bawah |
Aturan berikut menentukan kekuatan sandi berdasarkan isi sandi. Setiap aturan menyertakan satu atau beberapa ekspresi reguler dari bagian sebelumnya dan menetapkan kekuatan numerik ke aturan tersebut. Kekuatan numerik sandi dibandingkan dengan angka conf_security_password.validation.minimum.rating.diperlukan di bagian atas file ini untuk menentukan apakah sandi valid atau tidak. |
|
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 |
Setiap aturan diberi nomor. Misalnya, Setiap aturan menggunakan format berikut (kanan tanda sama dengan): regex-index-list,[AND|OR],rating regex-index-list adalah daftar ekspresi reguler (berdasarkan angka dari
bagian sebelumnya), bersama dengan operator rating adalah rating kekuatan numerik yang diberikan untuk setiap aturan. Misalnya, aturan 5 berarti setiap sandi dengan minimal satu karakter khusus ATAU satu
garis bawah mendapatkan rating kekuatan 4. Dengan |
conf_security_rbac.password.validation.enabled=true |
Tetapkan validasi sandi kontrol akses berbasis peran ke salah (false) saat single sign-on (SSO) diaktifkan. Defaultnya adalah true (benar). |
Reset sandi Cassandra
Secara default, Cassandra mengirim dengan autentikasi yang dinonaktifkan. Jika autentikasi diaktifkan, pengguna yang telah ditetapkan bernama cassandra
dengan sandi cassandra
akan digunakan. Anda dapat menggunakan akun ini,
menetapkan sandi lain untuk akun ini, atau membuat pengguna Cassandra baru. Menambahkan, menghapus, dan
memodifikasi pengguna dengan menggunakan pernyataan CREATE/ALTER/DROP USER
Cassandra.
Untuk mengetahui informasi tentang cara mengaktifkan autentikasi Cassandra, lihat Mengaktifkan autentikasi Cassandra.
Untuk mereset sandi Cassandra, Anda harus:
- Tetapkan sandi di satu node Cassandra dan sandi akan disiarkan ke semua node Cassandra dalam ring
- Mengupdate Server Pengelolaan, Prosesor Pesan, Router, server Qpid, dan server Postgres di setiap node dengan sandi baru
Untuk mengetahui informasi selengkapnya, baca Perintah CQL.
Untuk mereset sandi Cassandra:
- Login ke salah satu node Cassandra menggunakan alat
cqlsh
dan kredensial default. Anda hanya perlu mengubah sandi di satu node Cassandra dan sandi akan disiarkan ke semua node Cassandra dalam ring:/opt/apigee/apigee-cassandra/bin/cqlsh cassIP 9042 -u cassandra -p 'cassandra'
Dengan keterangan:
cassIP
adalah alamat IP node Cassandra.9042
adalah port Cassandra.- Pengguna default-nya adalah
cassandra
. - Sandi default adalah '
cassandra
'. Jika Anda sebelumnya telah mengubah sandi, gunakan sandi saat ini. Jika sandi berisi karakter khusus, Anda harus menggabungkannya dalam tanda kutip tunggal.
- Jalankan perintah berikut sebagai perintah
cqlsh>
untuk memperbarui sandi:ALTER USER cassandra WITH PASSWORD 'NEW_PASSWORD';
Jika sandi baru berisi karakter kutip tunggal, ganti sandi dengan mengawalinya dengan karakter kutip tunggal.
- Keluar dari alat
cqlsh
:exit
- Pada node Server Pengelolaan, jalankan perintah berikut:
/opt/apigee/apigee-service/bin/apigee-service edge-management-server store_cassandra_credentials -u CASS_USERNAME -p 'CASS_PASSWORD'
Jika ingin, Anda dapat meneruskan file ke perintah yang berisi nama pengguna dan sandi baru:
apigee-service edge-management-server store_cassandra_credentials -f configFile
Dengan configFile berisi hal berikut:
CASS_USERNAME=CASS_USERNAME CASS_PASSWORD='CASS_PASSWROD'
Perintah ini akan otomatis memulai ulang Server Pengelolaan.
- Ulangi langkah 4 pada:
- Semua Pemroses Pesan
- Semua Router
- Semua server Qpid (edge-qpid-server)
- Server postgres (edge-postgres-server)
Sandi Cassandra sekarang diubah.
Mereset sandi PostgreSQL
Secara default, database PostgreSQL memiliki dua pengguna yang ditentukan: postgres
dan apigee
.
Kedua pengguna memiliki sandi default postgres
. Gunakan prosedur berikut untuk mengubah sandi default.
Ubah sandi di semua node master Postgres. Jika memiliki dua server Postgres yang dikonfigurasi dalam mode master/standby, Anda hanya perlu mengubah Sandi pada node master. Lihat Menyiapkan replikasi master-standby untuk Postgres untuk mengetahui informasi selengkapnya.
- Pada node Master Postgres, ubah direktori menjadi
/opt/apigee/apigee-postgresql/pgsql/bin
. - Tetapkan sandi pengguna
postgres
PostgreSQL:- Login ke database PostgreSQL menggunakan perintah:
psql -h localhost -d apigee -U postgres
- Saat diminta, masukkan sandi pengguna
postgres
yang sudah ada sebagaipostgres
. - Pada command prompt PostgreSQL, masukkan perintah berikut untuk mengubah sandi default:
ALTER USER postgres WITH PASSWORD 'new_password';
Setelah berhasil, PostgreSQL merespons dengan hal berikut:
ALTER ROLE
- Keluar dari database PostgreSQL menggunakan perintah berikut:
\q
- Login ke database PostgreSQL menggunakan perintah:
- Tetapkan sandi pengguna
apigee
PostgreSQL:- Login ke database PostgreSQL menggunakan perintah:
psql -h localhost -d apigee -U apigee
- Saat diminta, masukkan sandi pengguna
apigee
sebagaipostgres
. - Pada command prompt PostgreSQL, masukkan perintah berikut untuk mengubah sandi default:
ALTER USER apigee WITH PASSWORD 'new_password';
- Keluar dari database PostgreSQL menggunakan perintah:
\q
Anda dapat menetapkan sandi pengguna
postgres
danapigee
ke nilai yang sama atau nilai yang berbeda. - Login ke database PostgreSQL menggunakan perintah:
- Tetapkan
APIGEE_HOME
:export APIGEE_HOME=/opt/apigee/edge-postgres-server
- Enkripsi sandi baru:
sh /opt/apigee/edge-analytics/utils/scripts/utilities/passwordgen.sh new_password
Perintah ini menampilkan sandi yang dienkripsi. Sandi terenkripsi dimulai setelah karakter ":" dan tidak menyertakan ":"; misalnya, sandi terenkripsi untuk "apigee1234" adalah:
Encrypted string:WheaR8U4OeMEM11erxA3Cw==
- Perbarui node Server Pengelolaan dengan sandi terenkripsi baru untuk pengguna
postgres
danapigee
.- Di Server Pengelolaan, ubah direktori menjadi
/opt/apigee/customer/application
. - Edit file
management-server.properties
untuk menetapkan properti berikut. Jika file ini tidak ada, buatlah file tersebut. - Pastikan file tersebut adalah milik pengguna
apigee
:chown apigee:apigee management-server.properties
- Di Server Pengelolaan, ubah direktori menjadi
- Update semua node Postgres Server dan Qpid Server dengan sandi terenkripsi baru.
- Pada node Postgres Server atau Qpid Server, ubah ke direktori berikut:
/opt/apigee/customer/application
- Buka file berikut untuk diedit:
postgres-server.properties
qpid-server.properties
Jika file ini tidak ada, buatlah file tersebut.
- Tambahkan properti berikut ke file:
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
- Pastikan file tersebut adalah milik pengguna
apigee
:chown apigee:apigee postgres-server.properties
chown apigee:apigee qpid-server.properties
- Pada node Postgres Server atau Qpid Server, ubah ke direktori berikut:
- Update komponen SSO (jika SSO diaktifkan):
Hubungkan ke atau login ke node tempat komponen
apigee-sso
dijalankan. Ini juga disebut sebagai server SSO.Pada penginstalan AIO atau 3 node, node ini adalah node yang sama dengan Server Pengelolaan.
Jika memiliki beberapa node yang menjalankan komponen
apigee-sso
, Anda harus melakukan langkah-langkah ini pada setiap node.- Buka file berikut untuk mengedit:
/opt/apigee/customer/application/sso.properties
Jika file tidak ada, buat file tersebut.
- Tambahkan baris berikut ke file:
conf_uaa_database_password=new_password_in_plain_text
Contoh:
conf_uaa_database_password=apigee1234
- Jalankan perintah berikut untuk menerapkan perubahan konfigurasi ke
komponen
apigee-sso
:/opt/apigee/apigee-service/bin/apigee-service apigee-sso configure
- Ulangi langkah-langkah ini untuk setiap server SSO.
- Mulai ulang komponen berikut dalam urutan berikut:
- Database PostgreSQL:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
- Server Qpid:
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
- Server Postgres:
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart
- Server Pengelolaan:
/opt/apigee/apigee-service/bin/apigee-service edge-management-server restart
- Server SSO:
/opt/apigee/apigee-service/bin/apigee-service apigee-sso restart
- Database PostgreSQL: