احراز هویت: Active Directory
مدت زمان مطالعه: : 5 دقیقه
این اسکریپت TestRail به شما این امکان را می دهد که TestRail را با یک سرویس Active Directory برای پیاده سازی Single sign-on و ایجاد حساب های کاربری اولیه TestRail ادغام کنید. بخشهای زیر نحوه نصب، پیکربندی و سفارشیسازی ادغام Active Directory را توضیح میدهند. برای کسب اطلاعات بیشتر در مورد اسکریپت های احراز هویت TestRail، لطفاً جزئیات را ببینید راهنمای اجرا.
لطفا توجه داشته باشید: حتی اگر احراز هویت را می توان از طریق Active Directory انجام داد، هر کاربر همچنان به یک حساب کاربری معتبر TestRail نیاز دارد. حساب های کاربری TestRail هنوز برای تنظیمات کاربر خاص TestRail و دلایل دیگر مورد نیاز است. ماژول احراز هویت TestRail به اسکریپت ها اجازه می دهد تا در صورت نیاز به صورت شفاف حساب های کاربری ایجاد کنند و این اسکریپت احراز هویت برای Active Directory به طور کامل از این ویژگی پشتیبانی می کند، اما همچنان باید از این واقعیت آگاه باشید.
دانلود کنید #
می توانید آخرین نسخه اسکریپت احراز هویت Active Directory را از اینجا دانلود کنید:
اسکریپت یکپارچه سازی اکتیو دایرکتوری #
اسکریپتی برای ادغام TestRail با Active Directory
الزامات #
برای استفاده از این اسکریپت، چند الزام وجود دارد که باید رعایت شود. از آنجایی که سرویس دایرکتوری اکتیو دایرکتوری از طریق پروتکل LDAP پرس و جو می شود، TestRail برای ادغام با اکتیو دایرکتوری به پسوند PHP LDAP نیاز دارد. اگر از TestRail تحت لینوکس میزبانی می کنید، معمولاً می توانید بسته LDAP را با مدیر بسته خود نصب کنید. به عنوان مثال اوبونتو:
$ sudo apt-get install php7.2-ldapاگر از ویندوز سرور برای میزبانی TestRail استفاده می کنید، پسوند LDAP از قبل همراه با PHP نصب شده است. شما فقط باید آن را در فایل PHP.ini خود فعال کنید. برای این منظور، فقط خط زیر را به فایل PHP.ini اضافه کنید:
extension=php_ldap.dllفراموش نکنید که IIS را مجددا راه اندازی کنید تا تغییرات را فعال کنید.
برای برخی از نسخه های قبلی PHP و ویندوز، می توانید انتخاب کنید برنامه ها & ویژگی ها از کنترل پنل ویندوز سپس راست کلیک کنید PHP، انتخاب کنید تغییر، و پسوند LDAP را نصب کنید.
اکتیو دایرکتوری: از آنجایی که TestRail از آدرس ایمیل کاربر به عنوان شناسه حساب منحصر به فرد استفاده می کند، TestRail برای احراز هویت به آدرس ایمیل کاربران نیاز دارد. این اسکریپت انتظار دارد که فیلد آدرس ایمیل کاربر Active Directory دارای یک آدرس ایمیل منحصر به فرد معتبر باشد. لطفاً در صورتی که قبلاً این مورد را ندارید، آدرس های ایمیل را به اشیاء کاربری خود در اکتیو دایرکتوری اضافه کنید. میتوانید این اسکریپت را تغییر دهید تا به طور خودکار آدرس ایمیل بر اساس نام ورود ایجاد شود.
پیکربندی #
قبل از نصب اسکریپت (لطفاً به بخش بعدی برای دستورالعملهای نصب مراجعه کنید)، باید اسکریپت را با تنظیمات Active Directory خود پیکربندی کنید. برای پیکربندی اسکریپت، به سادگی اسکریپت را در یک ویرایشگر متن باز کنید و تنظیمات ابتدای فایل را تغییر دهید.
ثابت ها در جدول زیر توضیح داده شده اند.
| ثابت | توضیحات |
|---|---|
AUTH_HOST |
نام دامنه کاملاً واجد شرایط سرور دایرکتوری فعال. مثال: ad1.directory.example.com |
AUTH_PORT |
پورت LDAP سرور دایرکتوری. این معمولاً ۳۸۹ است. |
AUTH_DN |
نام اصلی LDAP برای یافتن و احراز هویت کاربران در برابر آن. این باید حداقل شامل ورودی های بالای OU، CN و/یا DC باشد. این معمولاً شامل نام دامنه و سازمان یا گروه کاربران است. مثال ۱: CN = کاربران، DC = دایرکتوری، DC = مثال، DC = com مثال ۲: OU = Example Inc، DC = دایرکتوری، DC = مثال، DC = com همچنین اگر میخواهید فقط به کاربران خاصی اجازه دهید با TestRail احراز هویت کنند، میتوانید گروههای کاربری خاصی را نیز مشخص کنید. |
AUTH_DOMAIN |
نام دامنه ای که ویندوز استفاده می کند (این نامی است که اغلب به عنوان پیشوند نام های کاربری مانند directory\bob استفاده می شود) مثال: دایرکتوری |
AUTH_CREATE_ACCOUNT |
این تنظیمات پیکربندی مشخص میکند که اگر یک کاربر با موفقیت احراز هویت شود، TestRail باید به طور خودکار حسابهای کاربری جدیدی در TestRail ایجاد کند. این یک راه عالی برای ایجاد تمام حساب های کاربری لازم در سازمان شما بدون ایجاد حساب های TestRail به صورت دستی است. به سادگی این گزینه را روی true تنظیم کنید و برای همه کاربران یک ایمیل با آدرس وب TestRail ارسال کنید. حسابهای کاربری برای اولین بار بهطور خودکار ایجاد میشوند. |
AUTH_FALLBACK |
به کاربران اجازه دهید تا علاوه بر ورود به Active Directory، با اعتبار TestRail خود وارد سیستم شوند. در صورت فعال بودن، TestRail سعی می کند تا در صورت وارد کردن آدرس ایمیل، کاربر را با اعتبار TestRail خود احراز هویت کند. اگر نام کاربری وارد شده باشد، TestRail کاربر را در مقابل Active Directory احراز هویت می کند. |
AUTH_MEMBERSHIP |
به صورت اختیاری تأیید می کند که آیا کاربر عضو گروه(های امنیتی) مشخص شده است یا خیر. این باید یک عبارت منظم باشد که در برابر تمام مقادیر MemberOf بررسی شود. اگر یکی از ورودی ها مطابقت داشته باشد، کاربر احراز هویت می شود. اگر هیچ یک از مقادیر MemberOf مطابقت نداشته باشد، دسترسی ممنوع است. مثال: /^CN=گروه من،/ |
نصب و راه اندازی #
برای نصب این اسکریپت به سادگی آن را در خود قرار دهید custom/auth/ دایرکتوری نصب TestRail شما هنگامی که اسکریپت به TestRail اضافه شد، برای احراز هویت کاربران استفاده خواهد شد. همچنین می توانید مسیر و وضعیت دقیق اسکریپت احراز هویت را در TestRail در زیر مشاهده کنید مدیر > تنظیمات سایت > وارد شوید. برای غیرفعال کردن اسکریپت، به سادگی آن را حذف یا تغییر نام دهید auth.php فایل سپس کاربران می توانند با آدرس ایمیل و رمز عبور TestRail وارد سیستم شوند.
