अपनी टीम से एक AWS S3 bucket कनेक्ट करें - (Team web app)

S3 Bucket Storage क्या करता है

अपना खुद का Amazon Web Services (AWS) S3 bucket कनेक्ट करें ताकि टीम के सदस्य इससे geospatial फाइलें लोड कर सकें और इसमें मैप्स सेव कर सकें। फाइलें आपके bucket में ही रहती हैं। केवल owners और admins ही इसे सेटअप कर सकते हैं।

आप इस पेज को टीम पोर्टल के S3 Bucket सेक्शन से खोलते हैं।

bucket के विवरण दर्ज करें

1. Bucket Name (आवश्यक)। आपके S3 bucket का नाम।
2. Region (आवश्यक)। वह AWS region चुनें जहाँ आपका bucket स्थित है।
3. Folder Prefix (वैकल्पिक)। सभी ScribbleMaps फाइलों के लिए एक प्रीफिक्स या फ़ोल्डर, जैसे कि maps/ या data/।

एक ऑथेंटिकेशन (authentication) विधि चुनें

चुनें कि ScribbleMaps आपके bucket में कैसे साइन इन करता है।

IAM Role (अनुशंसित)

IAM Role, AWS STS के माध्यम से अस्थायी क्रेडेंशियल्स का उपयोग करता है। प्रबंधित करने के लिए कोई स्टैटिक कीज़ (static keys) नहीं हैं, इसलिए यह अधिक सुरक्षित है।

1. कॉपी बटन के साथ External ID कॉपी करें। आपको रोल की ट्रस्ट पॉलिसी (trust policy) के लिए इसकी आवश्यकता होगी।
2. पूरे चरणों के लिए Setup Instructions पर क्लिक करें। संक्षेप में: - AWS IAM Console में, एक रोल बनाएं और ट्रस्टेड एंटिटी (trusted entity) के रूप में Another AWS account चुनें। - निर्देशों में दिखाए गए ScribbleMaps AWS Account ID को दर्ज करें। - Require external ID को चेक करें और इस पेज से External ID पेस्ट करें। - एक पॉलिसी अटैच करें जो आपके bucket पर s3:GetObject, s3:PutObject, s3:DeleteObject, और s3:ListBucket की अनुमति देती हो।
3. रोल के ARN को Role ARN फ़ील्ड में पेस्ट करें।

AWS GovCloud regions के लिए IAM Role उपलब्ध नहीं है।

Access Keys

Access Keys एक AWS Access Key ID और Secret Access Key का उपयोग करती हैं। AWS GovCloud regions के लिए यह विधि आवश्यक है।

1. अपना Access Key ID दर्ज करें।
2. अपना Secret Access Key दर्ज करें। यह एन्क्रिप्टेड रूप में स्टोर किया जाता है। यदि कोई की (key) पहले से ही सेव है, तो इसे बनाए रखने के लिए इस फ़ील्ड को खाली छोड़ दें, या इसे बदलने के लिए एक नया मान टाइप करें।

सेव करें और टेस्ट करें

1. Save Settings पर क्लिक करें।
2. यह पुष्टि करने के लिए कि ScribbleMaps bucket तक पहुँच सकता है, Test Connection पर क्लिक करें। यह बटन bucket कॉन्फ़िगर होने के बाद काम करता है।
3. एक बार सेटअप हो जाने के बाद, अपनी टीम के लिए इंटीग्रेशन को सक्षम (enable) या अक्षम (disable) करने के लिए S3 Storage टॉगल का उपयोग करें।

आवश्यक CORS कॉन्फ़िगरेशन

आपके bucket को एक CORS नियम की आवश्यकता है ताकि ब्राउज़र इसमें अपलोड कर सके। इसे bucket की CORS सेटिंग्स में जोड़ें:

[{
"AllowedOrigins": [
"https://www.scribblemaps.com",
"https://team.scribblemaps.com",
"https://widgets.scribblemaps.com"
],
"AllowedMethods": ["GET", "PUT", "DELETE", "HEAD"],
"AllowedHeaders": ["*"],
"MaxAgeSeconds": 3000
}]

यदि सेटअप के बाद टीम के सदस्य फ़ाइलें सेव या लोड नहीं कर पाते हैं, तो संभवतः bucket को अभी भी इस CORS नियम की आवश्यकता है।