הוספת רשומת ACL ל-ACL של Managed Kafka

במאמר הזה מוסבר איך ליצור רשומת ACL ולהוסיף אותה למשאב ACL מנוהל של Kafka. אם משאב ה-ACL של Managed Kafka לא קיים, הפעולה הזו יוצרת גם את משאב ה-ACL.

הפעולה הזו דומה ליצירת קשירה אחת של רשימת ACL ב-Apache Kafka. בניגוד לפעולת העדכון, לא נדרש ETag לבקרה על מקביליות.

תפקידים והרשאות נדרשים

כדי לקבל את ההרשאה שנדרשת להוספת רשומה לרשימת ACL, צריך לבקש מהאדמין להקצות לכם את תפקיד ה-IAM ‏Managed Kafka ACL Editor (roles/managedkafka.aclEditor) בפרויקט. כדי לקרוא הסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

התפקיד המוגדר מראש הזה כולל את ההרשאה managedkafka.acls.updateEntries, שנדרשת כדי להוסיף רשומת ACL.

יכול להיות שתוכלו לקבל את ההרשאה הזו גם בתפקידים בהתאמה אישית או בתפקידים מוגדרים מראש.

הוספת רשומה ב-ACL

המסוף

  1. נכנסים לדף Clusters במסוף Google Cloud .

    מעבר אל Clusters

  2. לוחצים על שם האשכול שרוצים להוסיף לו רשומה של ACL.

  3. לוחצים על הכרטיסייה בקרת גישה.

  4. לוחצים על Create ACL entry (יצירת רשומה ב-ACL).

  5. בחלונית Create ACL entry (יצירת רשומה ב-ACL), מזינים את פרטי הרשומה ב-ACL:

    1. ברשימה Resource type, בוחרים את סוג משאב האשכול שה-ACL הזה חל עליו. מידע נוסף זמין במאמר בנושא מזהה ACL.

    2. אם סוג המשאב הוא Topic,‏ Consumer group או Transactional ID, בוחרים או מזינים את מזהה המשאב.

    3. אם סוג המשאב הוא Topic prefix, Consumer group prefix או Transactional ID prefix, מזינים את הקידומת של רשימת ה-ACL שתתאים.

    4. בשדה Principal, מזינים את חשבון המשתמש של רשומת ה-ACL.

    5. ברשימה Permission type (סוג הרשאה), בוחרים באפשרות ALLOW או DENY.

    6. ברשימה Operation בוחרים את סוג הפעולה של רשומת ה-ACL.

  6. לוחצים על יצירה.

gcloud

מריצים את הפקודה gcloud managed-kafka acls add-acl-entry:

gcloud managed-kafka acls add-acl-entry ACL_ID \
  --cluster=CLUSTER_ID \
  --location=LOCATION \
  --principal=PRINCIPAL \
  --operation=OPERATION \
  --permission-type=PERMISSION_TYPE \
  --host=*

מחליפים את מה שכתוב בשדות הבאים:

  • ‫ACL_ID. המזהה של משאב ה-ACL של Managed Kafka שרוצים לעדכן. מידע נוסף זמין במאמר בנושא מזהה ACL. אם לא קיים ACL מנוהל של Kafka עם המזהה הזה, המערכת תיצור אותו באופן אוטומטי.

  • ‫CLUSTER_ID: המזהה של אשכול Kafka.

  • ‫LOCATION: האזור של אשכול Kafka.

  • ‫PRINCIPAL: הגורם הראשי של רשומת ה-ACL החדשה.

  • ‫OPERATION: סוג הפעולה, למשל READ או CREATE.

  • ‫PERMISSION_TYPE: ההרשאה שיש לחשבון הראשי לפעולה. צריך לציין ALLOW או DENY.

פקודה לדוגמה

מריצים את הפקודה הבאה כדי לאפשר לחשבון שירות ספציפי לקרוא מנושא בשם test-topic באשכול test-cluster באזור us-central1.

gcloud managed-kafka acls add-acl-entry topic/test-topic \
  --cluster=test-cluster \
  --location=us-central1 \
  --principal='User:service-account@test-project.iam.gserviceaccount.com' \
  --operation=READ \
  --permission-type=ALLOW \
  --host='*'

זו דוגמה לפלט:

acl:
  aclEntries:
  - host: '*'
    operation: READ
    permissionType: ALLOW
    principal: 'User:service-account@test-project.iam.gserviceaccount.com'
  etag: W/another-new-etag
  name: projects/test-project/locations/us-central1/clusters/test-cluster/acls/topic/test-topic
  patternType: LITERAL
  resourceName: test-topic
  resourceType: TOPIC
aclCreated: false

הפלט של הפקודה add-acl-entry מספק מידע על מצב ה-ACL שמתקבל:

  • ‫acl: בקטע הזה מתואר משאב ה-ACL המעודכן אחרי שהערך החדש נוסף.

    • ‫aclEntries: רשימה שמכילה את כל הרשומות של בקרת הגישה עבור רשימת בקרת הגישה הזו. בדוגמה הזו, הוא יכלול עכשיו את הרשומה שנוספה. כל רשומה כוללת את השדות הבאים:

      • ‫host: המארח של רשומת ה-ACL.
      • ‫operation: פעולת Kafka שהרשומה הזו חלה עליה.
      • ‫permissionType: האם הגישה היא ALLOW או DENY.
      • ‫principal: המשתמש או חשבון השירות שאליהם מתייחסת הרשומה הזו.
    • ‫etag: תג הישות של רשימת ה-ACL המעודכנת. הוא משמש לבקרת בו-זמניות אופטימית במהלך עדכונים עתידיים. הערך משתנה אחרי שמוסיפים רשומה.

    • ‫name: המזהה הייחודי של משאב ה-ACL. הפורמט הוא projects/{project}/locations/{location}/clusters/{cluster}/acls/{acl_id}.

    • ‫patternType: סוג תבנית המשאב של רשימת ה-ACL הזו.

    • ‫resourceName: השם של משאב Kafka שאליו חלה רשימת בקרת הגישה הזו.

    • ‫resourceType: סוג משאב Kafka.

  • ‫aclCreated: ערך בוליאני שמציין אם משאב ה-ACL נוצר כתוצאה מהוספת הרשומה הזו.

המאמרים הבאים

‫Apache Kafka®‎ הוא סימן מסחרי רשום של The Apache Software Foundation או של השותפים העצמאיים שלה בארצות הברית או במדינות אחרות.