مجوز و احراز هویت
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
ما قویاً توصیه می کنیم که هنگام ادغام با SAS Portal API از یک حساب سرویس برای احراز هویت استفاده کنید. در صورت لزوم، یک حساب خدمات ایجاد کنید . هنگام ایجاد کلید حساب سرویس خود، حتماً JSON را به عنوان نوع کلید خود انتخاب کنید. پس از تکمیل، کلید حساب سرویس شما در مکان پیش فرض مرورگر شما دانلود می شود. علاوه بر این، مطمئن شوید که نقش "مالک پروژه" را به حساب سرویس اختصاص دهید .
در مرحله بعد، باید احراز هویت حساب سرویس خود را به عنوان یک توکن حامل ارائه کنید. اگر مستقیماً با SAS Portal API تماس بگیرید، مثلاً با درخواست HTTP با cURL ، احراز هویت خود را به‌عنوان یک توکن حامل در سرصفحه Authorization ارسال می‌کنید. برای دریافت توکن حامل با حساب سرویس خود، این مراحل را دنبال کنید:
- ابزار خط فرمان
gcloud را نصب کنید . به حساب سرویس خود احراز هویت کنید. در دستور زیر، ${KEY_FILE} را با مسیر فایل کلید حساب سرویس خود جایگزین کنید:
gcloud auth activate-service-account --key-file ${KEY_FILE} از حساب سرویس خود برای دریافت یک رمز مجوز استفاده کنید:
gcloud auth print-access-token
دستور یک مقدار نشانه دسترسی را برمی گرداند.
وقتی از API استفاده می‌کنید، مقدار توکن را به‌عنوان توکن حامل در سرصفحه Authorization ارسال کنید. مثال زیر را ببینید:
curl -X GET -H "X-Goog-User-Project: ${CLIENT_PROJECT}" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${TOKEN}" \
"https://sasportal.googleapis.com/v1alpha1/customers" ${CLIENT_PROJECT} را روی شناسه پروژه Google Cloud که از آن درخواست‌ها را انجام می‌دهید، تنظیم کنید و سپس ${TOKEN} را به نشانه مجوز تنظیم کنید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eService accounts are the recommended authentication method for integrating with the SAS Portal API, requiring the creation of a service account with a JSON key and granting it the "Project Owner" role.\u003c/p\u003e\n"],["\u003cp\u003eAuthentication to the SAS Portal API is done using a Bearer token obtained through the \u003ccode\u003egcloud\u003c/code\u003e command-line tool by activating the service account and printing an access token.\u003c/p\u003e\n"],["\u003cp\u003eWhen calling the API, include the Bearer token in the \u003ccode\u003eAuthorization\u003c/code\u003e header of your request along with the \u003ccode\u003eX-Goog-User-Project\u003c/code\u003e header specifying your Google Cloud Project ID.\u003c/p\u003e\n"]]],["The key actions are creating a service account with a JSON key, granting it the \"Project Owner\" role, and obtaining a Bearer token for API authentication. This is done by installing the `gcloud` tool, authenticating the service account using `gcloud auth activate-service-account --key-file`, and generating an access token via `gcloud auth print-access-token`. This token should then be included in the `Authorization` header when making API calls as a Bearer token.\n"],null,["# Authorization and authentication\n\nWe strongly recommend that you use a service account for authentication when you integrate with\nthe SAS Portal API. If necessary, [create a service account](https://cloud.google.com/iam/docs/creating-managing-service-accounts#creating_a_service_account). Be sure to select JSON as your key type when you [create your service account key](https://cloud.google.com/iam/docs/creating-managing-service-account-keys#creating_service_account_keys). Once complete, your service account key is downloaded to your\nbrowser's default location. Furthermore, be sure to [grant the \"Project Owner\" role](https://cloud.google.com/iam/docs/granting-changing-revoking-access) to the service account.\n\nNext, you need to provide your service account authentication as a Bearer token. If you call the\nSAS Portal API directly, such as by making an HTTP request with `cURL`, you pass your\nauthentication as a Bearer token in an `Authorization` header. To obtain a Bearer token\nwith your service account, follow these steps:\n\n1. [Install the `gcloud` command line tool](https://cloud.google.com/sdk/install).\n2. Authenticate to your service account. In the following command, replace\n \u003cvar translate=\"no\"\u003e${KEY_FILE}\u003c/var\u003e with the path to your service account key file:\n\n ```genshi\n gcloud auth activate-service-account --key-file ${KEY_FILE}\n ```\n3. Use your service account to obtain an authorization token:\n\n ```text\n gcloud auth print-access-token\n ```\n\n The command returns an access token value.\n4. When you use the API, pass the token value as a Bearer token in an `Authorization`\n header. See the following example:\n\n ```genshi\n curl -X GET -H \"X-Goog-User-Project: ${CLIENT_PROJECT}\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer ${TOKEN}\" \\\n \"https://sasportal.googleapis.com/v1alpha1/customers\"\n ```\n\n Set \u003cvar translate=\"no\"\u003e${CLIENT_PROJECT}\u003c/var\u003e to the\n [ID of the Google Cloud Project](https://cloud.google.com/resource-manager/docs/creating-managing-projects) from which you make the requests, and then set\n \u003cvar translate=\"no\"\u003e${TOKEN}\u003c/var\u003e to the authorization token."]]
