s3aclp - מקוון בענן

תָכְנִית:

שֵׁם

s3acl - הצג או תפעל את ה-ACL של דליים ופריטים של AWS S3

תַקצִיר

s3acl [אפשרויות] [[דלי|דלי/מפתח] ...]

אפשרויות:
--access-key מזהה מפתח גישה של AWS
--מפתח סודי של AWS מפתח גישה סודי
--קבל פלט את ה-ACL ל-STDOUT
--xml בצורת XML גולמית במקום טופס מנותח
--set שנה את ה-ACL
--clear הסר את כל המענקים מה-ACL
--add grant,grant,... הוסף מענקים ל-ACL
--del grant,grant,... הסר מענקים תואמים מה-ACL
--xml החל את ה-XML ACL מ-STDIN על הפריט
--acl-short cannedacl החל את ה-ACL ה"משומר" על הפריט
סביבה:
AWS_ACCESS_KEY_ID
AWS_ACCESS_KEY_SECRET

אפשרויות

- עזרה הדפס הודעת עזרה קצרה וצא.

--איש מדפיס את הדף הידני ויוצא.

--מִלוּלִי
פלט את הנעשה כפי שהוא נעשה.

--מפתח גישה ו --מפתח סודי
ציין את "מזהי מפתח גישה של AWS" עבור חשבון AWS. --מפתח גישה האם ה
"מזהה מפתח גישה", ו --מפתח סודי הוא "מפתח גישה סודי". אלו הם
למעשה את "שם המשתמש" וה"סיסמה" לחשבון AWS, ויש לשמור אותם
סוֹדִי.

יש לציין את מפתחות הגישה, או באמצעות פרמטרים אלה של שורת הפקודה, או
באמצעות AWS_ACCESS_KEY_ID ו AWS_ACCESS_KEY_SECRET משתני סביבה.

ציון אותם בשורת הפקודה עוקף את משתני הסביבה.

--לבטח
משתמש ב-SSL/TLS HTTPS כדי לתקשר עם שירות AWS, במקום HTTP.

--לקבל אחזר והצג את ה-ACL עבור כל דלי או פריט שצוינו.

--xml בשימוש עם ה --לקבל אפשרות, פלטים ל-Stdout של ה-XML הגולמי, במקום לנתח
פוּרמָט. ה-XML הגולמי הזה מתועד ב-"Amazon S3 Developer Guide".

אם צוין יותר מדלי או פריט אחד, ה-XML ACL עבור כל אחד מהם ייצא,
משורשרים יחד. זה כנראה לא מאוד שימושי.

ניתן להשתמש בפלט ה-XML הגולמי כקלט עבור --מַעֲרֶכֶת אפשרות, כך:

s3acl --get --xml bucketA | s3acl --set --xml bucketB bucketC

זה לא עובד כאשר מציינים יותר מדלי או פריט אחד ל- --לקבל
אפשרות, מכיוון שהשרשור של מספר רשימות גישה ל-XML אינו רשיון גישה ל-XML חוקי.

--מַעֲרֶכֶת במקום להציג את ה-ACL, שנה אותו. ניתן לשנות ACL על ידי שימוש
--ברור, --לְהוֹסִיף, ו --דל, או באמצעות --xml, או באמצעות --acl-קצר.

--ברור מסיר את כל המענקים מה-ACL. זה כולל גישה של הבעלים של
דלי או פריט. זה נעשה לפני ה --לְהוֹסִיף or --דל אפשרויות מיושמות, לא
משנה אילו אפשרויות סדר יצוינו בשורת הפקודה.

זה בדרך כלל מלווה ב- --לְהוֹסִיף אפשרות להוסיף כמה מענקים בחזרה לעכשיו
ACL ריק.

--דל הסר מענקים תואמים מה-ACL. זה נעשה לפני ה --לְהוֹסִיף האפשרות היא
מיושם, ללא קשר לאפשרויות הסדר שצוינו בשורת הפקודה.

המענקים מצוינים בצורה מפורחת, ולאחר מכן מצטרפים יחדיו באמצעות פסיקים עם no
רווח לבן.

יש הרחבה לפורמט ההענקה המנתח. אם מקבל המענק צוין כ
"כל", אז זה מתאים לכל מקבלי המענק ב-ACL. אם ההרשאה היא
צוין כ-"ANY", אז זה מתאים לכל הרשאה. לכן

s3acl --set --del ANY: קרא את mybucket

מסיר את כל ההענקות שנותנות הרשאת READ, וכן

s3acl --set --del someuserid:ANY mybucket

מסיר את כל ההענקות למשתמש someuserid

