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

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

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

  • username = 'cassandra'
  • password = 'cassandra'

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

برای اطلاعات بیشتر، فرمان‌های پوسته Cassandra SQL را ببینید.

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

می‌توانید اصالت‌سنجی Cassandra را در زمان نصب فعال کنید. بااین‌حال، اگرچه می‌توانید هنگام نصب Cassandra اصالت‌سنجی را فعال کنید، اما همیشه باید از نام کاربری و گذرواژه پیش‌فرض cassandra (‘cassandra’:’cassandra’) درطول نصب استفاده کنید. اگر می‌خواهید از اطلاعات اعتباری غیرپیش‌فرض Cassandra استفاده کنید، باید پس‌از نصب، با دنبال کردن مراحل فهرست‌شده در اینجا، اصالت‌سنجی Cassandra را دوباره فعال کنید.

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

CASS_AUTH=y
CASS_USERNAME=cassandra
CASS_PASSWORD=cassandra

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

پس‌از تکمیل نصب اولیه، می‌توانید یک یا چند مورد از مراحل زیر را دنبال کنید:

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

اجزای Edge که به Cassandra متصل می‌شوند

مؤلفه‌های Edge زیر به Cassandra دسترسی دارند:

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

نصب مؤلفه‌های Edge وقتی اصالت‌سنجی Cassandra فعال است

اگر هنگام نصب این مؤلفه‌های Edge برای اولین‌بار، اصالت‌سنجی Cassandra را فعال کرده‌اید، باید تنظیمات زیر را در فایل پیکربندی بی‌صدا ارائه دهید:

CASS_AUTH=Y
CASS_USERNAME=<valid username in Cassandra>
CASS_PASSWORD=<password for the above username>

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

به‌روزرسانی مؤلفه‌های Edge که به Cassandra متصل می‌شوند

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

  1. در گره «سرور مدیریت»، فرمان زیر را اجرا کنید: 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-server store_cassandra_credentials -u cassandra_username -p cassandra_password

    درصورت تمایل، می‌توانید فایلی حاوی نام کاربری و گذرواژه جدید را به فرمان ارسال کنید:

    apigee-service edge-management-server store_cassandra_credentials  -f configFile

    که configFile حاوی موارد زیر است:

    CASS_USERNAME=cassandra_username # Default is cassandra
CASS_PASSWORD='cassandra_password' # Default is cassandra; wrap in single quotes if it includes special characters.

    این فرمان «سرور مدیریت» را به‌طور خودکار بازراه‌اندازی می‌کند.

  2. مرحله ۱ را برای هریک از سرویس‌های زیر تکرار کنید:
    • همه پردازشگرهای پیام
    • همه رهیاب‌ها
    • همه سرورهای Qpid‏ (edge-qpid-server)
    • سرورهای Postgres‏ (edge-postgres-server)

    وقتی مرحله ۱ را برای هر سرویس تکرار می‌کنید، edge-management-server را در فرمان بالا با نام سرویس مناسب جایگزین کنید. برای مثال، وقتی مرحله را برای سرویس «مسیریاب» اجرا می‌کنید، از فرمان زیر استفاده کنید:

    /opt/apigee/apigee-service/bin/apigee-service edge-router store_cassandra_credentials -u cassandra -p cassandra

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

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

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

    برای راه‌اندازی Apigee مبتنی بر یک مرکز داده که Cassandra ازقبل در آن نصب شده است، می‌توانید:

    توجه: کاربر «Cassandra» کاربر ویژه‌ای در Cassandra است. اصالت‌سنجی بااستفاده از این کاربر به سازگاری QUORUM نیاز دارد. ببینید درباره سطوح سازگاری Cassandra.

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

    هنگام گسترش مرکز داده، مراحل یکی از سناریوهای زیر را دنبال کنید، بسته به اینکه کدام‌یک با راه‌اندازی شما مطابقت دارد.

    سناریو ۱: مرکز داده موجود، اصالت‌سنجی Cassandra را فعال کرده است

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

    1. مرکز داده جدیدی را با اعتبارنامه پیش‌فرض Cassandra:Cassandra و CASS_AUTH=y راه‌اندازی کنید. بخش فعال کردن اصالت‌سنجی Cassandra برای اولین‌بار را ببینید.
    2. مؤلفه‌های Edge را در مرکز داده جدید بااستفاده از اعتبارنامه‌های پیش‌فرض Cassandra نصب کنید.

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

    1. Set up a new data center with default Cassandra:Cassandra credentials & CASS_AUTH=y. بخش فعال کردن اصالت‌سنجی Cassandra برای اولین‌بار را ببینید.
    2. مراحل فعال کردن اصالت‌سنجی Cassandra برای اولین‌بار را دنبال کنید تا از اعتبارنامه مرکز داده موجود مجدداً استفاده کنید (اگر مرکز داده موجود از اعتبارنامه غیرپیش‌فرض استفاده می‌کند).
    3. مؤلفه‌های Edge را در مرکز داده جدید بااستفاده از اطلاعات کاربری غیرپیش‌فرض Cassandra نصب کنید.

    سناریو ۲: مرکز داده موجود، اصالت‌سنجی Cassandra را فعال نکرده است

    اگر اصالت‌سنجی cassandra فعال نیست، مراحل زیر را انجام دهید:

    1. مرکز داده جدیدی بدون اصالت‌سنجی Cassandra راه‌اندازی کنید.
    2. مراحل فعال کردن اصالت‌سنجی Cassandra برای اولین‌بار را دنبال کنید تا اصالت‌سنجی Cassandra در سراسر خوشه (پس‌از گسترش) فعال شود.
    3. مؤلفه‌های Edge را که به Cassandra متصل می‌شوند با دنبال کردن مراحل اینجا به‌روز کنید.

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

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

    1. فایل پیکربندی بی‌صدا با محتوای نشان‌داده‌شده در زیر ایجاد کنید: 
      # Specify IP address or DNS name of cassandra node
