Kaynaklara erişimi kontrol etme

Earth Engine etkin projenizin öğelerini veya işlem kotasını proje düzeyinde diğer Earth Engine kullanıcılarıyla paylaşabilirsiniz. Earth Engine öğeleri veya işlem kaynakları başka bir kullanıcıyla ya da kullanıcı grubuyla paylaşılabilir. Bir kullanıcı grubuyla paylaşmak istiyorsanız yeni bir Google Grubu oluşturun ve e-posta adresini not edin (grup sayfasındaki Hakkında bağlantısından ulaşabilirsiniz). Bu sayfada, bir kişi veya grup için kaynaklara nasıl erişim sağlanacağı ve farklı etkinlikler için gereken roller ve izinler açıklanmaktadır.

Earth Engine hizmet kullanımını ayarlama

Earth Engine API'yi bir Cloud projesinde kullanmak için API'nin projede etkinleştirilmesi ve kullanıcının en az Earth Engine Kaynak Görüntüleyici rolündeki izinlere sahip olması gerekir (önceden tanımlanmış Earth Engine IAM rolleri hakkında daha fazla bilgi edinin). Ayrıca, kullanıcının projede en az serviceusage.services.use iznine sahip olması gerekir. Bu izin, projenin Sahibi veya Düzenleyicisi rolleri ya da belirli bir Hizmet Kullanımı Tüketicisi rolü aracılığıyla verilebilir. Kullanıcının seçili projede gerekli Earth Engine izinleri ve Hizmet Kullanımı izinleri yoksa hata mesajı gösterilir.

Öğe izinlerini ayarlama

Öğe düzeyinde izin belirleme

Öğe düzeyinde izinleri güncellemek için birkaç seçenek vardır.

  • Kod Düzenleyici'de Öğe Yöneticisi'ni kullanın.
  • Earth Engine komut satırını kullanma
  • ee.data.setAssetAcl() gibi bir istemci kitaplığı kullanın.
  • Alternatif olarak REST API'yi doğrudan çağırabilirsiniz.

Proje düzeyinde öğe izinlerini ayarlama

Proje düzeyinde paylaşım, Earth Engine özellikli Cloud projenizdeki tüm öğelerin izinlerini tek seferde ayarlar.

Projenizin IAM yönetici sayfasında uygun Identity and Access Management (IAM) rolünü atayarak öğeleri proje düzeyinde paylaşabilirsiniz. Earth Engine öğelerini ve kaynaklarını paylaşmak için önceden tanımlanmış Earth Engine IAM rolleri vardır. IAM rollerine daha genel bir bakış için Rolleri Anlama başlıklı makaleyi inceleyin.

Başka bir kullanıcı öğelerinizden birine erişmeye çalıştığında izinler önce öğe düzeyinde kontrol edilir. İzinler öğe düzeyinde ayarlanmamışsa veya kontrol başarısız olursa (ör. erişim yoksa) izinler proje düzeyinde kontrol edilir.

Proje düzeyinde izinleri ayarlama

Proje düzeyinde izinleri ayarlamak için bir kullanıcıya veya kullanıcı grubuna proje IAM rolü atayın:

  1. Google Cloud Console'da IAM sayfasını açın
    IAM sayfasını açın
    Alternatif olarak, fare imlecini Kod Düzenleyici'nin Assets (Öğeler) sekmesinde projenizin adının üzerine getirin ve simgesini tıklayın.
  2. Proje seçin'i tıklayın ve projenizi seçin (IAM sayfasını Kod Düzenleyici'den açtıysanız zaten orada olmanız gerekir).
  3. Üst kısımdan EKLE'yi tıklayın ve yeni üye olarak kişinin veya grubun e-posta adresini ekleyin ya da projedeki mevcut üyenin yanındaki simgesini tıklayın.
  4. Role (Rol) açılır menüsünde, vermek istediğiniz Earth Engine Resource (Earth Engine Kaynağı) rolünü arayın. Ayrıntılar için Önceden Tanımlanmış Earth Engine IAM Rolleri başlıklı makaleyi inceleyin.
  5. KAYDET düğmesini tıklayın.

