حساب‌های سرویس

حساب خدمات حسابی است که به‌جای کاربر نهایی با برنامه مرتبط است. اگر درحال توسعه برنامه یا استفاده از REST API هستید، ممکن است لازم باشد از حساب سرویس برای اصالت‌سنجی در Earth Engine استفاده کنید. درباره اصالت‌سنجی با حساب‌های سرویس بیشتر بدانید.

ایجاد حساب سرویس

ابتدا، پروژه Google Cloud ایجاد کنید اگر قبلاً این کار را نکرده‌اید.

با رفتن به منو «کنسول Cloud» () و انتخاب IAM و سرپرست > حساب‌های سرویس می‌توانید حساب‌های سرویس پروژه Cloud خود را مدیریت کنید. (درصورت درخواست، پروژه را انتخاب کنید.)

برای ایجاد حساب سرویس جدید، روی پیوند + ایجاد حساب سرویس کلیک کنید.

اگر پروژه App Engine ایجاد کرده‌اید، ممکن است ازقبل حساب سرویس پیش‌فرضی (حساب سرویس پیش‌فرض App Engine) برای آن پروژه داشته باشید. اگر درحال راه‌اندازی پروژه App Engine هستید، برای حساب سرویس نقش، پروژه > ویرایشگر را انتخاب کنید.

پیکربندی حساب خدمات برای استفاده از Earth Engine

همه حساب‌های خدمات در یک پروژه Cloud ایجاد می‌شوند که ممکن است همان پروژه مورداستفاده برای برنامه App Engine یا Cloud VM شما باشد. مطمئن شوید که پروژه Cloud ثبت شده است تا به Earth Engine دسترسی داشته باشید، و Earth Engine API در پروژه فعال شده است. همه حساب‌های سرویس در پروژه با اجازه‌های صحیح به Earth Engine دسترسی خواهند داشت.

اصالت‌سنجی در Earth Engine بااستفاده از «اعتبارنامه پیش‌فرض برنامه»

«اعتبارنامه‌های پیش‌فرض برنامه» (ADC) روش توصیه‌شده برای اصالت‌سنجی در محیط‌های بدون نظارت (مثل Cloud Run یا Compute Engine) بدون مدیریت دستی کلیدهای خصوصی است. کتابخانه را با ارسال شناسه پروژه Cloud خود مقداردهی اولیه کنید (my-project را با شناسه پروژه خود جایگزین کنید):

import google.auth
import ee

credentials, project_id = google.auth.default()
ee.Initialize(credentials, project='my-project')

اصالت‌سنجی با کلید خصوصی

اگر برنامه شما باید بااستفاده از کلید خصوصی حساب سرویس اصالت‌سنجی شود (برای محیط‌های تولید که می‌توان از ADC استفاده کرد توصیه نمی‌شود):

  1. کلید خصوصی برای حساب سرویس ایجاد کنید:
    • به صفحه «حساب‌های خدمات» در «کنسول Cloud» بروید.
    • روی منو حساب () کلیک کنید، سپس روی ایجاد کلید > JSON کلیک کنید.
    • فایل کلید JSON را بارگیری کنید.
  2. فایل کلید را در جای امنی نگه دارید. فایل کلید فایل ویژه‌ای است که به برنامه‌ها اجازه می‌دهد ازطرف حساب سرویس شما به میاناهای برنامه‌سازی کاربردی Google دسترسی داشته باشند. هرگز کلید خصوصی‌تان را در مکان عمومی ذخیره نکنید. اگر کلید خصوصی‌تان را گم کردید، می‌توانید دسترسی به حساب سرویس را لغو کنید و بااستفاده از Cloud Console کلید جدیدی ایجاد کنید. برای جزئیات، ایجاد و حذف کلیدهای حساب سرویس را ببینید.
  3. کد Python زیر را از هر جایی که فایل .private-key.json را قرار داده‌اید آزمایش کنید (my-project را با شناسه پروژه Google Cloud خودتان جایگزین کنید):
    import ee
    service_account = 'my-service-account@...gserviceaccount.com'
    credentials = ee.ServiceAccountCredentials(service_account, '.private-key.json')
    ee.Initialize(credentials, project='my-project')

اگر بتوانید بدون خطا مقداردهی اولیه کنید، حساب سرویس شما آماده استفاده است.

استفاده از حساب سرویس پیش‌فرض در Compute Engine

اگر از حساب سرویس پیش‌فرض استفاده می‌کنید، ابتدا باید گستره‌های دسترسی VM را برای «حساب سرویس Compute Engine» به «اجازه دسترسی کامل به همه Cloud API» تغییر دهید. (اگر از حساب‌های سرویس پیش‌فرض در Dataflow یا App Engine استفاده می‌کنید، این مرحله لازم نیست.)

برای اصالت‌سنجی در Earth Engine بااستفاده از حساب سرویس پیش‌فرض، از کد زیر استفاده کنید (my-project را با شناسه پروژه Google Cloud خودتان جایگزین کنید):

from google.auth import compute_engine
import ee
credentials = compute_engine.Credentials(scopes=['https://www.googleapis.com/auth/earthengine'])
ee.Initialize(credentials, project='my-project')

راه‌اندازی دسترسی به REST API

اگر حساب سرویس قرار است بااستفاده از REST API محاسبات انجام دهد، باید به آن اجازه سطح پروژه، به‌ویژه نقش «نمایشگر منابع Earth Engine» را بدهید. بسته به پیکربندی پروژه، ممکن است لازم باشد نقش مصرف‌کننده استفاده از سرویس را نیز به حساب سرویس بدهید. برای اطلاعات بیشتر درباره اجازه‌های پروژه موردنیاز برای استفاده از Earth Engine، به صفحه کنترل دسترسی مراجعه کنید.

عیب‌یابی

خطا: invalid_grant

OAuth2 می‌تواند به انحراف ساعت بسیار حساس باشد. اگر مطمئن هستید که همه‌چیز را به‌درستی راه‌اندازی کرده‌اید، بررسی کنید که آیا ساعت رایانه‌تان با زمان شبکه همگام‌سازی شده است یا نه.

خطا: «محدوده(های) ارائه‌شده مجاز نیستند» هنگام صادر کردن به Cloud Storage

اگر این خطا را هنگام اجرا در تکلیف Cloud Run می‌بینید، هنگام ایجاد اعتبارنامه (مثلاً در google.auth.default(scopes=...)) آرگومان scopes را تنظیم نکنید. مشخص کردن دامنه‌ها می‌تواند با اجازه‌های پیش‌فرض در این محیط تداخل داشته باشد.