هنگام پیکربندی تأمین خودکار برای برنامههای مبتنی بر SAML، ممکن است با خطاهای زیر مواجه شوید:
در ادامه نحوهی رفع این خطاها و رفع آنها را خواهید خواند.
خرابیهای زمان پیکربندی
خطای کد مجوز
این خطا را زمانی مشاهده خواهید کرد که کد مجوز نتواند با توکن بهروزرسانی جایگزین شود. این اتفاق میتواند در صورتی رخ دهد که کد مجوز شما نادرست باشد یا اگر بین تأیید و کلیک روی ذخیره تغییرات خیلی طولانی صبر کنید. تأیید مجدد و ذخیره تغییرات باید این خطا را حل کند.
| پیام خطا | وضوح تصویر |
|---|---|
| توکن مجوز ایجاد نشد. | دوباره مجوز را امتحان کنید و تغییرات را ذخیره کنید. |
خطای صفحه قدیمی
خطاهای صفحه قدیمی زمانی رخ میدهند که صفحه مرورگر کاربر رفرش نشده باشد و پیکربندی خارج از این جلسه مرورگر تغییر کرده باشد (چه از یک پنجره مرورگر متفاوت و چه توسط یک کاربر متفاوت). در اینجا خطاهای مرتبطی که ممکن است مشاهده کنید، آمده است:
| پیام خطا | وضوح تصویر |
|---|---|
| صفحه شما قدیمی است. تنظیمات مربوط به تأمین منابع موجود است. | برای لغو تنظیمات موجود، رفرش کنید. |
| صفحه شما قدیمی است. تنظیمات مربوط به تأمین منابع وجود ندارد. | برای لغو تنظیمات موجود، رفرش کنید. |
| صفحه شما قدیمی است. نمیتوان تنظیمات پیکربندی نشده را فعال کرد. | برای لغو تنظیمات موجود، رفرش کنید. |
| صفحه شما قدیمی است. نمیتوان تنظیمات پیکربندی نشده را حذف کرد. | برای لغو تنظیمات موجود، رفرش کنید. |
خطای صفحه گذرا
این خطاها گذرا هستند و اگر صفحه را رفرش کنید یا پس از مدتی دوباره اقدام را امتحان کنید، باید برطرف شوند.
| پیام خطا | وضوح تصویر |
|---|---|
| نتوانستم تنظیمات تأمین را دریافت کنم | صفحه را رفرش کنید. |
| پیشتنظیمات تأمینکننده قابل دریافت نیست | صفحه را رفرش کنید. |
| وضعیت تأمین منابع قابل دریافت نیست | صفحه را رفرش کنید. |
| فعالسازی تأمین منابع ناموفق بود | فعالسازی تأمین را دوباره امتحان کنید. |
| خطا در حذف تنظیمات تأمین | دوباره سعی کنید پیکربندی را حذف کنید. |
| تنظیمات تأمین منابع ایجاد نشد | تنظیمات تأمین خود را دوباره ایجاد کنید و تغییرات خود را ذخیره کنید. |
| بهروزرسانی تنظیمات تأمین امکانپذیر نیست | تنظیمات تأمین خود را دوباره بهروزرسانی کنید و تغییرات را ذخیره کنید. |
| نتوانستم ویژگیهای سفارشی را دریافت کنم | دوباره سعی کنید ویژگیهای سفارشی خود را ذخیره کنید. |
| نتوانستم نگاشت ویژگی را بهروزرسانی کنم | نگاشت ویژگیها (attribute mapping) خود را دوباره بهروزرسانی کنید. |
| نتوانستم تنظیمات گروه را برای تأمین خودکار بهروزرسانی کنم | تنظیمات گروه خود را دوباره بهروزرسانی کنید. |
| نتوانستم پیکربندی deprovisioning را بهروزرسانی کنم | پیکربندی deprovisioning خود را دوباره بهروزرسانی کنید. |
| حذف پیکربندی موفقیتآمیز بود اما نتوانست دسترسی کلاینت API را لغو کند | هنگام حذف پیکربندی، مجوزهایی که به برنامه شما اجازه دسترسی به دادههای جانبی گوگل شما را میدهند، لغو میکنیم. |
| خطا هنگام بهروزرسانی پیکربندی تأمین | صفحه را رفرش کنید. |
| احراز هویت ناموفق بود | اطلاعات احراز هویت (مثلاً توکن حامل) ارائه شده در پیکربندی نادرست است. اطلاعات صحیح را وارد کنید. |
| URL نقطه پایانی SCIM ارائه شده نامعتبر است | نقطه پایانی هدف ارائه شده نامعتبر است. URL صحیح را وارد کنید. |
| خطا در فعالسازی تأمین منابع | نوار لغزندهی «تأمین خودکار» را به «فعال» منتقل کنید. |
| خطا در حذف تنظیمات تأمین |
|
| نتوانستم ویژگیها را از ارائهدهنده خدمات هدف شما دریافت کنم |
|
| نتوانستم طرحواره منبع هدف شما را دریافت کنم | URL نقطه پایانی ارائه شده در طول تنظیم تأمین خودکار را تأیید کنید و دوباره سعی کنید ویژگیهای فهرست ابر را به ویژگیهای برنامه هدف نگاشت کنید. |
خرابیهای زمان اجرای تأمین خودکار
ممکن است به دلیل مشکلات دسترسی، مجوز یا پیکربندی API، خرابیهای زمان اجرای تأمین خودکار رخ دهد.
خطاهای سرویسهای داخلی گوگل
| کد خطا | توضیحات و وضوح تصویر |
|---|---|
| ۱۷۰۰۳ ۱۷۰۰۶ ۱۷۰۰۸ | شرح: احراز هویت با سرویسهای داخلی گوگل امکانپذیر نبود. دلیل: مجوزهای این شناسه کلاینتِ تأمینکنندهی کاربر لغو شد: ۹۱۰۸۳۵۸۷۳۲۱۹-es01p47a1ks618hgp59q26cnc6sv33r3.apps.googleusercontent.com وضوح تصویر: مطمئن شوید که این شناسه به این محدودهها دسترسی دارد: https://www.googleapis.com/auth/admin.directory.user.readonly، در کنسول مدیریت، از بخش « مدیریت دسترسی کلاینت API » در بخش «امنیت > تنظیمات پیشرفته» استفاده کنید تا تأیید کنید که شناسه کلاینت این محدودهها را دارد یا این محدودهها را به این شناسه کلاینت اضافه کنید. |
| ۱۷۰۰۷ | شرح: نمیتوان با استفاده از تفویض اختیار در سطح دامنه، به برنامههایی که از تأمین خودکار پشتیبانی میکنند، دسترسی اعطا کرد. نمیتوان به سرویس تأمین خودکار، اختیار تفویض اختیار در سطح دامنه را اعطا کرد. این امر برای اینکه سرویس تأمین خودکار بتواند فهرست گوگل را بخواند، بسیار مهم است. دلایل: دلیل ۱: مجوزها از شناسه کلاینت تأمینکننده کاربر لغو شدند. قطعنامهها: در کنسول مدیریت، از بخش « مدیریت دسترسی کلاینت API » در بخش «امنیت > تنظیمات پیشرفته» استفاده کنید تا شناسه کلاینت و محدودههای زیر را اضافه کنید: شناسه مشتری: محدودهها: https://www.googleapis.com/auth/admin.directory.user.readonly، یک راه حل جایگزین این است که برنامه مورد نظر را حذف کنید و سپس دوباره برنامه را اضافه کنید. دلیل ۲: خطاهای غیرمنتظره سیستم وضوح تصویر: در بیشتر موارد، این خطا به طور خودکار برطرف میشود. با این حال، اگر مشکل پس از چند ساعت ادامه داشت، یا شناسه کلاینت و محدودهها را اضافه کنید یا برنامه را حذف و دوباره اضافه کنید، همانطور که در دلیل ۱ در بالا ذکر شد. |
خطاهای توکن احراز هویت
| کد خطا | شرح و دلیل | وضوح تصویر |
|---|---|---|
| ۱۷۰۱۰ | اعتبارنامههای کافی برای برقراری تماس با نقطه پایانی SCIM شما وجود ندارد. دلیل: توکن احراز هویت باطل شده است. | با کلیک روی Auto-provisioning برای باز کردن تنظیمات، و سپس Reauthorize ، دوباره مجوزدهی را امتحان کنید. |
| ۱۷۰۱۳ | خطایی در دریافت توکن دسترسی از ارائهدهنده خدمات شما رخ داده است. دلیل: توکن احراز هویت باطل شده است. | اگر این خطا پس از مدتی به طور خودکار برطرف نشد، دوباره با کلیک روی Auto-provisioning برای باز کردن تنظیمات، و سپس Reauthorize، مجوزدهی مجدد را امتحان کنید. |
خطاهای توکن دسترسی
| کد خطا | شرح و دلیل | وضوح تصویر |
|---|---|---|
| ۱۷۰۰۲ ۱۷۰۱۱ | نتوانستم توکن دسترسی ایجاد کنم. دلیل: برخی از سرویسهای داخلی گوگل در حال حاضر در دسترس نیستند. | این خطا باید پس از مدتی به طور خودکار برطرف شود. |
| ۱۷۰۰۹ | تولید توکن دسترسی از توکن تازهسازی ناموفق بود. | با کلیک روی Auto-provisioning برای باز کردن تنظیمات، و سپس Reauthorize ، دوباره مجوزدهی را امتحان کنید. |
خطاهای عمومی
| کد خطا | شرح و دلیل | وضوح تصویر |
|---|---|---|
| ۱۲۰۰ برابر | خطای داخلی | این خطا باید پس از مدتی به طور خودکار برطرف شود. |
| ۲۵۰۰۱ | سرویس/پشتیبانی گوگل موقتاً در دسترس نیست. | دوباره تنظیمات مربوط به تأمین خودکار را تنظیم کنید. |
| ۲۵۰۰۲ | سرویس/پشتیبانی گوگل موقتاً در دسترس نیست. دلیل: برنامه برای مشتری نصب نشده است. | برنامه را نصب کنید و سپس دوباره تنظیمات مربوط به تأمین خودکار را انجام دهید. |
| ۲۵۰۰۵ | سرویس/پشتیبانی گوگل موقتاً در دسترس نیست. | این خطا باید پس از مدتی به طور خودکار برطرف شود. |
| ۲۵۰۱۶ | سرویس/پشتیبانی گوگل موقتاً در دسترس نیست. | دوباره تنظیمات مربوط به تأمین خودکار را تنظیم کنید. |
| ۵۰۰۰۱ | خطای داخلی | این خطا باید پس از مدتی به طور خودکار برطرف شود. |
| ۵۰۰۰۳ | خطای داخلی | این خطا باید پس از مدتی به طور خودکار برطرف شود. |
| ۵۰۰۰۵ | یک گروه حذف شده در فیلترهای گروه پیکربندی شده وجود دارد. | گروه حذف شده را از پیکربندی محدوده تأمین حذف کنید. |
| ۵۰۰۰۶ | خطای داخلی | این خطا باید پس از مدتی به طور خودکار برطرف شود. |
خرابیهای سطح منابع
اگر بخش تأمین خودکار در صفحه تنظیمات برنامه SAML عبارت «خطاها» را نشان میدهد، روی فهرست دانلود کلیک کنید. فایل دانلود شده، اقدامات ایجاد، حذف یا بهروزرسانی ناموفق و یک کد خطا و توضیح برای هر خطا را فهرست میکند.
این خطاها فقط روی منابع مشخص شده در فایل تأثیر میگذارند.
| کد خطا | شرح خطا | وضوح تصویر |
|---|---|---|
| ۴۵۰۰۳ | درخواست بهروزرسانی، ایجاد یا حذف منبع توسط برنامه مبتنی بر SCIM شما پذیرفته نشد. جزئیات خطا را در فایل خطای دانلود شده مشاهده کنید. دلایل احتمالی:
| خطا را اصلاح کنید و پس از ذخیره تغییرات، دوباره امتحان کنید. |
| ۴۵۰۰۴ | خطایی بین ارائه دهنده خدمات و گوگل به عنوان ارائه دهنده هویت رخ داده است. متن خطا "خطای داخلی - سهمیه از حد مجاز فراتر رفت" است.
| با ارائه دهنده خدمات تماس بگیرید. |
| ۴۵۰۰۵ | نقطه پایانی SCIM که پیکربندی کردهاید قابل دسترسی نیست. نقطه پایانی SCIM که در کنسول مدیریت ارائه کردهاید را بررسی کنید. | خطا را اصلاح کنید و پس از ذخیره تغییرات، دوباره امتحان کنید. |
| ۴۵۰۰۶ | درخواست بهروزرسانی، ایجاد، حذف منبع به درستی ساخته نشده یا توسط برنامه مبتنی بر SCIM پذیرفته نشده است. به جزئیات خطا در فایل خطای دانلود شده نگاه کنید. دلایل احتمالی:
| خطا را اصلاح کنید و پس از ذخیره تغییرات، دوباره امتحان کنید. |
| ۴۵۰۱۶ | درخواست بهروزرسانی، ایجاد یا حذف منبع توسط برنامه مبتنی بر SCIM شما پذیرفته نشد زیرا فیلد الزامی را وارد نکردهاید. جزئیات خطا را در فایل خطای دانلود شده مشاهده کنید. | خطا را اصلاح کنید و پس از ذخیره تغییرات، دوباره امتحان کنید. |