VPC Hizmet Kontrolleri

Earth Engine, kullanıcıların kaynaklarını güvence altına almasına ve veri hırsızlığı riskini azaltmasına yardımcı olan bir Google Cloud güvenlik özelliği olan VPC Hizmet Kontrolleri'ni destekler. VPC hizmet çevresine kaynak eklemek, veri okuma ve yazma işlemleri üzerinde daha fazla kontrol sağlar.

VPC-SC özellikleri ve yapılandırması hakkında daha fazla bilgi edinin.

Sınırlamalar

Kaynaklarınız için VPC Hizmet Kontrolleri'ni etkinleştirdiğinizde bazı sınırlamalarla karşılaşırsınız. Bu sınırlamalar için örnek geçici çözümler sağladık:

Sınırlama Örnek alternatif
Kod Düzenleyici desteklenmez ve VPC Hizmet Kontrolleri, hizmet çevresi içindeki kaynaklar ve istemcilerle kullanılmasına izin vermez. Earth Engine Python API'yi geemap kitaplığı ile birlikte kullanın.
Eski öğeler, VPC Hizmet Kontrolleri tarafından korunmaz. Cloud projelerinde depolanan öğeleri kullanın.
Google Drive'a aktarma, VPC Hizmet Kontrolleri tarafından desteklenmez.
Earth Engine Uygulamaları, hizmet çevresi içindeki kaynaklar ve istemciler için desteklenmez. Geçici çözüm yok.

Earth Engine'i güvenli bir VPC hizmet çevresindeki kaynaklarla kullanma özelliği yalnızca Professional ve Premium fiyatlandırma planlarında kullanılabilir. Earth Engine API'yi Basic fiyatlandırma planıyla ilişkili, VPC-SC ile güvenliği sağlanmış bir projeyle kullanmaya çalışırsanız hata alırsınız. Earth Engine fiyatlandırması hakkında daha fazla bilgi edinmek için resmi belgeleri inceleyin.

VPC Hizmet Kontrolleri ve sınırlamaları hakkında daha fazla bilgiyi Desteklenen ürünler ve sınırlamalar bölümünde bulabilirsiniz.

Roller ve izinler

Aşağıdaki bölümlerde, etkinlikleri gerçekleştirmek ve Earth Engine kaynaklarına erişmek için gereken izinler ve roller açıklanmaktadır. Cloud projesi izinleri ve rolleri hakkında daha fazla bilgi edinmek için Google Cloud belgelerini inceleyin.

Önceden tanımlanmış Earth Engine IAM rolleri

Earth Engine, bir projedeki Earth Engine kaynakları üzerinde farklı düzeylerde kontrol sağlayan önceden tanımlanmış roller sunar. Bu roller şunlardır:

Rol Başlık Açıklama
roles/earthengine.viewer Earth Engine Kaynak Görüntüleyicisi Öğeleri ve görevleri görüntüleme ve listeleme izni verir.
roles/earthengine.writer Earth Engine Kaynak Yazıcısı Öğeleri okuma, oluşturma, değiştirme ve silme, resim ve tabloları içe aktarma, görevleri okuma ve güncelleme, etkileşimli hesaplamalar yapma ve uzun süreli dışa aktarma görevleri oluşturma izni verir.
roles/earthengine.admin Earth Engine Yöneticisi Earth Engine öğeleri için erişim denetimlerini değiştirme de dahil olmak üzere tüm Earth Engine kaynakları için izin sağlar.
roles/earthengine.appsPublisher Earth Engine Apps Publisher Earth Engine uygulamasıyla kullanılacak bir hizmet hesabı oluşturma izni sağlar. Ayrıca Cloud projesi kapsamındaki projeye ait uygulamaları düzenleme ve silme izni verir.

