فعال کردن اصالت‌سنجی Cassandra

Edge for Private Cloud نسخه ۴.۱۶.۰۵

به‌طور پیش‌فرض، Cassandra بدون فعال بودن احراز هویت نصب می‌شود. این یعنی هر کسی می‌تواند به Cassandra دسترسی داشته باشد. می‌توانید اصالت‌سنجی را پس‌از نصب Edge یا به‌عنوان بخشی از فرایند نصب فعال کنید.

اگر تصمیم بگیرید اصالت‌سنجی را در Cassandra فعال کنید، از اطلاعات اعتباری پیش‌فرض زیر استفاده می‌کند:

• username = 'cassandra'
• گذرواژه = 'cassandra'

می‌توانید از این حساب استفاده کنید، گذرواژه دیگری برای این حساب تنظیم کنید، یا کاربر Cassandra جدیدی ایجاد کنید. بااستفاده از دستورات Cassandra CREATE/ALTER/DROP USER، کاربران را اضافه، حذف، و اصلاح کنید.

برای کسب اطلاعات بیشتر، http://www.datastax.com/documentation/cql/3.0/cql/cql_reference/cqlCommandsTOC.html را ببینید.

فعال کردن اصالت‌سنجی Cassandra درطول نصب

می‌توانید اصالت‌سنجی Cassandra را در زمان نصب فعال کنید. بااین‌حال، اگرچه می‌توانید هنگام نصب Cassandra اصالت‌سنجی را فعال کنید، نمی‌توانید نام کاربری و گذرواژه پیش‌فرض را تغییر دهید. پس‌از تکمیل نصب Cassandra، باید آن مرحله را به‌صورت دستی انجام دهید.

توجه: از این روش هنگام نصب Cassandra بااستفاده از گزینه‌های «-p c»، «-p ds»، «-p sa»، «-p aio»، «-p asa»، و «-p ebp» استفاده کنید.

برای فعال کردن اصالت‌سنجی Cassandra در زمان نصب، دارایی CASS_AUTH را در فایل پیکربندی برای همه گره‌های Cassandra اضافه کنید:

CASS_AUTH=y # The default value is n.

عناصر Edge زیر به Cassandra دسترسی دارند:

• سرور مدیریت
• پردازنده‌های پیام
• رهیاب
• سرورهای Qpid
• سرورهای Postgres
• پشته BaaS

بنابراین، هنگام نصب این عناصر، باید ویژگی‌های زیر را در فایل پیکربندی تنظیم کنید تا اعتبارنامه‌های Cassandra را مشخص کنید:

CASS_USERNAME=cassandra 
CASS_PASSWORD=cassandra

پس‌از نصب Cassandra می‌توانید اطلاعات اعتباری Cassandra را تغییر دهید. بااین‌حال، اگر قبلاً «سرور مدیریت»، «پردازشگرهای پیام»، «مسیریاب‌ها»، سرورهای Qpid، سرورهای Postgres، یا «پشته BaaS» را نصب کرده‌اید، باید آن مؤلفه‌ها را نیز به‌روز کنید تا از اطلاعات اعتباری جدید استفاده کنند.

برای تغییر دادن اطلاعات اعتباری Cassandra پس‌از نصب Cassandra:

1. بااستفاده از ابزار cqlsh و اعتبارنامه‌های پیش‌فرض، به سیستم هریک از گره‌های Cassandra وارد شوید. فقط باید گذرواژه را در یک گره تغییر دهید و این گذرواژه به همه گره‌های Cassandra در حلقه همه‌فرستی خواهد شد:
   > /opt/apigee/apigee-cassandra/bin/cqlsh cassIP 9042 -u cassandra -p cassandra
   در اینجا:
   1. cassIP نشانی IP گره Cassandra است.
   2. 9042 درگاه پیش‌فرض Cassandra است.
   3. کاربر پیش‌فرض cassandra است.
   4. گذرواژه پیش‌فرض cassandra است. اگر قبلاً گذرواژه را تغییر داده‌اید، از گذرواژه فعلی استفاده کنید.
2. فرمان زیر را در پیام‌واره cqlsh> اجرا کنید تا گذرواژه را به‌روز کنید:
   cqlsh> ALTER USER cassandra WITH PASSWORD 'NEW_PASSWORD';
3. خروج از ابزار cqlsh:
   cqlsh> exit
4. اگر هنوز «سرور مدیریت»، «پردازشگر پیام»، «مسیریاب»، «سرورهای Qpid»، «سرورهای Postgres»، یا «پشته BaaS» را نصب نکرده‌اید، دارایی‌های زیر را در فایل پیکربندی تنظیم کنید و سپس این عناصر را نصب کنید:
   CASS_USERNAME=cassandra
   CASS_PASSWORD=NEW_PASSWORD
5. اگر قبلاً «سرور مدیریت»، «پردازشگرهای پیام»، «مسیریاب‌ها»، سرورهای Qpid، سرورهای Postgres، یا «پشته BaaS» را نصب کرده‌اید، برای اطلاع از رویه به‌روزرسانی این عناصر برای استفاده از گذرواژه جدید، به بازنشانی گذرواژه‌های Edge مراجعه کنید.

فعال کردن اصالت‌سنجی Cassandra پس‌از نصب

برای فعال کردن اصالت‌سنجی:

• همه عناصر Edge را که به Cassandra متصل می‌شوند با نام کاربری و گذرواژه Cassandra به‌روز کنید.
• در همه گره‌های Cassandra، اصالت‌سنجی را فعال کنید.
• نام کاربری و گذرواژه Cassandra را در هریک از گره‌ها تنظیم کنید. فقط باید اطلاعات اعتباری را در یک گره Cassandra تغییر دهید و این اطلاعات به همه گره‌های Cassandra در حلقه پخش خواهد شد.

