Ekibinize bir AWS S3 bucket bağlama - (Team web app)

S3 Bucket Storage ne işe yarar

Ekip üyelerinin buradan coğrafi dosyalar yükleyebilmesi ve buraya haritalar kaydedebilmesi için kendi Amazon Web Services (AWS) S3 bucket'ınızı bağlayın. Dosyalar bucket'ınızda kalır. Bunu yalnızca sahipler ve yöneticiler ayarlayabilir.

Bu sayfayı team portal'ın S3 Bucket bölümünden açarsınız.

Bucket detaylarını girin

1. Bucket Name (gerekli). S3 bucket'ınızın adı.
2. Region (gerekli). Bucket'ınızın bulunduğu AWS bölgesini seçin.
3. Folder Prefix (isteğe bağlı). Tüm ScribbleMaps dosyaları için maps/ veya data/ gibi bir önek veya klasör.

Bir kimlik doğrulama yöntemi seçin

ScribbleMaps'in bucket'ınızda nasıl oturum açacağını seçin.

IAM Role (önerilen)

IAM Role, AWS STS aracılığıyla geçici kimlik bilgileri kullanır. Yönetilecek statik anahtarlar olmadığından daha güvenlidir.

1. Kopyalama butonu ile External ID değerini kopyalayın. Rolün güven politikası (trust policy) için buna ihtiyacınız olacak.
2. Tüm adımlar için Setup Instructions seçeneğine tıklayın. Kısaca: - AWS IAM Konsolunda bir rol oluşturun ve güvenilen varlık (trusted entity) olarak Another AWS account seçeneğini belirleyin. - Yönergelerde gösterilen ScribbleMaps AWS Account ID değerini girin. - Require external ID seçeneğini işaretleyin ve bu sayfadaki External ID değerini yapıştırın. - Bucket'ınızda s3:GetObject, s3:PutObject, s3:DeleteObject ve s3:ListBucket işlemlerine izin veren bir politika (policy) ekleyin.
3. Rolün ARN değerini Role ARN alanına yapıştırın.

IAM Role, AWS GovCloud bölgeleri için kullanılamaz.

Access Keys

Access Keys, bir AWS Access Key ID ve Secret Access Key kullanır. Bu yöntem AWS GovCloud bölgeleri için gereklidir.

1. Access Key ID değerinizi girin.
2. Secret Access Key değerinizi girin. Şifrelenmiş olarak saklanır. Bir anahtar zaten kaydedilmişse, mevcut anahtarı korumak için bu alanı boş bırakın veya değiştirmek için yeni bir değer yazın.

Save and test

1. Save Settings butonuna tıklayın.
2. ScribbleMaps'in bucket'a erişebildiğini doğrulamak için Test Connection butonuna tıklayın. Bu buton, bucket yapılandırıldıktan sonra çalışır.
3. Kurulum tamamlandıktan sonra, entegrasyonu ekibiniz için etkinleştirmek veya devre dışı bırakmak için S3 Storage geçiş anahtarını (toggle) kullanın.

Gerekli CORS yapılandırması

Tarayıcının bucket'a yükleme yapabilmesi için bucket'ınızın bir CORS kuralına ihtiyacı vardır. Bunu bucket'ın CORS ayarlarına ekleyin:

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

Kurulumdan sonra ekip üyeleri dosyaları kaydedemiyor veya yükleyemiyorsa, bucket'ın büyük olasılıkla hala bu CORS kuralına ihtiyacı vardır.