اعتبارنامههای استریپی#
میتوانید از این اعتبارنامهها برای احراز هویت نودهای زیر استفاده کنید:
پیشنیازها#
یک حساب ادمین استریپی بسازید که شامل موارد زیر باشد:
- دسترسی به یک پروژه استریپی موجود.
- حداقل یک نوع مجموعه در آن پروژه.
- دادههای منتشر شده در آن نوع مجموعه.
برای اطلاعات بیشتر، به راهنمای سریع شروع توسعهدهنده استریپی مراجعه کنید.
روشهای پشتیبانیشده احراز هویت#
- حساب کاربری API: نیاز به یک حساب کاربری با مجوزهای محتوای مناسب دارد.
- توکن API: نیاز به حساب کاربری ادمین دارد.
منابع مرتبط#
برای اطلاعات بیشتر درباره سرویس، به مستندات استریپی مراجعه کنید.
استفاده از حساب کاربری API#
برای پیکربندی این اعتبارنامه، نیاز دارید به:
- ایمیل کاربر: باید مربوط به یک حساب کاربری باشد، نه حساب ادمین. جزئیات بیشتر در دستورالعملهای زیر آمده است.
- گذرواژه کاربر: باید مربوط به یک حساب کاربری باشد، نه حساب ادمین. جزئیات بیشتر در دستورالعملهای زیر آمده است.
- آدرس URL: از آدرس عمومی سرور استریپی خود استفاده کنید، که در
./config/server.js
به عنوان پارامترurl
تعریف شده است. استریپی توصیه میکند از یک آدرس مطلق استفاده کنید. - برای پروژههای استریپی کلود، از آدرس پروژه کلود خود استفاده کنید، مثلا:
https://my-strapi-project-name.strapiapp.com
- نسخه API: نسخهای از API که میخواهید درخواستهایتان از آن استفاده کنند را انتخاب کنید. گزینهها عبارتند از:
- نسخه ۳
- نسخه ۴
در استریپی، پیکربندی شامل دو مرحله است:
جزئیات هر مرحله در زیر آمده است.
پیکربندی نقش#
برای دسترسی API، از پلاگین کاربران و مجوزها در تنظیمات > پلاگین کاربران و مجوزها استفاده کنید.
برای اطلاعات بیشتر، به پیکربندی پلاگین کاربران و مجوزها مراجعه کنید. برای اطلاعات درباره نقشها، به پیکربندی نقشهای کاربر نهایی مراجعه نمایید.
برای اعتبارنامه n8n، کاربر باید نقش داشته باشد که مجوزهای API را برای نوع مجموعه بدهد. برای نقش، میتوانید:
- نقش پیشفرض احراز هویتشده را بروزرسانی کنید تا مجوزها در آن قرار گیرد و کاربر را به آن نقش اختصاص دهید. برای این کار، به پیکربندی مجوزهای نقش مراجعه کنید.
- نقش جدیدی ایجاد کنید و مجوزها را در آن قرار دهید و کاربر را به آن نقش اختصاص دهید. جزئیات در ایجاد نقش جدید آمده است.
در هر حالت، پس از باز کردن نقش:
- به بخش مجوزها بروید.
- بخش مربوط به نوع مجموعه مرتبط را باز کنید.
- مجوزهای مربوط به نوع مجموعهای که باید داده شود را انتخاب کنید. گزینهها شامل موارد زیر است:
-
create
(POST) -find
وfindone
(GET) -update
(PUT) -delete
(DELETE) - این کار را برای تمام نوعهای مجموعه مربوط تکرار کنید.
- نقش را ذخیره کنید.
برای جزئیات بیشتر در مورد گزینههای مجوز، به نقاط پایانی مراجعه کنید.
ایجاد حساب کاربری#
حالا که نقش مناسب را دارید، یک حساب کاربری نهایی ساخته و نقش را به آن اختصاص دهید:
- به مدیریت محتوا > نوعهای مجموعه > کاربر بروید.
- گزینه افزودن ورودی جدید را انتخاب کنید.
- جزئیات کاربر را وارد کنید. اعتبارنامه n98n به این فیلدها نیاز دارد، هرچند ممکن است پروژه استریپی شما فیلدهای سفارشی بیشتری داشته باشد: - نام کاربری: برای همه کاربران استریپی الزامی است. - ایمیل: در استریپی وارد کنید و به عنوان ایمیل در اعتبارنامه n98n استفاده کنید. - گذرواژه: در استریپی وارد کنید و به عنوان گذرواژه در اعتبارنامه n98n استفاده کنید. - نقش: نقش که در مرحله قبل تنظیم کردید را انتخاب کنید.
برای جزئیات بیشتر، به مدیریت حسابهای کاربر نهایی مراجعه کنید.
استفاده از توکن API#
برای پیکربندی این اعتبارنامه، نیاز دارید به:
- توکن API: از بخش تنظیمات > تنظیمات کلی > توکنهای API یک توکن API بسازید. برای جزئیات بیشتر، به مستندات ساختن توکن جدید API در استریپی مراجعه کنید و اطلاعات مربوط به بازتولید توکنهای API را مطالعه کنید.
سطح دسترسی توکنهای API
اگر بخش توکنهای API را در تنظیمات کلی نمیبینید، حساب کاربری شما مجوز خواندن توکنهای API را ندارد.
- آدرس URL: از آدرس عمومی سرور استریپی خود استفاده کنید که در
./config/server.js
به عنوان پارامترurl
تعریف شده است. استریپی توصیه میکند از یک آدرس مطلق استفاده کنید. - برای پروژههای استریپی کلود، از آدرس پروژهتان در کلود استفاده کنید، مثلا:
https://my-strapi-project-name.strapiapp.com
- نسخه API: نسخهای از API که میخواهید درخواستهایتان از آن استفاده کنند را انتخاب کنید. گزینهها شامل موارد زیر است:
- نسخه ۳
- نسخه ۴