Kết nối bộ chứa AWS S3 với nhóm của bạn - (ứng dụng web Team)

Chức năng của S3 Bucket Storage

Kết nối bộ chứa Amazon Web Services (AWS) S3 của bạn để thành viên nhóm tải các tệp địa không gian từ đó và lưu bản đồ vào đó. Các tệp vẫn nằm trong bộ chứa của bạn. Chỉ chủ sở hữu và quản trị viên mới có thể thiết lập.

Bạn mở trang này từ mục S3 Bucket (Bộ chứa S3) trong cổng thông tin nhóm.

Nhập thông tin bộ chứa

Bucket Name (Tên bộ chứa) (bắt buộc). Tên bộ chứa S3 của bạn.
Region (Khu vực) (bắt buộc). Chọn khu vực AWS chứa bộ chứa của bạn.
Folder Prefix (Tiền tố thư mục) (tùy chọn). Tiền tố hoặc thư mục cho tất cả tệp ScribbleMaps, chẳng hạn như maps/ hoặc data/.

Chọn phương thức xác thực

Chọn cách ScribbleMaps đăng nhập vào bộ chứa của bạn.

IAM Role (khuyên dùng)

IAM Role sử dụng thông tin xác thực tạm thời qua AWS STS. Không có khóa cố định cần quản lý nên phương thức này an toàn hơn.

Sao chép External ID (ID bên ngoài) bằng nút sao chép. Bạn cần ID này cho chính sách tin cậy của vai trò.
Nhấp vào Setup Instructions (Hướng dẫn thiết lập) để xem các bước đầy đủ. Tóm tắt: - Trong AWS IAM Console, tạo vai trò và chọn Another AWS account (Tài khoản AWS khác) làm thực thể được tin cậy. - Nhập ID tài khoản AWS của ScribbleMaps hiển thị trong hướng dẫn. - Đánh dấu Require external ID (Yêu cầu ID bên ngoài) và dán External ID từ trang này. - Đính kèm chính sách cho phép s3:GetObject, s3:PutObject, s3:DeleteObject, và s3:ListBucket trên bộ chứa của bạn.
Dán ARN của vai trò vào trường Role ARN (ARN của vai trò) .

IAM Role không khả dụng cho các khu vực AWS GovCloud.

Access Keys (Khóa truy cập)

Access Keys sử dụng AWS Access Key ID và Secret Access Key. Phương thức này bắt buộc đối với các khu vực AWS GovCloud.

Nhập Access Key ID (ID khóa truy cập).
Nhập Secret Access Key (Khóa truy cập bí mật). Khóa được lưu dưới dạng mã hóa. Nếu đã lưu một khóa, hãy để trống trường này để giữ lại hoặc nhập giá trị mới để thay thế.

Lưu và kiểm tra

Nhấp vào Save Settings (Lưu cài đặt).
Nhấp vào Test Connection (Kiểm tra kết nối) để xác nhận ScribbleMaps có thể truy cập bộ chứa. Nút này hoạt động sau khi bộ chứa được cấu hình.
Sau khi thiết lập, hãy dùng công tắc S3 Storage (Lưu trữ S3) để bật hoặc tắt tích hợp cho nhóm của bạn.

Cấu hình CORS bắt buộc

Bộ chứa của bạn cần quy tắc CORS để trình duyệt có thể tải tệp lên. Thêm nội dung sau vào cài đặt CORS của bộ chứa:

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

Nếu thành viên nhóm không thể lưu hoặc tải tệp sau khi thiết lập, rất có thể bộ chứa vẫn thiếu quy tắc CORS này.

Cập nhật lần cuối 1 tháng 10 2026