همه برنامه‌هایی که به 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 Services پیروی می‌کند.
- نقش‌های مالک و ویرایشگر حساب‌های مرتبط با پروژه‌تان و همچنین ایمیل پشتیبانی کاربر صفحه رضایت OAuth و اطلاعات تماس توسعه‌دهنده را در «کنسول Cloud» خود به‌روز نگه دارید. این کار باعث می‌شود اعضای مناسب تیم شما از هرگونه الزامات جدید مطلع شوند.
- به صفحه نمانام‌سازی Cloud Console OAuth بروید.
- روی دکمه انتخابگر پروژه کلیک کنید.
- در کادر گفتگوی انتخاب از که ظاهر می‌شود، پروژه‌تان را انتخاب کنید. اگر نمی‌توانید پروژه‌تان را پیدا کنید اما شناسه پروژه‌تان را می‌دانید، می‌توانید نشانی وبی را در مرورگرتان با قالب زیر بسازید:
https://console.developers.google.com/auth/branding?project=[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» دیگری دارد، با نحوه تبدیل برنامه‌تان به «نصب در سراسر دامنه» آشنا شوید.