Gmail را با استفاده از گوگل OAuth به ستکا متصل کنید
ستکا با OAuth گوگل برای جیمیل سازگار است. برای ارسال ایمیل های ایمن از یک دامنه سفارشی، تنها چیزی که لازم است پیکربندی چند تنظیمات در پلتفرم فضای کاری گوگل و همچنین در انتهای پایگاه داده ستکا است. این پیکربندی با استفاده از یک آدرس ایمیل شخصی یا یک آدرس ایجاد شده توسط یک دامنه سفارشی کار می کند.
راه اندازی در گوگل
یک پروژه جدید ایجاد کنید
برای شروع، به کنسول گوگل API بروید. اگر حساب فضای کاری گوگل خود را دارید وارد شوید، در غیر این صورت با حساب جیمیل شخصی خود وارد شوید (این باید با آدرس ایمیلی که می خواهید در ستکا پیکربندی کنید مطابقت داشته باشد).
پس از آن، روی ایجاد پروژه، واقع در سمت راست صفحه رضایت OAuth کلیک کنید. اگر پروژه ای قبلاً در این حساب ایجاد شده باشد، گزینه پروژه جدید در سمت راست بالای منوی کشویی انتخاب پروژه قرار خواهد گرفت.
در صفحه پروژه جدید، نام پروژه را به ستکا تغییر دهید و مکان را جستجو کنید. مکان را به عنوان سازمان فضای کاری گوگل تنظیم کنید. اگر از یک حساب شخصی جیمیل استفاده می کنید، مکان را به عنوان بدون سازمان رها کنید.
برای اتمام این مرحله بر روی ایجاد کنید کلیک کنید.
صفحه رضایت OAuth
اگر صفحه به گزینه های نوع کاربر هدایت نمی شود، روی صفحه رضایت OAuth در منوی سمت چپ کلیک کنید.
در زیر گزینه های نوع کاربر، نوع کاربری مناسب را انتخاب کنید و سپس دوباره روی ایجاد کنید کلیک کنید، که در نهایت به صفحه ویرایش ثبت برنامه هدایت می شود.
ویرایش ثبت برنامه
در مرحله بعد، ثبت برنامه پروژه را پیکربندی می کنیم.
در مرحله صفحه رضایت OAuth، در بخش اطلاعات برنامه، ستکا را در قسمت نام برنامه وارد کنید. آدرس ایمیل سازمان را در قسمت ایمیل پشتیبانی کاربر انتخاب کنید.
سپس در قسمت دامنه برنامه دامنه های مجاز، روی دامنه اضافه کنید کلیک کرده و satkaerp.com را وارد کنید.
پس از آن، در قسمت اطلاعات تماس توسعه‌دهنده، آدرس ایمیل سازمان را وارد کنید. گوگل از این آدرس ایمیل برای اطلاع دادن به سازمان در مورد هر گونه تغییر در پروژه شما استفاده می کند.
در مرحله بعد روی دکمه ذخیره و ادامه دهید کلیک کنید. سپس، با اسکرول کردن به پایین و کلیک بر روی ذخیره و ادامه دهید، از صفحه محدوده ها رد شوید.
اگر در حالت تست (خارجی) ادامه می دهید، آدرس های ایمیل در حال پیکربندی را در مرحله تست کاربران با کلیک روی افزودن کاربران و سپس دکمه ذخیره و ادامه اضافه کنید. خلاصه ای از ثبت برنامه ظاهر می شود.
در نهایت به پایین بروید و روی بازگشت به داشبورد کلیک کنید تا راه اندازی پروژه به پایان برسد.
اعتبارنامه ایجاد کنید
اکنون که پروژه راه اندازی شده است، باید اعتبارنامه هایی ایجاد شود که شامل شناسه مشتری و راز مشتری می شود. ابتدا در منوی نوار کناری سمت چپ بر روی اعتبارنامه کلیک کنید.
سپس، روی اعتبارنامه ایجاد کنید در منوی بالا کلیک کنید و OAuth شناسه مشتری را از منوی کشویی انتخاب کنید.
- در قسمت نوع برنامه، از منوی کشویی برنامه وب را انتخاب کنید.
- در قسمت نام، ستکا را وارد کنید.
- در زیر برچسب مجاز URI ها هدایت می شوند، روی دکمه URI را اضافه کنید کلیک کنید و سپس satkaerp.com را در قسمت URIs 1 وارد کنید. مطمئن شوید که قسمت yourdbname آدرس را با نام واقعی پایگاه داده ستکا جایگزین کنید.
- سپس روی ایجاد کنید کلیک کنید تا یک شناسه مشتری OAuth و راز مشتری ایجاد شود. در نهایت، هر مقدار تولید شده را برای استفاده بعدی هنگام پیکربندی در ستکا کپی کنید و سپس به پایگاه داده ستکا بروید.
راه اندازی در ستکا
اعتبار گوگل را وارد کنید
ابتدا ستکا را باز کرده و به ماژول برنامه ها بروید. سپس فیلتر برنامه ها را از نوار جستجو بردارید و در گوگل تایپ کنید. ماژولی به نام گوگل جیمیل را نصب کنید.
در مرحله بعد، به تنظیمات تنظیمات عمومی بروید و در بخش بحث، مطمئن شوید که کادر انتخاب سرورهای ایمیل سفارشی یا سرورهای ایمیل خارجی علامت زده شده است. این گزینه جدید برای اعتبارنامه های جیمیل یا استفاده از سرور جیمیل را پر می کند. سپس مقادیر مربوطه را در قسمت شناسه مشتری و راز مشتری کپی کرده و تنظیمات را ذخیره کنید.
سرور ایمیل خروجی را پیکربندی کنید
برای پیکربندی حساب خارجی جیمیل، به بالای تنظیمات سرورهای ایمیل سفارشی برگردید و سپس روی پیوند سرورهای ایمیل خروجی کلیک کنید.
سپس روی جدید یا ایجاد کلیک کنید تا یک سرور ایمیل جدید ایجاد شود و نام، توضیحات و نام کاربری ایمیل (در صورت نیاز) را وارد کنید.
سپس روی احراز هویت جیمیل OAuth یا جیمیل (در بخش احراز هویت با یا اتصال) کلیک کنید. در نهایت بر روی حساب جیمیل خود را وصل کنید کلیک کنید.
پنجره جدیدی با عنوان گوگل برای تکمیل فرآیند مجوز باز می شود. آدرس ایمیل مناسبی را که در ستکا پیکربندی می شود انتخاب کنید.
اگر آدرس ایمیل یک حساب شخصی است، یک مرحله اضافی ظاهر می‌شود، بنابراین برای تأیید تأیید روی ادامه کلیک کنید و حساب جیمیل را به ستکا متصل کنید.
سپس با کلیک بر روی ادامه دهید یا اجازه دهید به ستکا اجازه دسترسی به حساب گوگل را بدهید. پس از آن، صفحه به سرور ایمیل خروجی تازه پیکربندی شده در ستکا باز می گردد. پیکربندی به طور خودکار توکن را در ستکا بارگیری می‌کند و برچسبی که نشان می‌دهد توکن جیمیل معتبر است به رنگ سبز ظاهر می‌شود.
در نهایت اتصال را تست کنید. یک پیام تأیید باید ظاهر شود. پایگاه داده ستکا اکنون می تواند ایمیل های ایمن و ایمن را از طریق گوگل با استفاده از احراز هویت OAuth ارسال کند.
سوالات متداول Google OAuth
وضعیت انتشار در مقابل تست تولید
انتخاب تولید به‌عنوان وضعیت انتشار (به‌جای آزمایش) پیام هشدار زیر را نمایش می‌دهد:
برای اصلاح این هشدار، به پلتفرم گوگل API بروید. اگر وضعیت انتشار در مرحله تولید است، روی بازگشت به تست کلیک کنید تا مشکل را اصلاح کنید.
هیچ کاربر آزمایشی اضافه نشده است
اگر هیچ کاربر آزمایشی به صفحه رضایت OAuth اضافه نشود، خطای عدم دسترسی 403 پر می شود.
برای تصحیح این خطا، به صفحه رضایت OAuth در زیر API ها و خدمات برگردید و کاربر(های) آزمایشی را به برنامه اضافه کنید. ایمیلی را که در ستکا پیکربندی می کنید اضافه کنید.
ماژول جیمیل به روز نشد
اگر ماژول API ها و خدمات در ستکا به آخرین نسخه به روز نشده باشد، یک پیام خطای ممنوع پر می شود.
برای تصحیح این خطا، به ماژول برنامه ها بروید و عبارات جستجو را پاک کنید. سپس، جیمیل یا گوگل را جستجو کنید و ماژول گوگل جیمیل را ارتقا دهید. در نهایت روی سه نقطه سمت راست بالای ماژول کلیک کرده و ارتقا را انتخاب کنید.
نوع برنامه
هنگام ایجاد اعتبارنامه ها (شناسه مشتری OAuth و راز مشتری)، اگر برنامه دسکتاپ برای نوع برنامه انتخاب شده باشد، یک خطای مجوز ظاهر می شود.
برای تصحیح این خطا، اعتبارنامه هایی که قبلا ایجاد شده را حذف کرده و اعتبارنامه های جدیدی ایجاد کنید و برنامه وب را برای نوع برنامه انتخاب کنید. سپس، در قسمت URIهای مجاز تغییر مسیر، روی افزودن URI کلیک کنید و تایپ کنید: satkaerp.com در فیلد، مطمئن شوید که نام یوردی بی نام را در آدرس اینترنتی با نام پایگاه داده ستکا جایگزین کنید.