IP1=192.168.1.1
IP2=192.168.1.2
IP3=192.168.1.3

# Must resolve to IP address or DNS name of host
HOSTIP=$(hostname -i)

# Set to ‘y’ to enable Cassandra authentication.
CASS_AUTH=y # Possible values are ‘y/n’

# Cassandra username. If it does not exist, this user would be created as a SUPERUSER
CASS_USERNAME=cassandra # Default value is cassandra
# Cassandra Password. If CASS_USERNAME does not exist, create SUPERUSER with this as password
CASS_PASSWORD=cassandra # Default value is cassandra

# Space-separated IP/DNS names of the Cassandra hosts
CASS_HOSTS="$IP1:1,1 $IP2:1,1 $IP3:1,1"

# Username of an existing C* user. Only needed if you have disabled or change details of the default cassandra user(‘cassandra’)
CASS_EXISTING_USERNAME=cassandra  # The default username is cassandra
# Password of an existing C* user. Only needed if you have disabled or change password of the default cassandra user(‘cassandra’)
CASS_EXISTING_PASSWORD=cassandra  # The default password is cassandra

# Cassandra port
CASS_PORT=9042 # The default port is 9042.
    2. به سیستم اولین گره Cassandra وارد شوید و فرمان زیر را اجرا کنید: 
      apigee-service apigee-cassandra enable_cassandra_authentication -f CONFIG

      درصورت تمایل، می‌توانید ویژگی‌ها را به‌عنوان متغیرهای مستقل فرمان به اسکریپت ارسال کنید، همان‌طور که در مثال زیر نشان داده شده است:

      CASS_AUTH=y HOSTIP=$(hostname -i) CASS_PORT=9042 CASS_EXISTING_USERNAME=cassandra CASS_EXISTING_PASSWORD=cassandra CASS_USERNAME=cassandra CASS_PASSWORD=cassandra  CASS_HOSTS="192.168.1.1:1,1 192.168.1.2:1,1 192.168.1.3:1,1" apigee-service apigee-cassandra enable_cassandra_authentication

      نکته‌ها:

      • برای اطلاعات اعتباری پیش‌فرض Cassandra، فرمان بالا اصالت‌سنجی Cassandra را فعال می‌کند و Cassandra را بازراه‌اندازی می‌کند.
      • برای اطلاعات اعتباری غیرپیش‌فرض، این فرمان همچنین عامل تکرار را تغییر می‌دهد، کاربر ممتاز ایجاد می‌کند، و تعمیر را در فضای کلید system_auth اجرا می‌کند.
    3. مراحل ۱ و ۲ را برای همه گره‌های Cassandra یکی‌یکی تکرار کنید.

    تغییر اعتبارنامه Cassandra پس‌از نصب Cassandra

    برای تغییر اطلاعات کاربری 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> اجرا کنید تا گذرواژه به‌روز شود: 
      ALTER USER cassandra WITH PASSWORD 'NEW_PASSWORD';
    3. از ابزار cqlsh خارج شوید، همان‌طور که در مثال زیر نشان داده شده است: 
      exit
    4. اگر هنوز «سرور مدیریت»، «پردازشگرهای پیام»، «مسیریاب‌ها»، سرورهای Qpid، یا سرورهای Postgres را نصب نکرده‌اید، ویژگی‌های زیر را در فایل پیکربندی تنظیم کنید و سپس آن مؤلفه‌ها را نصب کنید: 
      CASS_USERNAME=cassandra
CASS_PASSWORD=NEW_PASSWORD
    5. اگر قبلاً Management Server،‏ Message Processors،‏ Routers،‏ Qpid servers، یا Postgres servers را نصب کرده‌اید، برای اطلاع از روش به‌روزرسانی این مؤلفه‌ها برای استفاده از گذرواژه جدید، به بازنشانی گذرواژه‌های Edge مراجعه کنید.