במאמר הזה מוסבר איך ליצור רשומת 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
המסוף
נכנסים לדף Clusters במסוף Google Cloud .
לוחצים על שם האשכול שרוצים להוסיף לו רשומה של ACL.
לוחצים על הכרטיסייה בקרת גישה.
לוחצים על Create ACL entry (יצירת רשומה ב-ACL).
בחלונית Create ACL entry (יצירת רשומה ב-ACL), מזינים את פרטי הרשומה ב-ACL:
ברשימה Resource type, בוחרים את סוג משאב האשכול שה-ACL הזה חל עליו. מידע נוסף זמין במאמר בנושא מזהה ACL.
אם סוג המשאב הוא
Topic,Consumer groupאוTransactional ID, בוחרים או מזינים את מזהה המשאב.אם סוג המשאב הוא
Topic prefix,Consumer group prefixאוTransactional ID prefix, מזינים את הקידומת של רשימת ה-ACL שתתאים.בשדה Principal, מזינים את חשבון המשתמש של רשומת ה-ACL.
ברשימה Permission type (סוג הרשאה), בוחרים באפשרות
ALLOWאוDENY.ברשימה Operation בוחרים את סוג הפעולה של רשומת ה-ACL.
לוחצים על יצירה.
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 נוצר כתוצאה מהוספת הרשומה הזו.