s3acl --set --del ANY:ANY mybucket

עושה את אותו הדבר כמו

s3acl --set --clear mybucket

עקב מגבלה בסמנטיקה של ה-API של S3, לא ניתן למחוק את א
מקבל מענק על ידי כתובת דואר אלקטרוני, רק על ידי מזהה קנוני.

--לְהוֹסִיף הוסף את המענקים שצוינו ל-ACL. מענקים מצוינים בצורה מנותחת, וכן
לאחר מכן מצורפים יחדיו על ידי פסיקים ללא רווח לבן.

אפשר להוסיף את אותו המענק לדלי או לפריט יותר מפעם אחת. זה
התנהגות מפתיעה של שירות S3.

--xml בעת שימוש עם --מַעֲרֶכֶת, ובמקום להשתמש ב-<--clear>, <--del>, ו --לְהוֹסִיף, לקרוא
XML ACL גולמי מ-STDIN, ולאחר מכן החל אותו על כל דלי או פריט נתון. זה יהיה
להחליף לחלוטין את ה-ACL הקיים עבור כל דלי או פריט נתון.

--acl-קצר
במקום להשתמש ב-<--clear>, <--del> ו- --לְהוֹסִיף, או באמצעות <--xml>, החל "שימורים
ACL" לכל דלי או פריט נתון. פעולה זו תחליף לחלוטין את הקיים
ACL עבור כל דלי או פריט נתון.

ה-ACL המשומרים הבאים מוגדרים כעת על ידי S3:

פְּרָטִי הבעלים מקבל "FULL_CONTROL". לאף אחד אחר אין זכויות גישה. זה
ברירת המחדל עבור דליים ופריטים חדשים שנוצרו.

לקרוא בציבור
הבעלים מקבל "FULL_CONTROL". המנהל האנונימי מקבל "READ"
גישה אליו.

ציבורי-קרא-כתוב
הבעלים מקבל "FULL_CONTROL".

למנהל האנונימי ניתנת גישת "READ" ו-"WRITE". זה
מדיניות שימושית להחלה על דלי, אם אתה מתכוון למשתמש אנונימי כלשהו
להכניס חפצים לתוך הדלי.

מאומת-קריאה
הבעלים מקבל "FULL_CONTROL" . כל מנהל מאומת כרשומה
למשתמש אמזון S3 ניתנת גישת "READ".

דלי or דלי/מפתח
שם דלי אחד או יותר או שמות דלי ומפתחות, מציינים פריט. כמה ש
אפשרי יעובד.

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

אם ניתנים שם דלי ומפתח, מופרדים באמצעות לוכסן, ה-ACL עבור מפתח זה
בדלי זה אוחזר או שונה.

אם שם דלי מתחיל במקף אחד או יותר, הוא עשוי להיחשב בטעות כ-a
אפשרות שורת הפקודה. אם זה המקרה, הפרד בין אפשרויות שורת הפקודה
שמות הדלי או הדלי/מפתחות עם שני מקפים, כך:

s3acl --get -- --bucketname/keyname

הסביבה וריאציות

AWS_ACCESS_KEY_ID ו AWS_ACCESS_KEY_SECRET
ציין את "מזהי מפתח גישה של AWS" עבור חשבון AWS. AWS_ACCESS_KEY_ID
מכיל את "מזהה מפתח גישה", ו AWS_ACCESS_KEY_SECRET מכיל את "הסוד
מפתח גישה". אלו הם למעשה "שם המשתמש" וה"סיסמה" ל-AWS
שירות, ויש לשמור על סודיות.

יש לציין את מפתחות הגישה, או באמצעות משתני סביבה אלה, או באמצעות
מה היא --מפתח גישה ו --מפתח סודי פרמטרי שורת הפקודה.

אם הפרמטרים של שורת הפקודה מוגדרים, הם עוקפים משתני סביבה אלה.

תְצוּרָה קובץ

אפשרויות התצורה ייקראו מהקובץ "~/.s3-tools"אם זה קיים. ה
הפורמט זהה לאפשרויות שורת הפקודה עם אפשרות אחת בכל שורה. לדוגמה, ה
הקובץ יכול להכיל:

--מפתח גישה
--מפתח סודי
--לבטח

קובץ תצורה לדוגמה זה יציין את מפתחות הגישה של AWS ואת זה מאובטח
יש להשתמש בחיבור באמצעות HTTPS עבור כל התקשורת.

תיאור

מאחזר ומוציא את רשימת בקרת הגישה (ACL) של דליים ושל פריטים בדליים
שירות האחסון הפשוט של אמזון (S3).

