Edge Şifrelerini Sıfırlama

Edge for Private Cloud 4.18.01 sürümü

Yükleme tamamlandıktan sonra OpenLDAP, Apigee Edge sistem yöneticisi, Edge kuruluş kullanıcısı ve Cassandra şifrelerini sıfırlayabilirsiniz.

OpenLDAP şifresini sıfırlama

Edge yapılandırmanıza bağlı olarak OpenLDAP şu şekilde yüklenebilir:

  • Yönetim Sunucusu düğümüne yüklenmiş tek bir OpenLDAP örneği. Örneğin, 2 düğümlü, 5 düğümlü veya 9 düğümlü bir Edge yapılandırmasında.
  • Yönetim Sunucusu düğümlerine yüklenmiş ve OpenLDAP replikasyonuyla yapılandırılmış birden fazla OpenLDAP örneği. Örneğin, 12 düğümlü bir Edge yapılandırmasında.
  • Kendi düğümlerine yüklenmiş ve OpenLDAP replikasyonuyla yapılandırılmış birden fazla OpenLDAP örneği. Örneğin, 13 düğümlü bir Edge yapılandırmasında.

OpenLDAP şifresini sıfırlama yönteminiz yapılandırmanıza bağlıdır.

Yönetim Sunucusu'nda yüklü tek bir OpenLDAP örneği için aşağıdakileri yapın:

  1. Yönetim Sunucusu düğümünde aşağıdaki komutu çalıştırarak yeni OpenLDAP şifresini oluşturun:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-openldap change-ldap-password -o oldPword -n newPword
  2. Yönetim Sunucusu'nun erişebilmesi için yeni şifreyi depolamak üzere aşağıdaki komutu çalıştırın:
    > /opt/apigee/apigee-service/bin/apigee-service edge-management-server store_ldap_credentials -p newPword

    Bu komut, Yönetim Sunucusu'nu yeniden başlatır.

Yönetim Sunucusu düğümlerinde OpenLDAP'nin yüklü olduğu bir OpenLDAP replikasyon kurulumunda, şifreyi güncellemek için her iki Yönetim Sunucusu düğümünde de yukarıdaki adımları uygulayın.

OpenLDAP'nin Yönetim Sunucusu dışında bir düğümde olduğu bir OpenLDAP replikasyon kurulumunda, şifreyi önce her iki OpenLDAP düğümünde, ardından her iki Yönetim Sunucusu düğümünde değiştirdiğinizden emin olun.

Sistem yöneticisi şifresini sıfırlama

Sistem yöneticisi şifresini sıfırlamak için şifreyi iki yerde sıfırlamanız gerekir:

  • Yönetim Sunucusu
  • UI

Uyarı: Sistem yöneticisi şifresini sıfırlamadan önce Edge kullanıcı arayüzünü durdurmanız gerekir. Şifreyi önce Yönetim Sunucusu'nda sıfırladığınız için kullanıcı arayüzünün eski şifreyi kullanmaya devam ettiği kısa bir süre olabilir. Kullanıcı arayüzü eski şifreyi kullanarak üçten fazla çağrı yaparsa OpenLDAP sunucusu, sistem yöneticisi hesabını üç dakika boyunca kilitler.

Sistem yöneticisi şifresini sıfırlamak için:

  1. Kullanıcı arayüzü düğümünde Edge kullanıcı arayüzünü durdurun:
    > /opt/apigee/apigee-service/bin/apigee-service edge-ui stop
  2. Yönetim sunucusunda, şifreyi sıfırlamak için aşağıdaki komutu çalıştırın:
    > /opt/apigee/apigee-service/bin/apigee-service edge-management-server change_sysadmin_password -o currentPW -n newPW
  3. Aşağıdaki özellikleri ayarlamak için Edge kullanıcı arayüzünü yüklemek üzere kullandığınız sessiz yapılandırma dosyasını düzenleyin:
    APIGEE_ADMINPW=newPW
    SMTPHOST=smtp.gmail.com
    SMTPPORT=465
    SMTPUSER=foo@gmail.com
    SMTPPASSWORD=bar
    SMTPSSL=y
    SMTPMAILFROM="My Company <myco@company.com>"

    Kullanıcı arayüzündeki tüm özellikler sıfırlandığından yeni şifreyi iletirken SMTP özelliklerini eklemeniz gerektiğini unutmayın.
  4. Edge kullanıcı arayüzündeki şifreyi yapılandırma dosyasından sıfırlamak için apigee-setup yardımcı programını kullanın:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ui -f configFile
  5. (Yalnızca kullanıcı arayüzünde TLS etkinse) Yönetim kullanıcı arayüzü için TLS'yi yapılandırma bölümünde açıklandığı gibi Edge kullanıcı arayüzünde TLS'yi yeniden etkinleştirin.