Önceden tanımlanmış Earth Engine rolleri ihtiyaçlarınızı karşılamıyorsa temel veya özel bir rol ayarlayabilirsiniz. IAM Rolleri sayfasında belirli bir role göre filtreleme yapıp rolü tıklayarak her rolle ilişkili izin paketini görebilirsiniz.

Earth Engine API'yi etkinleştirme

Bir Cloud projesinde Earth Engine API'yi etkinleştirmek için kullanıcının Hizmet Kullanımı Yöneticisi (roles/serviceusage.serviceUsageAdmin) rolüne veya serviceusage.services.enable iznini içeren başka bir role (ör. Proje Sahibi veya Düzenleyici) sahip olması gerekir.

İzin gerekli
  • serviceusage.services.enable
  • serviceusage.services.get
Önerilen roller
  • Hizmet Kullanımı Yöneticisi (roles/serviceusage.serviceUsageAdmin) VEYA
  • Sahip (roles/owner) VEYA
  • Düzenleyici (roles/editor)

Earth Engine API'ye tam erişim

Kullanıcıların Earth Engine hizmetine doğrudan REST API, Kod Düzenleyici veya istemci kitaplığı üzerinden tam erişim elde edebilmesi için aşağıdaki gibi işlemleri gerçekleştirme iznine sahip olması gerekir:

İzin gerekli
  • clientauthconfig.clients.listWithSecrets
  • earthengine.assets.get
  • earthengine.assets.getIamPolicy
  • earthengine.assets.list
  • earthengine.computations.create
  • earthengine.operations.get
  • earthengine.operations.list
  • monitoring.timeSeries.list
  • resourcemanager.projects.get
  • resourcemanager.projects.list
  • serviceusage.operations.get
  • serviceusage.operations.list
  • serviceusage.quotas.get
  • serviceusage.services.get
  • serviceusage.services.list
  • serviceusage.services.use
Önerilen roller
  • Hizmet Kullanımı Tüketicisi (roles/serviceusage.serviceUsageConsumer) VE aşağıdakilerden biri:
    • Earth Engine Kaynak Görüntüleyicisi (roles/earthengine.viewer) VEYA
    • Earth Engine Kaynak Yazarı (roles/earthengine.writer) VEYA
    • Earth Engine Kaynak Yöneticisi (roles/earthengine.admin)
  • OAuth Config Editor (roles/oauthconfig.editor) ayrıca Earth Engine'e bir not defteri ortamı üzerinden erişen ve Notebook Authenticator'ı kullanan kullanıcılar için de gereklidir. Daha fazla bilgi için Colab veya JupyterLab not defteri kimlik doğrulaması başlıklı makaleyi inceleyin.
Notlar Google Cloud, API'leri çağırırken projeyi etkin proje olarak kullanmak için Service Usage Consumer rolünü gerektirir. X projesinde bu izin olmadan ee.Initialize(project=X) başarısız olur. Ayrıca, kaynak kullanımınızı görüntülemek için Cloud Console'da bu projeyi seçebilirsiniz.

Yalnızca öğe paylaşımı

Kullanıcıya, gerekli etkinliği gerçekleştirmek için minimum izinlere sahip önceden tanımlanmış Earth Engine IAM rollerinden birini verin. Kullanıcıların gerekli serviceusage izinleri olmadan proje kaynaklarını kullanamayacağını unutmayın.

Proje yönetimi

Mevcut projeleri listeleme ve görüntüleme

Bu durum, mevcut projelere göz atmak için Kod Düzenleyici'yi kullanırken ortaya çıkar.

İzin gerekli
  • resourcemanager.projects.get
  • resourcemanager.folders.list
  • resourcemanager.folders.get
  • resourcemanager.organizations.get (nadir)
