اتصال کانفلوئنس به LDAP

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

پیش‌نیازها

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

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

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

---

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

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

---

تنظیمات سرور و Schema

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

---

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

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

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

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

---

فهرست User Directories

از طریق گزینه‌های Disable، Edit، Test و Synchronize مقابل هر دایرکتوری، به‌ترتیب می‌توان آن را غیرفعال کرد ویرایش کرد، اتصال را دوباره تست کرد یا هم‌گام‌سازی دستی انجام داد. زمان و نتیجه آخرین هم‌گام‌سازی هم زیر همین گزینه‌ها نمایش داده می‌شود.

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