اتصال جیرا به LDAP

با اتصال Jira به یک دایرکتوری LDAP (پروتکل دسترسی به دایرکتوری سبک)، مدیریت کاربران و گروه‌ها به یک دایرکتوری سازمانی مرکزی (مثل Active Directory یا OpenLDAP) منتقل می‌شود و ادمین‌ها می‌توانند حساب‌ها و دسترسی‌ها را از یک منبع واحد کنترل کنند.

پیش‌نیازها

• یک سرویس فعال Jira و دسترسی ادمین
• یک سرور LDAP یا Active Directory در دسترس از شبکه Jira

برای راه‌اندازی یک سرور OpenLDAP آزمایشی روی هم‌روش، راهنمای ساخت اپ دارکوبی LDAP در دسترس است؛ داده‌های نمونه آن راهنما (ساختار OU، کاربران و گروه‌های آزمایشی) با مقادیر همین راهنما هماهنگ طراحی شده‌اند تا فرایند ادغام به‌صورت کامل از ابتدا تا انتها قابل بررسی باشد.

این راهنما یکی از روش‌های ممکن برای فعال‌سازی LDAP در Jira را شرح می‌دهد و روش‌های جایگزین را پوشش نمی‌دهد.

---

دسترسی به تنظیمات User Directories

1. از آیکون چرخ‌دنده (⚙️) در گوشه بالا-راست صفحه، گزینه User Management انتخاب می‌شود.
2. در منوی سمت چپ، گزینه User Directories انتخاب می‌شود.
3. روی دکمه Add Directory کلیک شده و از لیست نوع دایرکتوری، گزینه LDAP انتخاب می‌شود (برای Active Directory، گزینه Microsoft Active Directory مناسب‌تر است).

---

تنظیمات سرور (Server Settings) و Schema

1. یک نام برای این دایرکتوری در فیلد Name وارد می‌شود؛ برای مثال «LDAP سازمان».
2. نوع سرور LDAP در فیلد Directory Type انتخاب می‌شود.
3. آدرس سرور در فیلد Hostname و پورت اتصال (معمولاً ۳۸۹ یا ۶۳۶ برای SSL) در فیلد Port وارد می‌شود.
4. در صورت نیاز به اتصال رمزنگاری‌شده، گزینه Use SSL فعال می‌شود.
5. مشخصات حساب سرویس برای اتصال به دایرکتوری، در فیلدهای Username و Password وارد می‌شود.
6. ریشه جست‌وجو در دایرکتوری، در فیلد Base DN وارد می‌شود؛ برای مثال dc=example,dc=org.
7. مسیر اضافی برای جست‌وجوی کاربران و گروه‌ها به‌ترتیب در فیلدهای Additional User DN و Additional Group DN وارد می‌شود.

---

نگاشت صفت‌های کاربر (User Schema Settings)

در بخش User Schema Settings همان صفحه، نگاشت صفت‌های کاربر در LDAP مشخص می‌شود:

فیلد	توضیحات	مقدار نمونه
User Object Class	کلاس شیء کاربر در LDAP	inetorgperson
User Object Filter	فیلتر جست‌وجوی کاربران	(objectclass=inetorgperson)
User Name Attribute	صفت نام کاربری	uid
User First Name Attribute	صفت نام کاربر	givenName
User Last Name Attribute	صفت نام خانوادگی کاربر	sn
User Display Name Attribute	صفت نام نمایشی کاربر	displayName
User Email Attribute	صفت ایمیل کاربر	mail

---

سطح دسترسی و ذخیره تنظیمات

1. یکی از سطوح دسترسی Read Only، Read Only, with Local Groups یا Read/Write انتخاب می‌شود؛ بسته به این‌که آیا Jira اجازه ویرایش اطلاعات دایرکتوری را داشته باشد یا خیر.
2. در فیلد Default Group Memberships، نام گروهی که کاربران LDAP در اولین ورود عضو آن می‌شوند مشخص می‌شود؛ برای مثال jira-software-users.
3. با گزینه Test Settings، صحت اطلاعات وارد شده بررسی می‌شود.
4. با کلیک روی Save، دایرکتوری ذخیره می‌شود.

پس از ذخیره، دایرکتوری جدید در فهرست User Directories نمایش داده می‌شود.

کاربرانی که از طریق LDAP همگام‌سازی می‌شوند، تنها زمانی امکان ورود (Login) به Jira را خواهند داشت که عضو گروهی با دسترسی مناسب در Jira باشند. این گروه در فیلد Default Group Memberships مشخص می‌شود (برای مثال jira-software-users)؛ در غیر این صورت، هرچند کاربر در فهرست کاربران Jira دیده شود، اجازه ورود نخواهد داشت.

اگر Jira به بیش از یک دایرکتوری متصل باشد، ترتیب دایرکتوری‌ها در همین صفحه و با فلش‌های آبی‌رنگ قابل تغییر است. این ترتیب مشخص می‌کند کدام دایرکتوری برای جست‌وجوی کاربر در اولویت قرار دارد.