Önerilen roller
  • Görüntüleyici (roles/viewer) VEYA
    İlgili projelerde Earth Engine Kaynak Görüntüleyici (roles/earthengine.viewer) VEYA
    Tarayıcı (roles/browser, gelişmiş kuruluş senaryoları için önerilir)
  • İlgili klasörlerde Klasör Görüntüleyici (roles/resourcemanager.folderViewer)

Kod Düzenleyici'de kullanılacak bir proje seçin

İzin gerekli
  • resourcemanager.projects.get
  • serviceusage.services.get
Proje daha önce oluşturulmadıysa

Kod Düzenleyici'de bir proje ilk kez seçildiğinde proje, Earth Engine ile kullanılmak üzere başlatılır. Bu işlem daha önce yapılmadıysa kurulumun başarılı olması için bu rollere ihtiyacınız olacaktır.

  • resourcemanager.projects.update VE
  • serviceusage.services.enable
Önerilen roller
  • Görüntüleyen (roles/viewer) VEYA
  • Earth Engine Resource Viewer (roles/earthengine.viewer) VE
    Service Usage Consumer (roles/serviceusage.serviceUsageConsumer)
Ek roller (proje daha önce oluşturulmadıysa)
  • Düzenleyici (roles/editor) VEYA
  • Proje Taşıyıcı (roles/resourcemanager.projectMover) VE
    Proje IAM Yöneticisi (roles/resourcemanager.projectIamAdmin) VE
    Hizmet Kullanımı Yöneticisi (roles/serviceusage.serviceUsageAdmin)

Kod Düzenleyici'yi kullanarak proje oluşturma

İzin gerekli
  • resourcemanager.projects.get
  • resourcemanager.projects.create
  • resourcemanager.projects.update
  • serviceusage.services.get
  • serviceusage.services.enable
Önerilen roller
  • Düzenleyici (roles/editor) VEYA
  • Proje Taşıyıcı (roles/resourcemanager.projectMover) VE
    Proje Oluşturucu (roles/resourcemanager.projectCreator) VE
    Hizmet Kullanımı Yöneticisi (roles/serviceusage.serviceUsageAdmin)
Notlar Kuruluşunuz size Düzenleyici rolü vermeyebilir. Bu nedenle daha ayrıntılı roller gerekebilir. projects.update iznini kapsamak için Proje Taşıyıcı rolü gerekir.

Ticari olmayan katman seçimi

Aşağıdaki izinler ve önerilen roller, ticari olmayan katman yapılandırmasıyla ilgilidir.

Katman seçimi
İzin gerekli
  • earthengine.config.update
Önerilen roller
  • Earth Engine Kaynak Yazarı (roles/earthengine.writer)
Faturalandırma hesabını projeyle ilişkilendirme

Katkıda Bulunan katmanı için projeyle ilişkili geçerli bir faturalandırma hesabı gerekir. Faturalandırma izinleri ve rolleri hakkında daha fazla bilgi için Cloud Faturalandırma erişimi sayfasını inceleyin.

İzin gerekli
Faturalandırma hesabı
  • billing.resourceAssociations.create
Bulut projesi
  • resourcemanager.projects.createBillingAssignment
Önerilen roller
Faturalandırma hesabı
  • Faturalandırma Hesabı Kullanıcısı (roles/billing.user)
Bulut projesi
  • Proje Faturalandırma Yöneticisi (roles/billing.projectManager)

Ticari Proje Tescili

Aşağıdaki izinler, projeleri ücretli kullanım için kaydetme ile ilgilidir.

İzin gerekli
Faturalandırma hesabı
  • billing.accounts.get
  • billing.subscriptions.list
Ayrıca:
  • billing.subscriptions.create (yeni bir Basic veya Professional planı oluşturmak için)
Bulut projesi
  • earthengine.config.update
  • serviceusage.services.get
  • serviceusage.services.enable
