ورود به بخش ایجاد Credential
برای شروع باید وارد محیط n8n شوید. در بالای صفحه سه تب وجود دارد که از بین گزینهها Credential را انتخاب کنید. این بخش جایی است که میتوانید اطلاعات هویتی خود برای اتصال به سرویسهای مختلف را ذخیره کنید.
اگر نسخه n8n شما از قابلیت «پروژهها» پشتیبانی میکند، در این مرحله باید تصمیم بگیرید Credential را در فضای شخصی خود ایجاد کنید یا در یک پروژه خاص. این موضوع به سطح دسترسی شما بستگی دارد. اگر از نسخه Community استفاده میکنید، Credential همیشه در فضای شخصی ساخته میشود.
ایجاد Credential
برای ساخت یک Credential جدید کافی است روی دکمه «+» در بالای سمت راست صفحه کلیک کنید و گزینه «Create Credential» را انتخاب کنید.
سپس لیستی از سرویسها و اپلیکیشنها نمایش داده میشود. کافی است سرویس موردنظر را انتخاب کنید تا فرم مربوط به آن باز شود. برای مثال میتوانید به یک پایگاه داده، API یا اپلیکیشن پیامرسان متصل شوید.
همچنین زمانی که یک نود در ویرایشگر ورکفلو را باز میکنید و منوی کشویی بخش Credential را مشاهده میکنید، گزینه Create new نمایش داده میشود. با انتخاب این گزینه میتوانید همانجا یک Credential جدید برای همان سرویس ایجاد کنید.
تکمیل فرم Credential
بعد از انتخاب سرویس، یک فرم باز میشود که باید اطلاعات موردنیاز آن سرویس را وارد کنید. این اطلاعات ممکن است شامل API Key، Client ID، Client Secret یا Token باشد (بسته به نوع سرویس، فیلدها متفاوت هستند.).
ذخیره و تست Credential
بعد از وارد کردن اطلاعات روی دکمه Save کلیک کنید. در این مرحله n8n به صورت خودکار Credential شما را بررسی میکند تا از صحت اتصال مطمئن شود. اگر مشکلی وجود داشته باشد پیام خطا نشان داده میشود و لازم است مقادیری مثل Token یا آدرس پایه (Base URL) را دوباره بررسی کنید. همچنین بعضی سرویسها محدودیت تعداد درخواست دارند (Rate Limit) که میتواند دلیل خطا باشد.
برای مدیریت بهتر، Credentialهایی را که دیگر استفاده نمیشوند حذف کنید تا محیط کار مرتبتر و امنتر بماند.
ویرایش Credential موجود
در هر زمانی میتوانید به لیست Credentialها بروید و روی سه نقطه آخر کلیک کنید و روی دکمه OPEN بزنید تا باز شود. سپس میتوانید اطلاعات آن را ویرایش کرده و دوباره ذخیره کنید. پس از ذخیره مجدد، n8n به صورت خودکار بررسی میکند که Credential همچنان معتبر باشد.
استفاده از Expressionها در Credential
گاهی لازم است مقدار Credentialها بهصورت دینامیک از دادههای موجود در ورکفلو پر شود. برای این کار میتوانید از Expression استفاده کنید. کافیست روی فیلد موردنظر در فرم Credential بروید و حالت Expression را فعال کنید. سپس عبارت دلخواه را وارد کنید. برای مثال اگر مقدار کلید در $json.apiKey قرار دارد، کافی است بنویسید:
{{$json.apiKey}}
مطمئن شوید که هنگام اجرای نود، این داده در ورکفلو وجود دارد.
نکات مربوط به دسترسی و فضا
Credentialهایی که در فضای شخصی (Personal Space) ساخته میشوند فقط توسط شما قابل استفاده هستند. اما Credentialهایی که در پروژه ساخته میشوند، برای همه اعضای همان پروژه در دسترس خواهند بود. بنابراین هنگام اشتراکگذاری یک ورکفلو، مطمئن شوید Credential مربوطه در فضای درست ایجاد شده باشد.
استفاده از Credential در نودها
برای هر نود در ورکفلو میتوانید Credential مرتبط را انتخاب کنید. بعد از انتخاب Credential، بهتر است یک اجرای آزمایشی انجام دهید تا مطمئن شوید نود به سرویس مقصد متصل میشود.