מנהלים
(חלק גדול מהטקסט הבא לקוח מ-"Amazon S3 Developer Guide (גרסת API
2006-03-01)".)

לכל דלי ופריט יש רשימת בקרת גישה (ACL). כאשר מתקבלת בקשה, S3
קובע את המנהל שמבצע את הבקשה, ולאחר מכן בודק את רשימת בקרת הגישה אל
לראות אם אותו מנהל מוסמך להגיש את הבקשה. אם ה-ACL מכיל ערך
בהסמכה לאותו מנהל להגיש בקשה זו, הבקשה רשאית להמשיך,
אחרת מוחזרת שגיאה.

מנהל יכול להיות מישהו עם חשבון AWS S3 שנכנס, או "אומת".
המנהל עשוי להיות היוצר והבעלים של הדלי או הפריט. או המנהלת
יכול להיות איזה דפדפן אינטרנט אנונימי שנמצא באינטרנט.

ACL is רצף of מענקים. A להעניק is 1 מקבל זכאות ו 1 רשות.
רשימת בקרת גישה היא רצף של מענקים. זה עשוי להכיל עד 100 מענקים. מענק
מורכבת ממקבל מענק אחד, שהוא תיאור של המנהל שיותר
גישה, והרשאה אחת, שהיא תיאור של מה שאותו מנהל רשאי לעשות
עם הדלי או הפריט הזה.

משתמש מקבל מענק
מקבל מענק משתמש חייב להיות רשום כלקוח של Amazon.com, אך אינו חייב להיות
רשום כלקוח AWS.

כאשר ACL נקרא, מקבל המענק המשתמש יוצג בפורמט קנוני, אשר
מורכב מ-64 תווי hex. החריג הוא אם מקבל המענק הוא הבעלים. אֲמָזוֹנָה
עדיין מאחסן ומחזיר את מקבל המענק בצורה קנונית, אבל הכלי הזה מציג אותו בתור
"בעלים".

קְבוּצָה מקבל מענק
הקבוצות היחידות הזמינות הן אלו שהוגדרו מראש על ידי S3. במהדורה הנוכחית של S3, אתה
לא יכול ליצור קבוצה משלך. יש כרגע שתי קבוצות מוגדרות מראש.

הראשון מיוצג על ידי המחרוזת "WORLD" על ידי כלי זה. כל המנהלים, בין אם הם
אנונימיים או מאומתים, נחשבים לחלק מקבוצה זו.

השני מיוצג על ידי המחרוזת "USERS" על ידי כלי זה. כל לא אנונימי
המנהל נחשב לחלק מהקבוצה. שימו לב שהרשאה ניתנת מכוח זה
המענק אינו גובר על שיקולי בקרת גישה אחרים. לדוגמה, אם משתמש הוא
רשומים ב-AWS, הם עשויים להיות חלק מקבוצה זו, אך אם הם לא נרשמו
S3, עדיין לא תינתן להם גישה.

יש גם קבוצת פסאודו מיוחדת עם המחרוזת "ANY". הוא משמש את --דל
אפשרות להתאים עם פריט ACL לבחירה למחיקה.

אם אמזון מעדכנת את S3 כדי להגדיר קבוצות נוספות לפני עדכון הכלי הזה, הם
יוצג כ-URI מוקף בסוגריים זווית.

בעלים
לכל דלי ופריט ב-S3 יש תכונת בעלים המשויכת אליו. הבעלים המשתמש
שיצר את הדלי או הפריט. הדרך היחידה לשנות את הבעלים של דלי היא למחוק
את הדלי וליצור אותו שוב תחת זהות משתמש שונה. הדרך היחידה לשנות את
הבעלים של פריט הוא להחליף את הפריט באמצעות זהות אחרת.

הבעלים של דלי או פריט כפוף למדיניות בקרת הגישה של אותו דלי או
פריט בדיוק כמו כולם, עם שני חריגים בולטים: הבעלים של משאב תמיד
יש לו את היכולת לקרוא ולכתוב את ה-ACL של אותו משאב, לא משנה מה המשויך
אומר ACL. לדוגמה, כבעלים של פריט, אתה יכול להסיר את עצמך מה-
רשימת בקרת גישה הקשורה, ומגלה שאינך יכול עוד לקרוא את נתוני הפריט ו
מטא נתונים. עם זאת, מתוקף היותך בעלים, תמיד יש לך את הזכות להעניק מחדש
לעצמך הרשאות לזה. מדיניות זו מונעת את המצב שבו פריט הופך
"תקוע", כשאף אחד לא יוכל לשנות או אפילו למחוק אותו.