Önerilen roller
Faturalandırma hesabı
  • Yeni bir sınırlı plan oluşturmak için Faturalandırma Hesabı Görüntüleyicisi (roles/billing.viewer) rolü
  • Yeni bir Basic veya Professional planı oluşturmak için Faturalandırma Hesabı Yöneticisi (roles/billing.admin)
Bulut projesi
  • Earth Engine Kaynak Yazarı (roles/earthengine.writer)
  • Hizmet Kullanımı Yöneticisi (roles/serviceusage.serviceUsageAdmin)

Ticari Earth Engine plan yönetimi

Aşağıdaki izinler, Earth Engine fiyatlandırma planlarını yönetmeyle ilgilidir.

Faturalandırma hesabında
gerekli izinler
  • billing.accounts.get
  • billing.subscriptions.list
Ayrıca:
  • billing.subscriptions.create (Sınırlı plandan Temel veya Profesyonel plana yükseltme için)
  • billing.subscriptions.update (Basic ve Professional planlar arasında geçiş yapmak veya Basic ya da Professional planı Limited'a düşürmek için)
Faturalandırma hesabında
önerilen roller
  • Mevcut Earth Engine planını görüntülemek için Faturalandırma Hesabı Görüntüleyici (roles/billing.viewer) rolü
  • Earth Engine planını değiştirmek için Faturalandırma Hesabı Yöneticisi (roles/billing.admin) rolü

Toplu görev yönetimi

Aşağıdaki izinler, toplu görev eşzamanlılığı için proje başına sınırları yapılandırmayla ilgilidir. Bu özellik yalnızca Earth Engine'in ticari kullanıcıları tarafından kullanılabilir.

Proje düzeyinde toplu görev sınırlarını görüntüleme

Cloud hesabında
gerekli izinler 		earthengine.config.get

Proje düzeyinde toplu görev sınırları belirleme

Cloud hesabında
gerekli izinler 		earthengine.config.update
Not: Bu izin, faturalandırma hesabında yapılandırılan plan düzeyindeki sınırları görüntülemeyi de kapsar.
Faturalandırma hesabında
gerekli izinler 		billing.subscriptions.list

Uygulama yönetimi

Uygulama bilgilerini görüntüleme

İzin gerekli
  • iam.serviceAccounts.get
  • iam.serviceAccounts.getIamPolicy, uygulama kısıtlanmışsa (daha az yaygın)
Önerilen roller Görüntüleyici (roles/viewer) VEYA
Earth Engine Uygulamaları Yayıncısı (roles/earthengine.appsPublisher)

Uygulamayı yayınlama/güncelleme

İzin gerekli
  • iam.serviceAccounts.get
  • iam.serviceAccounts.create
  • iam.serviceAccounts.enable
  • iam.serviceAccounts.getIamPolicy
  • iam.serviceAccounts.setIamPolicy
  • iam.serviceAccounts.disable, uygulama bir projeden diğerine taşınırsa (nadir)
Önerilen roller Earth Engine Apps Publisher (roles/earthengine.appsPublisher) VEYA
Service Account Admin (roles/iam.serviceAccountAdmin)
Notlar
  • Ayrıca Earth Engine Uygulaması hizmet hesapları, bir OAuth erişim jetonu sunarak Earth Engine sunucularına kendilerini tanıtır. Bu nedenle, uygulama oluşturma sırasında hizmet hesaplarına Hizmet Hesabı Jetonu Oluşturucu (roles/iam.serviceAccountTokenCreator) olarak belirli kimlikler eklenir.
  • Herkese açık bir Earth Engine uygulamasında bu rolün verildiği kimlik earth-engine-public-apps@appspot.gserviceaccount.com, kısıtlanmış uygulamalarda ise uygulama oluşturucu tarafından yapılandırılan erişim kısıtlaması Google Grubu'dur.

Uygulamayı silme

İzin gerekli iam.serviceAccounts.disable
Önerilen roller Earth Engine Apps Publisher (roles/earthengine.appsPublisher) VEYA
Service Account Admin (roles/iam.serviceAccountAdmin)