Birden fazla yönetim sunucusunun bulunduğu bir OpenLDAP replikasyon ortamında, bir yönetim sunucusunda şifrenin sıfırlanması diğer yönetim sunucusunu otomatik olarak günceller. Ancak tüm Edge kullanıcı arayüzü düğümlerini ayrı ayrı güncellemeniz gerekir.

Kuruluş kullanıcısının şifresini sıfırlama

Bir kuruluş kullanıcısının şifresini sıfırlamak için apigee-servce yardımcı programını kullanarak apigee-setup'ı çağırın:

/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]

Örneğin:

> /opt/apigee/apigee-service/bin/apigee-service apigee-setup reset_user_password -u user@myCo.com -p foo12345 -a admin@myCo.com -P adminPword

Aşağıda, "-f" seçeneğiyle kullanabileceğiniz örnek bir yapılandırma dosyası gösterilmektedir:

USER_NAME= user@myCo.com
USER_PWD= "foo12345"
APIGEE_ADMINPW= adminPword

Kullanıcı şifresini değiştirmek için Update user API'yi de kullanabilirsiniz.

Sistem Yöneticisi ve Kuruluş Kullanıcısı Şifre Kuralları

API yönetimi kullanıcılarınız için istediğiniz şifre uzunluğu ve gücü düzeyini zorunlu kılmak üzere bu bölümü kullanın. Ayarlar, şifre içeriğini (büyük harf, küçük harf, sayılar ve özel karakterler gibi) kontrol etmek için önceden yapılandırılmış (ve benzersiz şekilde numaralandırılmış) bir dizi normal ifade kullanır. Bu ayarları /opt/apigee/customer/application/management-server.properties dosyasına yazın. Bu dosya yoksa oluşturun.

management-server.properties dosyasını düzenledikten sonra yönetim sunucusunu yeniden başlatın:

> /opt/apigee/apigee-service/bin/apigee-service edge-management-server restart

Ardından, farklı normal ifade kombinasyonlarını gruplandırarak şifre gücü derecelendirmeleri belirleyebilirsiniz. Örneğin, en az bir büyük ve bir küçük harf içeren bir şifrenin güç derecesinin "3" olduğunu, ancak en az bir küçük harf ve bir sayı içeren bir şifrenin daha güçlü bir derecelendirme olan "4" olduğunu belirleyebilirsiniz.

Mülkler

Açıklama

conf_security_password.validation.minimum.
password.length=8

conf_security_password.validation.default.rating=2

conf_security_password.validation.minimum.
rating.required=3

Geçerli şifrelerin genel özelliklerini belirlemek için bunları kullanın. Şifre gücü için varsayılan minimum derecelendirme (tablonun ilerleyen kısımlarında açıklanmıştır) 3'tür.