הרשאות
ההרשאה במענק מתארת ​​את סוג הגישה שיש להעניק לאדם בהתאמה
מקבל מענק. ההרשאות הבאות נתמכות:

READ כאשר מוחל על דלי, זה מעניק הרשאה לרשום את הדלי. כאשר מיושם
לפריט, זה מעניק הרשאה לקרוא את נתוני הפריט ו/או המטא נתונים.

WRITE כאשר מוחל על דלי, זה מעניק הרשאה ליצור, להחליף ולמחוק
כל פריט בדלי. הרשאה זו אינה נתמכת עבור פריטים (היא שמורה
לשימוש עתידי).

READ_ACP
מעניק הרשאה לקרוא את מדיניות בקרת הגישה (ACL ובעלים) עבור
דלי או פריט רלוונטיים. לבעלים של דלי או פריט יש את זה תמיד
רשות באופן מרומז.

WRITE_ACP
מעניק הרשאה להחליף את ה-ACP עבור הדלי או הפריט הרלוונטי. ה
לבעלים של דלי או פריט יש תמיד הרשאה זו באופן מרומז. ציין זאת
הענקת הרשאה זו שווה ערך למתן FULL_CONTROL, מכיוון שההענקה
הנמען יכול כעת לבצע כל שינוי ב-ACP שהוא או היא אוהבים!

שליטה מלאה
הרשאה זו היא קיצור של האיחוד של READ, WRITE, READ_ACP ו
הרשאות WRITE_ACP. הוא אינו מקנה זכויות נוספות, והוא ניתן בלבד
לנוחות. זה כנראה לא חכם לתת את ההרשאה הזו ל-WORLD.

ANY זו לא באמת הרשאה, אלא משמשת את --דל אוֹפְּצִיָה. זה מתאים לכל
הרשאה לבחור מענק למחיקה.

בְּרִירַת מֶחדָל ACL
אם לא מסופק ACL בזמן יצירת דלי או פריט נכתב, אז כברירת מחדל
נוצר ACL. ברירת המחדל של ACL למשאבים חדשים מורכבת ממענק יחיד שנותן
הבעלים של המשאב (כלומר המנהל המגיש את הבקשה ליצור את הדלי או
כדי לכתוב את הפריט) הרשאת FULL_CONTROL. שים לב שאם אתה מחליף פריט קיים,
ה-ACL עבור הפריט הקיים תמיד מוחלף גם כן, ומוגדר כברירת מחדל בחזרה
OWNER:FULL_CONTROL אם לא מסופק ACL מפורש.

חי XML ACL פוּרמָט
פורמט XML ACL מתועד ב-"Amazon S3 Developer Guide".

מנותח ACL פוּרמָט
כלי זה מנתח את פורמט XML ACL הגולמי לצורה קריא יותר.

ACL מנותח מורכב ממספר שורות. הערות הן שורות שמתחילות ב-hash
אופי. שורות שאינן הערות הן מענקים.

עבור דליים, ההערות נותנות את שם הדלי ואת מחרוזת המשתמש הקנונית של אמזון עבור
הבעלים.

עבור פריטים, ההערות מספקות את שם הדלי, מפתח הפריט והמשתמש הקנוני של אמזון
מחרוזת לבעלים.

מענק הוא מחרוזת מקבל ומחרוזת הרשאות, מופרדות עם תו נקודתיים. א
מקבל המענק יכול להיות אחת מהמחרוזות "OWNER", "WORLD" או "USERS", או URI עטוף בזווית
סוגריים בסוגריים, או כתובת האימייל של משתמש אמזון, או מחרוזת משתמש קנונית של אמזון, אשר
הוא בן 64 תווי hex. הרשאה היא אחת מהמחרוזות "READ", "WRITE", "READ_ACP",
"WRITE_ACP", או "FULL_CONTROL".

דוגמה $ ./s3getacl
# דלי: דוגמה
# owner: 5a1568e09392dad4b4ceb54f29f0a64d651a531350d6f720fbd2367eed995f08
בעלים:FULL_CONTROL
a00490decea9d0ad76e5ef8b450b3efa63861adccfb9197cfb42f837eb222df2:WRITE
משתמשים: קרא
העולם: קרא
$ ./s3getacl example/thingee
# דלי: דוגמה
פריט אחד: thingee
# owner: 5a1568e09392dad4b4ceb54f29f0a64d651a531350d6f720fbd2367eed995f08
בעלים:FULL_CONTROL
$ _

השתמש ב-s3aclp באינטרנט באמצעות שירותי onworks.net