اعتبارات نوتیون#
می‌توانید از این اعتبارنامه‌ها برای احراز هویت نودهای زیر استفاده کنید:
پیش‌نیازها#
یک حساب کاربری نوتیون با دسترسی سطح ادمین ایجاد کنید.
روش‌های پشتیبانی شده برای احراز هویت#
- توکن یکپارچه‌سازی API: برای یکپارچه‌سازی‌های داخلی استفاده می‌شود.
- OAuth2: برای یکپارچه‌سازی‌های عمومی استفاده می‌شود.
نوع یکپارچه‌سازی
مطمئن نیستید کدام نوع یکپارچه‌سازی را استفاده کنید؟ برای اطلاعات بیشتر، به یکپارچه‌سازی‌های داخلی در مقابل عمومی در قسمت زیر مراجعه کنید.
منابع مرتبط#
برای اطلاعات بیشتر درباره سرویس، به مستندات API نوتیون مراجعه کنید.
استفاده از توکن یکپارچه‌سازی API#
برای پیکربندی این اعتبارنامه، نیاز دارید به:
- یک کلید مخفی یکپارچه‌سازی داخلی: که پس از ایجاد یک یکپارچه‌سازی نوتیون تولید می‌شود.
برای تولید یک کلید مخفی یکپارچه‌سازی، یکپارچه‌سازی نوتیون بسازید و کلید مخفی را از تب کلیدهای مخفی بردارید:
- به داشبورد یکپارچه‌سازی‌های نوتیون مراجعه کنید.
- روی دکمه + یکپارچه‌سازی جدید کلیک کنید.
- نامی برای یکپارچه‌سازی خود وارد کنید، مثلا
یکپارچه‌سازی n8n. در صورت تمایل، یک لوگو اضافه کنید. - برای ایجاد یکپارچه‌سازی، روی ثبت کلیک کنید.
- برگه قابلیت‌ها را باز کنید و قابلیت‌های زیر را فعال کنید:
-
خواندن محتوا-به‌روزرسانی محتوا-درج محتوا-اطلاعات کاربر بدون ایمیل‌ها - مطمئن شوید که تغییرات را ذخیره کنید.
- برگه کلیدهای مخفی را باز کنید.
- توکن یکپارچه‌سازی داخلی را کپی کنید و به‌عنوان کلید مخفی یکپارچه‌سازی داخلی در نوتیون وارد کنید.
برای اطلاعات بیشتر درباره روند احراز هویت و راه‌اندازی جریان، به مستندات راه‌اندازی جریان احراز هویت درون‌گیرای نوتیون مراجعه کنید.
اشتراک‌گذاری صفحه‌های نوتیون با یکپارچه‌سازی#
برای تعامل یکپارچه‌سازی شما با نوتیون، باید مجوز صفحه یکپارچه‌سازی خود را بدهید تا بتوانید با صفحه‌ها در فضای کاری نوتیون تعامل کنید:
- به صفحه در فضای کاری نوتیون خود بروید.
- منوی سه نقطه در بالای سمت راست صفحه را انتخاب کنید.
- در بخش اتصالات، روی کانکشن به کلیک کنید.
- از نوار جستجو، یکپارچه‌سازی خود را پیدا و انتخاب کنید.
پس از اشتراک‌گذاری حداقل یک صفحه با یکپارچه‌سازی، می‌توانید درخواست‌های API را آغاز کنید. اگر صفحه به اشتراک گذاشته نشده باشد، درخواست‌های API داده‌شده با خطا پاسخ خواهند داد.
برای اطلاعات بیشتر، به مجوزهای یکپارچه‌سازی مراجعه کنید.
استفاده از OAuth2#
برای پیکربندی این اعتبارنامه، نیاز دارید به:
- یک شناسه کلاینت: که پس از پیکربندی یکپارچه‌سازی عمومی تولید می‌شود.
- یک کلید مخفی کلاینت: که پس از پیکربندب یکپارچه‌سازی عمومی تولید می‌شود.
شما باید یکپارچه‌سازی نوتیون بسازید و آن را در حالت عمومی قرار دهید:
- به داشبورد یکپارچه‌سازی‌های نوتیون بروید.
- روی دکمه + یکپارچه‌سازی جدید کلیک کنید.
- نامی برای یکپارچه‌سازی خود وارد کنید، مثلا
یکپارچه‌سازی n8n. در صورت تمایل، یک لوگو اضافه کنید. - برای ایجاد یکپارچه‌سازی، روی ثبت کلیک کنید.
- برگه قابلیت‌ها را باز کنید و قابلیت‌های زیر را فعال کنید:
-
خواندن محتوا-به‌روزرسانی محتوا-درج محتوا-اطلاعات کاربر بدون ایمیل‌ها - روی ذخیره تغییرات کلیک کنید.
- برگه توزیع را باز کنید.
- کنترل آیا می‌خواهید این یکپارچه‌سازی عمومی باشد؟ را فعال کنید.
- نام شرکت و وب‌سایت خود را در بخش اطلاعات سازمانی وارد کنید.
- آدرس قرارگیری مجدد (Redirect URL) نوتیون که در نوتیون ثبت شده است را کپی کرده و در بخش دامنه و URLهای OAuth در تنظیمات یکپارچه‌سازی نوتیون به عنوان Redirect URI قرار دهید.
- برگه کلیدهای مخفی را باز کنید.
- شناسه کلاینت و کلید مخفی کلاینت را کپی کنید و در اعتبارنامه نوتیون خود وارد کنید.
برای اطلاعات بیشتر درباره فرآیندهای احراز هویت عمومی و راه‌اندازی، به مستندات راه‌اندازی جریان احراز هویت عمومی در نوتیون مراجعه کنید.
یکپارچه‌سازی‌های داخلی در مقابل عمومی#
یکپارچه‌سازی‌های داخلی:
- مخصوص یک فضای کاری خاص هستند.
- تنها برای اعضای همان فضای کاری قابل دسترسی هستند.
- مناسب برای بهبود ویژگی‌های سفارشی فضای کاری.
یکپارچه‌سازی‌های داخلی از روند ساده‌تری برای احراز هویت (کلید مخفی یکپارچه‌سازی) استفاده می‌کنند و نیازمند بررسی امنیتی پیش از انتشار نیستند.
یکپارچه‌سازی‌های عمومی:
- قابلیت استفاده در چندین فضای کاری نوتیون غیرمرتبط.
- قابل دسترسی برای هر کاربر نوتیون، بدون توجه به فضای کاری.
- مناسب برای برآورده کردن موارد استفاده گسترده.
این نوع یکپارچه‌سازی‌ها از پروتکل OAuth 2.0 برای احراز هویت استفاده می‌کنند و قبل از انتشار باید از نظر امنیتی توسط نوتیون بررسی شوند.
برای توضیحات بیشتر در مورد دو نوع یکپارچه‌سازی، به مستندات داخلی در مقابل عمومی نوتیون مراجعه کنید.