از روش زیر برای به‌روزرسانی همه عناصر Edge که با Cassandra با اطلاعات اعتباری جدید ارتباط برقرار می‌کنند استفاده کنید. توجه داشته باشید که این مرحله را قبل‌از اینکه واقعاً اطلاعات اعتباری Cassandra را به‌روز کنید انجام می‌دهید:

1. در گره «سرور مدیریت»، دستور زیر را اجرا کنید:
   > /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=cassandra
   CASS_PASSWORD=CASS_PASSWROD
   
   این دستور به‌طور خودکار «سرور مدیریت» را بازراه‌اندازی می‌کند.
2. مرحله ۱ را در موارد زیر تکرار کنید:
   • همه پردازنده‌های پیام
   • همه رهیاب‌ها
   • همه سرورهای Qpid (edge-qpid-server)
   • سرورهای Postgres (edge-postgres-server)
3. در گره BaaS Stack برای نسخه ۴.۱۶.۰۵.۰۴ و نسخه‌های جدیدتر:
   1. برای تولید گذرواژه رمزگذاری‌شده، فرمان زیر را اجرا کنید:
      > /opt/apigee/apigee-service/bin/apigee-service baas-usergrid secure_password
      
      این فرمان از شما گذرواژه نوشتار ساده را می‌خواهد و گذرواژه رمزگذاری‌شده را در قالب زیر برمی‌گرداند:
      SECURE:ae1b6dedbf6b26aaab8bee815a910737c1c15b55f3505c239e43bc09f8050
   2. نشانه‌های زیر را در /opt/apigee/customer/application/usergrid.properties تنظیم کنید. اگر این فایل وجود ندارد، آن را ایجاد کنید:
      usergrid-deployment_cassandra.username=cassandra
      usergrid-deployment_cassandra.password=SECURE:ae1b6dedbf6b26aaab8bee815a910737c1c15b55f3505c239e43bc09f8050
      
      این مثال از نام کاربری پیش‌فرض برای Cassandra استفاده می‌کند. اگر نام کاربری را تغییر دادید، مقدار usergrid-deployment_cassandra.username را متناسب با آن تنظیم کنید.
      
      مطمئن شوید که پیشوند «SECURE:» را در گذرواژه قرار دهید. درغیراین‌صورت، BaaS Stack مقدار را به‌عنوان رمزگذاری‌نشده تفسیر می‌کند.
      
      توجه: هر گره «پشته BaaS» کلید منحصربه‌فرد خود را دارد که برای رمزگذاری گذرواژه استفاده می‌شود. بنابراین، باید مقدار رمزگذاری‌شده را در هر گره BaaS Stack به‌صورت جداگانه تولید کنید.
   3. مالکیت فایل usergrid.properties را به کاربر «apigee» تغییر دهید:
      > chown apigee:apigee /opt/apigee/customer/application/usergrid.properties
   4. پیکربندی گره «پشته»:
      > /<inst_root>/apigee/apigee-service/bin/apigee-service baas-usergrid configure
   5. بازراه‌اندازی پشته BaaS:
      > /<inst_root>/apigee/apigee-service/bin/apigee-service baas-usergrid restart
   6. این مراحل را برای همه گره‌های BaaS Stack تکرار کنید.

از روش زیر برای فعال کردن اصالت‌سنجی Cassandra و تنظیم نام کاربری و گذرواژه استفاده کنید:

1. به سیستم اولین گره Cassandra وارد شوید.
2. فرمان زیر را اجرا کنید:

   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra
     enable_cassandra_authentication -e y

   این فرمان اصالت‌سنجی را فعال می‌کند و Cassandra را بازراه‌اندازی می‌کند.

3. مراحل ۱ و ۲ را در همه گره‌های Cassandra تکرار کنید.
4. بااستفاده از ابزار cqlsh و اعتبارنامه‌های پیش‌فرض، به سیستم یکی از گره‌های Cassandra وارد شوید. فقط باید گذرواژه را در یک گره Cassandra تغییر دهید و این گذرواژه به همه گره‌های Cassandra در حلقه پخش خواهد شد:

   /opt/apigee/apigee-cassandra/bin/cqlsh cassIP 9042 -u cassandra -p cassandra

   مکان

   • ‫cassIP نشانی IP گره Cassandra است.
   • ‫9042 درگاه Cassandra است.
   • کاربر پیش‌فرض cassandra است.
   • گذرواژه پیش‌فرض cassandra است. اگر قبلاً گذرواژه را تغییر داده‌اید، از گذرواژه فعلی استفاده کنید.
5. فرمان زیر را در پیام‌واره cqlsh> اجرا کنید تا گذرواژه را به‌روز کنید:

   ALTER USER cassandra WITH PASSWORD 'NEW_PASSWORD';

6. فرمان زیر را در پیام‌واره cqlsh> اجرا کنید تا مطمئن شوید فضای کلید همیشه دردسترس است. برای یک مرکز داده:

   ALTER KEYSPACE system_auth WITH replication = {'class': 'NetworkTopologyStrategy', 'dc-1': '3'};

   برای دو مرکز داده:

   ALTER KEYSPACE system_auth WITH replication = {'class': 'NetworkTopologyStrategy', 'dc-1': '3', 'dc-2': '3'};

7. خارج شدن از ابزار cqlsh:

   exit

8. برای اطمینان از اینکه تغییر به همه گره‌های Cassandra منتقل شده است، nodetool repair را اجرا کنید:

   /opt/apigee/apigee-cassandra/bin/nodetool repair system_auth