password.validation.default.rating=2 değerinin, gereken minimum derecelendirmeden düşük olduğuna dikkat edin. Bu, girilen bir şifre yapılandırdığınız kuralların dışına çıkarsa şifrenin 2 olarak derecelendirileceği ve bu nedenle geçersiz olacağı (minimum derecelendirme olan 3'ün altında) anlamına gelir.

Aşağıda, şifre özelliklerini tanımlayan normal ifadeler verilmiştir. Her birinin numaralandırıldığına dikkat edin. Örneğin, "password.validation.regex.5=…" 5 numaralı ifadedir. Bu sayıları, dosyanın sonraki bir bölümünde genel şifre gücünü belirleyen farklı kombinasyonlar ayarlamak için kullanacaksınız.

conf_security_password.validation.regex.1=^(.)\\1+$

1: Tüm karakterler tekrarlanır

conf_security_password.validation.regex.2=^.*[a-z]+.*$

2: En az bir küçük harf

conf_security_password.validation.regex.3=^.*[A-Z]+.*$

3 – En az bir büyük harf

conf_security_password.validation.regex.4=^.*[0-9]+.*$

4 – En az bir rakam

conf_security_password.validation.regex.5=^.*[^a-zA-z0-9]+.*$

5: En az bir özel karakter (alt çizgi _ hariç)

conf_security_password.validation.regex.6=^.*[_]+.*$

6: En az bir alt çizgi

conf_security_password.validation.regex.7=^.*[a-z]{2,}.*$

7 – Birden fazla küçük harf

conf_security_password.validation.regex.8=^.*[A-Z]{2,}.*$

8 – Birden fazla büyük harf

conf_security_password.validation.regex.9=^.*[0-9]{2,}.*$

9 – Birden fazla basamak

conf_security_password.validation.regex.10=^.*[^a-zA-z0-9]{2,}.*$

10: Birden fazla özel karakter (alt çizgi hariç)

conf_security_password.validation.regex.11=^.*[_]{2,}.*$

11 – Birden fazla alt çizgi

Aşağıdaki kurallar, şifre içeriğine göre şifrenin gücünü belirler. Her kural, önceki bölümden bir veya daha fazla normal ifade içerir ve buna sayısal bir güç atar. Şifrenin geçerli olup olmadığını belirlemek için şifrenin sayısal gücü, bu dosyanın üst kısmındaki conf_security_password.validation.minimum.rating.required sayısıyla karşılaştırılır.

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

Her kural numaralandırılır. Örneğin, "password.validation.rule.3=…" 3 numaralı kuraldır.

Her kural aşağıdaki biçimi kullanır (eşittir işaretinin sağında):

<regex-index-list>,<AND|OR>,<rating>

regex-index-list, normal ifadelerin listesidir (önceki bölümdeki numaraya göre) ve AND|OR operatörüyle birlikte kullanılır (listelenen ifadelerin tümünü veya herhangi birini dikkate alın anlamına gelir).

rating, her kurala verilen sayısal güç derecelendirmesidir.

Örneğin, 5. kural, en az bir özel karakter VEYA bir alt çizgi içeren tüm şifrelerin güç derecesinin 4 olduğu anlamına gelir. password.validation.minimum ile.
rating.required=3 ise 4 puanlı bir şifre geçerlidir.

conf_security_rbac.password.validation.enabled=true

Tek oturum açma (TOA) etkinleştirildiğinde rol tabanlı erişim denetimi şifre doğrulamasını "false" olarak ayarlayın. Varsayılan değer "true"dur.

Cassandra şifresi sıfırlanıyor

Cassandra, varsayılan olarak kimlik doğrulama devre dışı bırakılmış şekilde gelir. Kimlik doğrulamayı etkinleştirirseniz cassandra kullanıcı adına sahip önceden tanımlanmış bir kullanıcıyı cassandra şifresiyle kullanır. Bu hesabı kullanabilir, bu hesap için farklı bir şifre belirleyebilir veya yeni bir Cassandra kullanıcısı oluşturabilirsiniz. Cassandra CREATE/ALTER/DROP USER ifadelerini kullanarak kullanıcı ekleme, kaldırma ve değiştirme

Cassandra kimlik doğrulamasını nasıl etkinleştireceğiniz hakkında bilgi edinmek için Cassandra kimlik doğrulamasını etkinleştirme başlıklı makaleyi inceleyin.

Cassandra şifresini sıfırlamak için şunları yapmanız gerekir:

  • Şifreyi herhangi bir Cassandra düğümünde ayarlayın. Şifre, halkadaki tüm Cassandra düğümlerine yayınlanır.
  • Her düğümdeki Yönetim Sunucusu, Mesaj İşlemcileri, Yönlendiriciler, Qpid sunucuları, Postgres sunucuları ve BaaS Yığınını yeni şifreyle güncelleyin.

Daha fazla bilgi için http://www.datastax.com/documentation/cql/3.0/cql/cql_reference/cqlCommandsTOC.html adresini ziyaret edin.

Cassandra şifresini sıfırlamak için:

  1. cqlsh aracını ve varsayılan kimlik bilgilerini kullanarak herhangi bir Cassandra düğümüne giriş yapın. &Şifreyi yalnızca bir Cassandra düğümünde değiştirmeniz yeterlidir. Değişiklik, halkadaki tüm Cassandra düğümlerine yayınlanır:
    > /opt/apigee/apigee-cassandra/bin/cqlsh cassIP 9042 -u cassandra -p cassandra

    Burada:
    • cassIP, Cassandra düğümünün IP adresidir.
    • 9042, Cassandra bağlantı noktasıdır.
    • Varsayılan kullanıcı cassandra'dır.
    • Varsayılan şifre cassandra'dır. Şifreyi daha önce değiştirdiyseniz mevcut şifreyi kullanın.
  2. Şifreyi güncellemek için cqlsh> isteminde aşağıdaki komutu çalıştırın:
    cqlsh> ALTER USER cassandra WITH PASSWORD 'NEW_PASSWORD';

    Yeni şifre tek tırnak karakteri içeriyorsa önüne tek tırnak karakteri ekleyerek çıkış yapın.
  3. cqlsh aracından çıkın:
    cqlsh> exit
  4. Yönetim Sunucusu düğümünde aşağıdaki komutu çalıştırın:
    > /opt/apigee/apigee-service/bin/apigee-service edge-management-server store_cassandra_credentials -u CASS_USERNAME -p CASS_PASSWORD

    İsteğe bağlı olarak, yeni kullanıcı adını ve şifreyi içeren bir dosyayı komuta iletebilirsiniz:
    > apigee-service edge-management-server store_cassandra_credentials -f configFile

    configFile şunları içerir:
    CASS_USERNAME=CASS_USERNAME
    CASS_PASSWORD=CASS_PASSWROD

    Bu komut, Yönetim Sunucusu'nu otomatik olarak yeniden başlatır.
  5. 4. adımı şuralarda tekrarlayın:
    • Tüm Mesaj İşlemcileri
    • Tüm Yönlendiriciler
    • Tüm Qpid sunucuları (edge-qpid-server)
    • Postgres sunucuları (edge-postgres-server)
  6. 4.16.05.04 ve sonraki sürümler için BaaS Stack düğümünde:
    1. Şifrelenmiş bir şifre oluşturmak için aşağıdaki komutu çalıştırın:
      > /opt/apigee/apigee-service/bin/apigee-service baas-usergrid secure_password

      Bu komut, düz metin şifreyi girmenizi ister ve şifrelenmiş şifreyi şu biçimde döndürür:
      SECURE:ae1b6dedbf6b26aaab8bee815a910737c1c15b55f3505c239e43bc09f8050
    2. /opt/apigee/customer/application/usergrid.properties dosyasında aşağıdaki jetonları ayarlayın. Böyle bir dosya yoksa oluşturun:
      usergrid-deployment_cassandra.username=cassandra
      usergrid-deployment_cassandra.password=SECURE:ae1b6dedbf6b26aaab8bee815a910737c1c15b55f3505c239e43bc09f8050

      Bu örnekte Cassandra için varsayılan kullanıcı adı kullanılmaktadır. Kullanıcı adını değiştirdiyseniz usergrid-deployment_cassandra.username değerini buna göre ayarlayın.

      Şifreye "SECURE:" ön ekini eklediğinizden emin olun. Aksi takdirde BaaS Stack, değeri şifrelenmemiş olarak yorumlar.

      Not: Her BaaS Stack düğümünün, şifreyi şifrelemek için kullanılan kendi benzersiz anahtarı vardır. Bu nedenle, şifrelenmiş değeri her BaaS Stack düğümünde ayrı ayrı oluşturmanız gerekir.
    3. usergrid.properties dosyasının sahipliğini "apigee" kullanıcısı olarak değiştirin:
      > chown apigee:apigee /opt/apigee/customer/application/usergrid.properties
    4. Stack düğümünü yapılandırın:
      > /opt/apigee/apigee-service/bin/apigee-service baas-usergrid configure
    5. BaaS yığınını yeniden başlatın:
      > /opt/apigee/apigee-service/bin/apigee-service baas-usergrid restart
    6. Bu adımları tüm BaaS Stack düğümleri için tekrarlayın.

Cassandra şifresi değiştirildi.

PostgreSQL şifresi sıfırlanıyor

Varsayılan olarak, PostgreSQL veritabanında tanımlanmış iki kullanıcı vardır: "postgres" ve "apigee". Her iki kullanıcının da varsayılan şifresi "postgres"tir. Varsayılan şifreyi değiştirmek için aşağıdaki prosedürü kullanın.

Tüm Postgres ana düğümlerinde şifreyi değiştirin. Ana/bekleme modunda yapılandırılmış iki Postgres sunucunuz varsa şifreyi yalnızca ana düğümde değiştirmeniz gerekir. Daha fazla bilgi için Postgres için ana-yedek replikasyonu ayarlama başlıklı makaleyi inceleyin.

  1. Ana Postgres düğümünde dizini /opt/apigee/apigee-postgresql/pgsql/bin olarak değiştirin.
  2. PostgreSQL "postgres" kullanıcı şifresini ayarlayın:
    1. Şu komutu kullanarak PostgreSQL veritabanına giriş yapın:
      > psql -h localhost -d apigee -U postgres
    2. İstendiğinde "postgres" kullanıcı şifresini "postgres" olarak girin.
    3. PostgreSQL komut isteminde, varsayılan şifreyi değiştirmek için aşağıdaki komutu girin:
      apigee=> ALTER USER postgres WITH PASSWORD 'apigee1234';
    4. Şu komutu kullanarak PostgreSQL veritabanından çıkın:
      apigee=> \q
  3. PostgreSQL "apigee" kullanıcı şifresini ayarlayın:
    1. Şu komutu kullanarak PostgreSQL veritabanına giriş yapın:
      > psql -h localhost -d apigee -U apigee
    2. İstendiğinde "apigee" kullanıcı şifresini "postgres" olarak girin.
    3. PostgreSQL komut isteminde, varsayılan şifreyi değiştirmek için aşağıdaki komutu girin:
      apigee=> ALTER USER apigee WITH PASSWORD 'apigee1234';
    4. Şu komutu kullanarak PostgreSQL veritabanından çıkın:
      apigee=> \q
  4. APIGEE_HOME'u ayarlayın:
    > export APIGEE_HOME=/opt/apigee/edge-postgres-server
  5. Yeni şifreyi şifreleyin:
    > sh /opt/apigee/edge-postgres-server/utils/scripts/utilities/passwordgen.sh apigee1234

    Bu komut, şifrelenmiş şifreyi aşağıda gösterildiği gibi döndürür. Şifrelenmiş şifre, ":" karakterinden sonra başlar ve ":" karakterini içermez.
    Encrypted string :WheaR8U4OeMEM11erxA3Cw==
  6. Yönetim Sunucusu düğümünü, "postgres" ve "apigee" kullanıcıları için yeni şifrelenmiş şifrelerle güncelleyin.
    1. Yönetim sunucusunda dizini /opt/apigee/customer/application olarak değiştirin.
    2. Aşağıdaki özellikleri ayarlamak için management-server.properties dosyasını düzenleyin. Bu dosya yoksa oluşturun:
      Not: Bazı özellikler şifrelenmiş "postgres" kullanıcı şifresini, bazıları ise şifrelenmiş "apigee" kullanıcı şifresini alır.
      • 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
    3. Dosyanın "apigee" kullanıcısına ait olduğundan emin olun:
      > chown apigee:apigee management-server.properties
  7. Tüm Postgres Server ve Qpid Server düğümlerini yeni şifrelenmiş şifreyle güncelleyin.
    1. Postgres Server veya Qpid Server düğümünde dizini /opt/apigee/customer/application olarak değiştirin.
    2. Aşağıdaki dosyaları düzenleyin. Bu dosyalar yoksa oluşturun:
      • postgres-server.properties
      • qpid-server.properties
    3. Dosyalara aşağıdaki özellikleri ekleyin:
      Not: Bu özelliklerin tümü, şifrelenmiş "postgres" kullanıcı şifresini alır.
      • 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
    4. Dosyaların "apigee" kullanıcısına ait olduğundan emin olun:
      > chown apigee:apigee postgres-server.properties
      > chown apigee:apigee qpid-server.properties
  8. Aşağıdaki bileşenleri şu sırayla yeniden başlatın:
    1. PostgreSQL veritabanı:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
    2. Qpid Sunucusu:
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
    3. Postgres Sunucusu:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart
    4. Yönetim Sunucusu:
      > /opt/apigee/apigee-service/bin/apigee-service edge-management-server restart