همه برنامه‌هایی که به Google API دسترسی دارند باید تأیید کنند که هویت و هدفشان را به‌طور دقیق طبق آنچه در خط‌مشی داده‌های کاربر سرویس‌های Google API مشخص شده است نشان می‌دهند. برای محافظت از شما و کاربران مشترک Google و برنامه‌تان، ممکن است صفحه رضایت و برنامه‌تان به درستی‌سنجی Google نیاز داشته باشد.
اگر برنامه‌تان همه معیارهای زیر را داشته باشد، به درستی‌سنجی نیاز دارد:
- در «کنسول Google API»، پیکربندی برنامه‌تان برای نوع کاربر خارجی و وضعیت انتشار منتشرشده تنظیم شده است. این یعنی برنامه‌تان در مرحله تولید است و برای هر کاربری که «حساب Google» داشته باشد دردسترس است.
- می‌خواهید برنامه‌تان نشان‌واره یا نام نمایشی را در صفحه رضایت OAuth نمایش دهد.
اگر اطلاعات نمانام برنامه‌تان را به‌تأیید برسانید، می‌توانید احتمال اینکه کاربر نمانام شما را تشخیص دهد و تصمیم بگیرد به برنامه‌تان اجازه دسترسی بدهد افزایش دهید. اطلاعات نمانام تأییدشده همچنین می‌تواند باعث شود که بعداً وقتی کاربر یا سرپرست Google Workspace برنامه‌ها و سرویس‌های طرف سوم دارای دسترسی به حساب را مرور می‌کند، لغو دسترسی کمتری انجام شود. فرایند خودکارسازی‌شده درستی‌سنجی نمانام معمولاً چند دقیقه پس‌از کلیک کردن روی دکمه درستی‌سنجی نمانام‌سازی طول می‌کشد. در برخی موارد که نتیجه به‌طور خودکار قابل تعیین نیست، ممکن است برنامه‌تان تحت فرایند بازبینی دستی قرار گیرد که معمولاً ۲ تا ۳ روز کاری طول می‌کشد.
اگر اطلاعات نمانام‌سازی برنامه‌تان تأییدنشده باقی بماند، ممکن است منجر به کاهش اعتماد کاربر به درخواست شما برای داده‌هایش شود، که می‌تواند به صدور مجوزهای کمتر ازسوی کاربر و لغو بیشتر مجوزها در آینده منجر شود.
صفحه رضایت OAuth
صفحه رضایت به کاربران می‌گوید چه کسی درخواست دسترسی به داده‌هایشان را دارد و برنامه‌تان به چه نوع داده‌هایی نیاز دارد تا ازجانب آن‌ها دسترسی داشته باشد، همان‌طور که در کادر ۲ شکل ۱ برجسته شده است.
وقتی برنامه‌تان فرایند درستی‌سنجی نمانام را طی می‌کند و تأییدیه دریافت می‌کند، احتمال بیشتری وجود دارد که هویت برنامه و خط‌مشی‌های داده‌های کاربر شما به‌وضوح توسط حسابی که اجازه را اعطا می‌کند درک شود. این درک واضح می‌تواند احتمال اینکه دارنده حساب درخواست‌های شما را مجاز کند و هنگام بررسی لغوهای احتمالی در صفحه حساب Google خود دسترسی را حفظ کند افزایش دهد. محتوایی که در صفحه نمانام‌سازی OAuth در «کنسول ابری» پیکربندی می‌کنید، مؤلفه‌های زیر را پر می‌کند:
- نام و نشان‌واره برنامه شما (همان‌طور که در کادر ۱ شکل ۱ نشان داده شده است)
- ایمیل پشتیبانی کاربر شما که پس‌از انتخاب نام برنامه‌تان نشان داده می‌شود (کادر ۲ در شکل ۱)
- پیوندهای خط‌مشی رازداری و شرایط خدمات شما (کادر ۳ شکل ۱)
دامنه‌های مجاز
به‌عنوان بخشی از فرایند درستی‌سنجی نمانام، Google درستی‌سنجی همه دامنه‌های مرتبط با صفحه رضایت OAuth و اطلاعات کاربری برنامه را الزامی می‌داند. از شما می‌خواهیم مؤلفه دامنه دردسترس برای ثبت در پسوند عمومی را درستی‌سنجی کنید: «دامنه خصوصی برتر». برای مثال، صفحه رضایت OAuth
که با صفحه اصلی برنامه
https://sub.example.com/product پیکربندی شده است از دارنده حساب می‌خواهد مالکیت
دامنه example.com را تأیید کند.
بخش دامنه‌های مجاز در ویرایشگر صفحه کسب رضایت OAuth باید حاوی دامنه‌های خصوصی برتری باشد که در URIهای بخش دامنه برنامه استفاده می‌شود. این دامنه‌ها شامل صفحه اصلی برنامه، خط‌مشی رازداری، و شرایط خدمات می‌شود. بخش دامنه‌های مجاز همچنین باید شامل URIهای هدایتگر یا مبدأهای جاوا اسکریپت مجاز در انواع برنامه OAuth «برنامه وب» شما باشد.
مالکیت دامنه‌های مجازتان را بااستفاده از کنسول جستجوی Google درستی‌سنجی کنید. «حساب Google» با اجازه‌های مالک برای دامنه باید با پروژه «کنسول API» که از آن دامنه مجاز استفاده می‌کند مرتبط باشد. برای اطلاعات بیشتر درباره درستی‌سنجی دامنه در «کنسول جستجوی Google»، به درستی‌سنجی مالکیت سایت مراجعه کنید.
مراحل آماده شدن برای درستی‌سنجی
همه برنامه‌هایی که از Google APIs برای درخواست دسترسی به داده‌ها استفاده می‌کنند باید مراحل زیر را برای تکمیل درستی‌سنجی نمانام انجام دهند:
- تأیید کنید که برنامه‌تان تحت هیچ‌کدام از موارد استفاده در بخش استثناهای الزامات درستی‌سنجی قرار نمی‌گیرد.
- مطمئن شوید برنامه‌تان با الزامات نمانام‌سازی میاناهای برنامه‌سازی کاربردی یا محصول مرتبط مطابقت دارد. برای مثال، رهنمودهای نمانام‌سازی را برای دامنه‌های «ورود به سیستم با Google» ببینید.
- مالکیت دامنه‌های مجاز پروژه‌تان را در کنسول جستجوی Google به‌تأیید برسانید. از «حساب Google» مرتبط با پروژه «کنسول میانای برنامه‌سازی کاربردی» خود به‌عنوان «مالک» یا «ویرایشگر» استفاده کنید.
- مطمئن شوید که همه اطلاعات نمانام‌سازی در صفحه کسب رضایت OAuth، مثل نام برنامه، ایمیل پشتیبانی، شناسه منبع یکسان صفحه اصلی، شناسه منبع یکسان خط‌مشی رازداری، و غیره، به‌درستی هویت برنامه را نشان می‌دهد.
الزامات صفحه اصلی برنامه
مطمئن شوید صفحه اصلی‌تان الزامات زیر را برآورده می‌کند:
- صفحه اصلی شما باید به‌طور عمومی دردسترس باشد و نه فقط برای کاربران واردشده به سیستم سایت شما.
- ارتباط صفحه اصلی شما با برنامه‌ای که تحت بازبینی است باید واضح باشد.
- پیوندهای فهرستگان برنامه‌تان در «فروشگاه Google Play» یا صفحه Facebook آن به‌عنوان صفحه اصلی معتبر برنامه درنظر گرفته نمی‌شود.
الزامات پیوند خط‌مشی رازداری برنامه
مطمئن شوید خط‌مشی رازداری برنامه‌تان الزامات زیر را برآورده می‌کند:
- خط‌مشی رازداری باید برای کاربران قابل‌مشاهده باشد، در همان دامنه‌ای میزبانی شود که صفحه اصلی برنامه‌تان قرار دارد، و در صفحه رضایت OAuth در «کنسول Google API» به آن پیوند داده شود. توجه داشته باشید که صفحه اصلی باید شامل شرحی از عملکرد برنامه و همچنین پیوندهایی به خط‌مشی رازداری و شرایط خدمات اختیاری باشد.
- خط‌مشی رازداری باید نحوه دسترسی، استفاده، ذخیره، یا هم‌رسانی داده‌های کاربر Google توسط برنامه‌تان را شفاف‌سازی کند. باید استفاده‌تان از داده‌های کاربر Google را به شیوه‌هایی محدود کنید که در خط‌مشی رازداری منتشرشده‌تان شفاف‌سازی شده است.
نحوه ارسال برنامه برای درستی‌سنجی نمانام
پروژه کنسول Google Cloud همه منابع «کنسول Cloud» شما را سازمان‌دهی می‌کند. پروژه شامل مجموعه‌ای از «حساب‌های Google» مرتبط است که اجازه انجام عملیات پروژه، مجموعه‌ای از میاناهای برنامه‌سازی کاربردی فعال، و تنظیمات صورت‌حساب، اصالت‌سنجی، و پایش برای آن میاناهای برنامه‌سازی کاربردی را دارند. برای مثال، یک پروژه می‌تواند شامل یک یا چند کارخواه OAuth باشد، میاناهای برنامه‌سازی کاربردی را برای استفاده توسط آن کارخواه‌ها پیکربندی کند، و صفحه رضایت OAuth را پیکربندی کند که قبل‌از اینکه کاربران دسترسی به برنامه شما را مجاز کنند به آن‌ها نشان داده می‌شود.
اگر هرکدام از کارخواه‌های OAuth شما برای تولید آماده نیست، پیشنهاد می‌کنیم آن‌ها را از پروژه‌ای که درخواست درستی‌سنجی می‌کند حذف کنید. می‌توانید این کار را در صفحه کارخواهان انجام دهید.
برای ارسال درخواست درستی‌سنجی، این مراحل را دنبال کنید:
- مطمئن شوید برنامه‌تان از شرایط خدمات Google APIs و خط‌مشی داده‌های کاربر سرویس‌های Google API تبعیت می‌کند.
- نقش‌های مالک و ویرایشگر حساب‌های مرتبط با پروژه‌تان را در Cloud Console به‌روز نگه دارید، همچنین ایمیل پشتیبانی کاربر صفحه رضایت OAuth و اطلاعات تماس توسعه‌دهنده را. این کار تضمین می‌کند که اعضای صحیح تیم شما از هرگونه الزامات جدید مطلع شوند.
- به صفحه نمانام‌سازی OAuth در «کنسول Cloud» بروید.
- روی دکمه انتخابگر پروژه کلیک کنید.
در کادر گفتگوی انتخاب از که ظاهر می‌شود، پروژه‌تان را انتخاب کنید. اگر نمی‌توانید پروژه‌تان را پیدا کنید اما شناسه پروژه‌تان را می‌دانید، می‌توانید نشانی وب را در مرورگرتان با قالب زیر بسازید:
https://console.developers.google.com/auth/branding?project=[PROJECT_ID]
[PROJECT_ID] را با شناسه پروژه‌ای که می‌خواهید استفاده کنید جایگزین کنید.
در صفحه نمانام‌سازی، اطلاعات نمانام‌سازی برنامه‌تان را ارائه دهید، ازجمله نام برنامه، نشان‌واره، اطلاعات تماس توسعه‌دهنده، و پیوندهای مربوطه. هر تغییری که ایجاد می‌کنید به‌عنوان پیش‌نویس نمانام‌سازی ذخیره می‌شود.
برای شروع فرایند ارزیابی، روی دکمه درستی‌سنجی نمانام‌سازی کلیک کنید. بازبینی خودکارسازی‌شده معمولاً ظرف چند دقیقه تکمیل می‌شود.
وقتی ارزیابی تکمیل شد، وضعیت را مرور کنید. اگر موفقیت‌آمیز باشد، وضعیت به آماده انتشار تغییر می‌کند. اگر درستی‌سنجی خودکار ناموفق بود، می‌توانید مشکلات شناسایی‌شده را ببینید و آن‌ها را برطرف کنید یا درخواست بازبینی دستی بدهید.
روی دکمه انتشار نمانام‌سازی کلیک کنید تا نمانام‌سازی جدید فعال شود.
اگر برنامه‌تان برای دامنه‌های حساس یا محدودشده نیز به درستی‌سنجی نیاز دارد، به مرکز درستی‌سنجی OAuth بروید تا وضعیت دسترسی به داده را پیگیری کنید و اطلاعات تکمیلی درخواست‌شده، مثل ویدیو نمایشی، را ارائه دهید. توجه داشته باشید که قبل‌از اینکه بتوانید برای دسترسی به داده‌ها درخواست درستی‌سنجی کنید، باید وضعیت نمانام‌سازی منتشرشده داشته باشید.
از دکمه افزودن یا برداشتن دامنه‌ها برای اعلام همه دامنه‌های درخواست‌شده توسط برنامه‌تان استفاده کنید. مجموعه اولیه‌ای از دامنه‌ها که برای «ورود به سیستم با Google» ضروری هستند، در بخش دامنه‌های غیرحساس ازپیش تکمیل شده‌اند. گستره‌های اضافه‌شده به‌عنوان غیرحساس، حساس، یا محدودشده طبقه‌بندی می‌شوند.
حداکثر سه پیوند به اسناد مربوط به ویژگی‌های مرتبط در برنامه‌تان ارائه دهید.
هرگونه اطلاعات تکمیلی را که درباره برنامه‌تان در مراحل بعدی درخواست می‌شود ارائه دهید.
پس‌از اینکه نمانام‌سازی‌تان را منتشر کردید یا درخواست دسترسی به داده‌ها را ارسال کردید، تیم «ایمنی و اعتماد» Google ممکن است ازطریق ایمیل با شما تماس بگیرد و اطلاعات بیشتری را که نیاز دارد یا مراحلی را که باید تکمیل کنید به شما اطلاع دهد. نشانی‌های ایمیلتان را در بخش اطلاعات تماس توسعه‌دهنده و ایمیل پشتیبانی صفحه رضایت OAuth برای درخواست اطلاعات بیشتر بررسی کنید. همچنین می‌توانید صفحه‌های «مرکز درستی‌سنجی» یا «نمانام‌سازی» پروژه‌تان را مشاهده کنید تا وضعیت بازبینی فعلی پروژه‌تان را تأیید کنید، ازجمله اینکه آیا فرایند بازبینی تا زمانی که منتظر پاسخ شما هستیم موقتاً متوقف شده است یا نه.
استثناهای الزامات درستی‌سنجی
اگر قرار است برنامه‌تان در هریک از سناریوهای شرح‌داده‌شده در بخش‌های زیر استفاده شود، نیازی نیست آن را برای بازبینی ارسال کنید.
استفاده شخصی
یک مورد استفاده این است که شما تنها کاربر برنامه‌تان باشید یا برنامه‌تان فقط توسط چند کاربر استفاده شود که همه آن‌ها را شخصاً می‌شناسید. شما و تعداد محدودی از کاربرانتان ممکن است با پیش رفتن در صفحه برنامه تأییدنشده و اعطای دسترسی به حساب‌های شخصی‌تان به برنامه‌تان مشکلی نداشته باشید.
پروژه‌های مورداستفاده در ردیف‌های «توسعه»، «آزمایش»، یا «آماده‌سازی»
برای رعایت «خط‌مشی‌های Google OAuth 2.0»، توصیه می‌کنیم پروژه‌های متفاوتی برای محیط‌های آزمایشی و تولیدی داشته باشید. توصیه می‌کنیم فقط درصورتی برنامه‌تان را برای درستی‌سنجی ارسال کنید که بخواهید برنامه‌تان را برای همه کاربران دارای «حساب Google» دردسترس قرار دهید. بنابراین، اگر برنامه‌تان در مرحله توسعه، آزمایش، یا آماده‌سازی است، درستی‌سنجی لازم نیست.
اگر برنامه‌تان در مرحله توسعه یا آزمایش است، می‌توانید وضعیت انتشار را در تنظیم پیش‌فرض آزمایش رها کنید. این تنظیم یعنی برنامه‌تان هنوز درحال توسعه است و فقط برای کاربرانی که به فهرست کاربران آزمایشی اضافه می‌کنید دردسترس است. باید فهرست «حساب‌های Google» را که در توسعه یا آزمایش برنامه‌تان مشارکت دارند مدیریت کنید.
فقط داده‌های متعلق به سرویس
اگر برنامه‌تان از حساب سرویس برای دسترسی به داده‌های خودش استفاده می‌کند و به داده‌های کاربر (پیوندشده به «حساب Google») دسترسی ندارد، لازم نیست آن را برای درستی‌سنجی ارسال کنید.
برای درک اینکه حساب‌های خدمات چیست، به حساب‌های خدمات در اسناد Google Cloud مراجعه کنید. برای دریافت دستورالعمل‌های نحوه استفاده از حساب سرویس، به استفاده از OAuth 2.0 برای برنامه‌های سرور به سرور مراجعه کنید.
فقط مصرف داخلی
این یعنی فقط افراد موجود در سازمان Google Workspace یا Cloud Identity شما از این برنامه استفاده می‌کنند. پروژه باید متعلق به سازمان باشد و صفحه رضایت OAuth آن باید برای نوع کاربر داخلی پیکربندی شود. در این حالت، ممکن است برنامه‌تان به تأیید سرپرست سازمان نیاز داشته باشد. برای اطلاعات بیشتر، ملاحظات تکمیلی برای Google Workspace را ببینید.
- درباره برنامه‌های عمومی و داخلی بیشتر بدانید.
- در پرسشگان چگونه می‌توانم برنامه‌ام را به‌عنوان فقط داخلی علامت‌گذاری کنم؟ با نحوه علامت‌گذاری برنامه‌تان به‌عنوان داخلی آشنا شوید.
نصب در سراسر دامنه
اگر قصد دارید برنامه‌تان فقط کاربران Google Workspace یا سازمان Cloud Identity را هدف قرار دهد و همیشه از نصب در سراسر دامنه استفاده کند، برنامه‌تان به درستی‌سنجی نمانام نیاز نخواهد داشت. بااین‌حال، اگر برنامه‌تان از دامنه‌های محدودشده یا حساس استفاده می‌کند، درستی‌سنجی برنامه الزامی است. دلیلش این است که نصب در سراسر دامنه به سرپرست دامنه اجازه می‌دهد به برنامه‌های داخلی و شخص ثالث اجازه دهد به داده‌های کاربران شما دسترسی داشته باشند. سرپرستان سازمان تنها حساب‌هایی هستند که می‌توانند برنامه را به فهرست مجاز برای استفاده در دامنه‌هایشان اضافه کنند.
در پرسشگان برنامه من کاربرانی با حساب‌های سازمانی از دامنه Google Workspace دیگری دارد، با نحوه تبدیل کردن برنامه‌تان به «نصب در سراسر دامنه» آشنا شوید.