เชื่อมต่อ ownCloud Infinite Scale กับ LDAP เพื่อการลงชื่อเข้าใช้ของผู้ใช้

ในการใช้ไดเร็กทอรี LDAP ที่มีอยู่แล้วกับ ownCloud Infinite Scale (oCIS) ให้กำหนดค่าผู้ให้บริการข้อมูลประจำตัว (IDP) OpenID Connect ในตัวเพื่อตรวจสอบสิทธิ์ผู้ใช้กับ LDAP จากนั้นชี้บริการผู้ใช้ กลุ่ม และการตรวจสอบสิทธิ์ไปยังไดเร็กทอรีเดียวกัน การกำหนดค่า LDAP ไม่ได้ทำผ่านตัวช่วยสร้างการดูแลระบบแบบ Classic Server การตั้งค่าที่แน่นอนขึ้นอยู่กับเวอร์ชัน oCIS และโครงสร้างไดเร็กทอรีของคุณ เอกสารอ้างอิงนี้ใช้เอกสารบริการ ownCloud 8.2 และตัวแปรสภาพแวดล้อมแบบ Docker Compose

ทำความเข้าใจความหมายของ “การตรวจสอบสิทธิ์ LDAP” ใน oCIS

oCIS แยกการลงชื่อเข้าใช้ผ่านเบราว์เซอร์ออกจากบริการที่ค้นหาผู้ใช้และกลุ่ม IDP ในตัวสามารถใช้ LDAP สำหรับการตรวจสอบสิทธิ์ผู้ใช้และออกโทเค็น OIDC ได้ บริการต่างๆ เช่น Graph และ Users ก็ต้องการการเชื่อมต่อ LDAP และการตั้งค่าแอตทริบิวต์ที่ตรงกันเพื่อแก้ไขข้อมูลประจำตัว บริการ Auth Basic จัดการการตรวจสอบสิทธิ์ HTTP Basic สำหรับไคลเอ็นต์ที่ต้องการ ซึ่งเป็นเส้นทางที่แยกต่างหากการดำเนินการ:ตัดสินใจว่าคุณต้องการการลงชื่อเข้าใช้ผ่านเบราว์เซอร์ การตรวจสอบสิทธิ์ Basic สำหรับไคลเอ็นต์เฉพาะ หรือทั้งสองอย่างก่อนที่จะเปลี่ยนการกำหนดค่า

เอกสารประกอบ ownCloud เวอร์ชัน 8.2 อธิบายถึง IDP และ IDM แบบฝังตัวสำหรับสภาพแวดล้อมขนาดเล็ก ในขณะที่แนะนำให้ใช้ผู้ให้บริการข้อมูลประจำตัวภายนอกระดับองค์กรสำหรับระบบที่ใช้งานในระดับองค์กร หากคุณใช้ผู้ให้บริการ OIDC อยู่แล้ว เช่น Keycloak หรือ Active Directory Federation Services การผสานรวมผู้ให้บริการดังกล่าวอาจเหมาะสมกว่าการใช้ LDAP เป็นหน่วยงานเข้าสู่ระบบโดยตรงการดำเนินการ:ตรวจสอบสถาปัตยกรรมและเวอร์ชันที่รองรับกับคู่มือการใช้งาน ownCloud ที่เกี่ยวข้องก่อนเริ่มใช้งานจริง

รวบรวมรายละเอียดในสมุดรายชื่อก่อน

สอบถามข้อมูลจากผู้ดูแลระบบ LDAP เกี่ยวกับชื่อโฮสต์และพอร์ตของเซิร์ฟเวอร์, ห่วงโซ่ใบรับรอง TLS, DN และรหัสผ่านของบัญชีเชื่อมต่อ, ฐานการค้นหาผู้ใช้, คุณลักษณะการเข้าสู่ระบบ, คุณลักษณะรหัสผู้ใช้ที่ไม่ซ้ำกัน, คุณลักษณะอีเมลและชื่อที่แสดง, คลาสวัตถุผู้ใช้ และตัวกรองผู้ใช้ที่จำเป็น หากต้องการให้กลุ่มปรากฏใน oCIS ให้รวบรวม DN ฐานกลุ่ม, คลาสวัตถุ, คุณลักษณะชื่อ, คุณลักษณะสมาชิก และคุณลักษณะรหัสกลุ่มที่เสถียรด้วย

  • ใช้บัญชีผู้ใช้เฉพาะที่มีสิทธิ์น้อยที่สุดในการค้นหาข้อมูล
  • เลือกใช้ldaps://LDAP หรือ LDAP ร่วมกับ StartTLS ตามนโยบายไดเร็กทอรีของคุณ และติดตั้งใบรับรอง CA ที่ออกให้ในตำแหน่งที่คอนเทนเนอร์ oCIS สามารถอ่านได้
  • เลือกตัวระบุผู้ใช้ที่ไม่ซ้ำกันและมีความเสถียร อย่าเปลี่ยนแอตทริบิวต์ ID อย่างไม่ระมัดระวังหลังจากที่ผู้ใช้เริ่มใช้งานระบบแล้ว
  • ตรวจสอบว่าโฮสต์หรือคอนเทนเนอร์ oCIS สามารถแก้ไขและเข้าถึงเซิร์ฟเวอร์ LDAP ได้ และกฎไฟร์วอลล์อนุญาตพอร์ต TLS ของ LDAP ที่เลือกไว้

ชื่อสคีมาจะแตกต่างกันไปใน OpenLDAP, Active Directory และไดเร็กทอรีที่กำหนดเอง ค่าเริ่มต้นตัวอย่างของ ownCloud เช่นinetOrgPerson, uid, และownCloudUUIDไม่ได้เป็นสากลการดำเนินการ:ตรวจสอบคุณลักษณะแต่ละรายการกับรายการไดเร็กทอรีจริง และใช้บัญชีทดสอบที่เป็นตัวแทนก่อนใช้งานจริง

กำหนดค่า IDP ในตัว

สำหรับ Docker Compose ตัวแปรสภาพแวดล้อมจะต้องอยู่ในocisบริการ ต่อไปนี้เป็นเพียงแม่แบบ ไม่ใช่การตั้งค่าที่ใช้งานได้จริง: โปรดแทนที่ค่าตัวอย่างทั้งหมดด้วยการตั้งค่าจริงของไดเร็กทอรีของคุณ และเชื่อมต่อไฟล์ CA เข้ากับคอนเทนเนอร์ที่พาธที่ระบุ

services:
  ocis:
    environment:
      IDP_LDAP_URI: ldaps://ldap.example.org:636
      IDP_LDAP_TLS_CACERT: /etc/ocis/ldap-ca.pem
      IDP_LDAP_BIND_DN: cn=ocis-reader,ou=service-accounts,dc=example,dc=org
      IDP_LDAP_BIND_PASSWORD: ${OCIS_LDAP_BIND_PASSWORD}
      IDP_LDAP_BASE_DN: ou=people,dc=example,dc=org
      IDP_LDAP_LOGIN_ATTRIBUTE: uid
      IDP_LDAP_OBJECTCLASS: inetOrgPerson
      IDP_LDAP_UUID_ATTRIBUTE: entryUUID
      IDP_LDAP_EMAIL_ATTRIBUTE: mail
      IDP_LDAP_NAME_ATTRIBUTE: displayName
      IDP_USER_ENABLED_ATTRIBUTE: ownCloudUserEnabled

การตั้งค่าข้างต้นครอบคลุมการค้นหาและการเข้าสู่ระบบ LDAP ฝั่ง IDP รหัสผ่านแสดงเป็นการแทนที่ค่าสภาพแวดล้อม ดังนั้นจึงไม่จำเป็นต้องเขียนโค้ดแบบตายตัวในไฟล์ Compose แต่ควรปกป้องไฟล์สภาพแวดล้อมหรือใช้ระบบรักษาความลับของแพลตฟอร์มการปรับใช้ของคุณ เส้นทาง CA ต้องมีอยู่ภายในคอนเทนเนอร์ ไม่ใช่แค่บนโฮสต์เท่านั้นการดำเนินการ:ติดตั้ง CA แบบอ่านอย่างเดียวและยืนยันว่าผู้ใช้คอนเทนเนอร์สามารถอ่านได้ก่อนที่จะรีสตาร์ท oCIS

ใช้ค่าแอตทริบิวต์ที่เปิดใช้งาน/ปิดใช้งานจริงของคุณ เอกสารIDP_USER_ENABLED_ATTRIBUTEระบุชื่อแอตทริบิวต์ที่จะตรวจสอบ ความหมายของ "เปิดใช้งาน" ขึ้นอยู่กับโครงสร้างและวิธีการใช้งาน หากไม่ได้ใช้การตั้งค่านี้ในไดเร็กทอรีของคุณ อย่าสร้างค่าขึ้นมาเอง: โปรดดูเอกสารบริการสำหรับเวอร์ชันที่ใช้งานจริงของคุณการดำเนินการ:ทดสอบทั้งบัญชีที่เปิดใช้งานและบัญชีที่ปิดใช้งานเพื่อตรวจสอบนโยบายการเข้าถึง

รักษาความสอดคล้องกันระหว่างการค้นหาข้อมูลประจำตัวและการตรวจสอบสิทธิ์

การเปลี่ยนการตั้งค่า IDP เพียงอย่างเดียวอาจทำให้สามารถตรวจสอบข้อมูลประจำตัวได้ ในขณะที่ส่วนที่เหลือของ oCIS ไม่สามารถระบุผู้ใช้หรือกลุ่มเดียวกันได้ บริการผู้ใช้มีตัวแปร LDAP ของตนเอง รวมถึงUSERS_LDAP_URI, USERS_LDAP_CACERT, USERS_LDAP_BIND_DN, USERS_LDAP_BIND_PASSWORD, และUSERS_LDAP_USER_BASE_DNGraph ใช้GRAPH_LDAP_*ตัวเลือกที่เกี่ยวข้องและควบคุมการสืบค้นผู้ใช้และกลุ่ม ตั้งค่าเหล่านี้ให้เป็นไดเร็กทอรีเดียวกันและสคีมาที่เข้ากันได้เมื่อบริการเหล่านั้นเป็นส่วนหนึ่งของการปรับใช้ของคุณ

ตัวอย่างเช่น ให้ปรับ DN ฐานผู้ใช้และแอตทริบิวต์ ID ที่เสถียรให้ตรงกันระหว่าง IDP และ Graph จากนั้นตั้งค่า DN ฐานกลุ่มและแอตทริบิวต์สมาชิกของ Graph ให้ตรงกับระเบียน LDAP ของคุณ เอกสารบริการ Graph ระบุว่าแบ็กเอนด์ LDAP เป็นค่าเริ่มต้นและระบุการตั้งค่าการเขียนเซิร์ฟเวอร์แยกต่างหากการดำเนินการ:เริ่มต้นด้วยการค้นหาแบบอ่านอย่างเดียวหากไดเร็กทอรีมีอำนาจที่อื่น ตั้งค่าGRAPH_LDAP_SERVER_WRITE_ENABLEDเป็นfalseเมื่อ oCIS ต้องไม่สร้างหรือแก้ไขผู้ใช้และกลุ่มในไดเร็กทอรี

ตั้งค่าเฉพาะAUTH_BASIC_AUTH_PROVIDER=ldapเมื่อไคลเอ็นต์ของคุณต้องการการตรวจสอบสิทธิ์ HTTP Basic เท่านั้น ownCloud ระบุว่าการตรวจสอบสิทธิ์ Basic ต้องเปิดใช้งานที่พร็อกซีด้วยเช่นกันPROXY_ENABLE_BASIC_AUTH=trueไม่ใช่การทดแทนการลงชื่อเข้าใช้เบราว์เซอร์ OIDC ปกติคำแนะนำ:ปิดใช้งานการตรวจสอบสิทธิ์ Basic ไว้เว้นแต่ไคลเอ็นต์ที่ระบุชื่อต้องการใช้งาน และตรวจสอบผลกระทบด้านความปลอดภัยก่อนเปิดใช้งาน

เริ่มใหม่ ทดสอบ และแก้ไขปัญหา

  1. ตรวจสอบความถูกต้องของไฟล์ Compose และยืนยันว่าตัวแปรต่างๆ ถูกเชื่อมโยงกับบริการที่ถูกต้องแล้ว
  2. รีสตาร์ทหรือติดตั้ง oCIS ใหม่โดยใช้ขั้นตอนการติดตั้งตามปกติ เพื่อให้บริการต่างๆ โหลดค่าใหม่
  3. ตรวจสอบบันทึกการเริ่มต้นระบบและบันทึกการบริการเพื่อหาข้อผิดพลาดในการเชื่อมต่อ LDAP, การผูกข้อมูล, ใบรับรอง และการค้นหา
  4. ทดสอบการเข้าสู่ระบบของผู้ใช้ที่รู้จักผ่านทางเว็บอินเทอร์เฟซ จากนั้นตรวจสอบว่าโปรไฟล์ผู้ใช้และกลุ่มที่คาดหวังนั้นถูกต้อง
  5. ทดสอบด้วยรหัสผ่านที่ไม่ถูกต้องและผู้ใช้ที่ถูกปิดใช้งาน ตรวจสอบให้แน่ใจว่าทั้งสองกลุ่มไม่สามารถเข้าถึงระบบได้

หากการเชื่อมต่อล้มเหลว ให้ตรวจสอบ DNS และการเข้าถึงเครือข่ายจากภายในคอนเทนเนอร์ ตรวจสอบว่าชื่อโฮสต์ LDAPS ตรงกับใบรับรอง ตรวจสอบว่าห่วงโซ่ CA เชื่อถือได้ และตรวจสอบว่า bind DN และรหัสผ่านถูกต้อง การเชื่อมต่อ LDAP ที่สำเร็จไม่ได้หมายความว่าฐานการค้นหาผู้ใช้หรือคุณลักษณะการเข้าสู่ระบบถูกต้อง หากการลงชื่อเข้าใช้ทำงานได้ แต่ข้อมูลผู้ใช้หรือกลุ่มหายไป ให้เปรียบเทียบการตั้งค่า IDP ผู้ใช้ และกราฟ และตรวจสอบบันทึกแต่ละรายการการดำเนินการ:แยกความล้มเหลวโดยการทดสอบบริการและบัญชีทดสอบทีละรายการแทนที่จะลดความเข้มงวดของการตรวจสอบ TLS

อย่าตั้งค่าตัวเลือกการข้ามการตรวจสอบ TLS ของ LDAP ในสภาพแวดล้อมการใช้งานจริง ownCloud เตือนอย่างชัดเจนเกี่ยวกับการตั้งค่าใบรับรอง LDAP ที่ไม่ปลอดภัย เก็บรักษาบัญชีผู้ดูแลระบบสำหรับการกู้คืนและสำเนาของการกำหนดค่าที่ใช้งานได้ก่อนหน้านี้ไว้จนกว่าการเข้าสู่ระบบและการแก้ไขกลุ่มจะได้รับการตรวจสอบแล้วการดำเนินการ:ใช้การเปลี่ยนแปลงในสภาพแวดล้อมทดสอบก่อน จากนั้นจึงนำไปใช้ในสภาพแวดล้อมจริงในช่วงเวลาที่ผู้ดูแลระบบสามารถกู้คืนสภาพแวดล้อมก่อนหน้าได้หากจำเป็น

ข้อมูลอ้างอิงอย่างเป็นทางการ

ฝากความเห็น

ตั้งค่า ownCloud ให้ใช้งาน HTTPS โดยใช้ Let's Encrypt และ Nginx

ตั้งค่า ownCloud ให้ใช้งาน HTTPS โดยใช้ Let's Encrypt และ Nginx

เลือก HTTP-01 หรือ DNS-01 กำหนดค่าพร็อกซีแบบย้อนกลับของ ownCloud และตรวจสอบว่า Certbot ต่ออายุใบรับรอง HTTPS โดยอัตโนมัติหรือไม่

เชื่อมต่อ ownCloud Infinite Scale กับ LDAP เพื่อการลงชื่อเข้าใช้ของผู้ใช้

กำหนดค่าการเข้าสู่ระบบ oCIS LDAP จัดเรียงการค้นหาผู้ใช้และกลุ่ม และตรวจสอบการตั้งค่า TLS และสคีมา ก่อนเริ่มใช้งานจริง

เชื่อมต่อ S3 Bucket กับ ownCloud 10 ในฐานะพื้นที่จัดเก็บข้อมูลภายนอก

เชื่อมต่อ S3 Bucket กับ ownCloud 10 ในฐานะพื้นที่จัดเก็บข้อมูลภายนอก

เพิ่ม Amazon S3 bucket ลงใน ownCloud 10 เตรียมข้อมูลรับรองและปลายทางที่เข้ากันได้ และตรวจสอบการเข้าถึงโดยไม่ต้องสับสนระหว่างการเชื่อมต่อกับพื้นที่จัดเก็บข้อมูลหลัก

ทำการสำรองข้อมูลฐานข้อมูล ownCloud โดยอัตโนมัติด้วย Cron Job ที่ปลอดภัยทุกคืน

ทำการสำรองข้อมูลฐานข้อมูล ownCloud โดยอัตโนมัติด้วย Cron Job ที่ปลอดภัยทุกคืน

กำหนดเวลาสำรองข้อมูล MariaDB ที่ได้รับการปกป้องสำหรับ ownCloud Server จัดการโหมดบำรุงรักษาอย่างปลอดภัย และตรวจสอบความถูกต้องของข้อมูลสำรองแต่ละรายการก่อนนำไปใช้งาน

ย้าย ownCloud Classic ไปยัง oCIS ด้วยการย้ายข้อมูลที่ได้รับการสนับสนุน

วางแผนการย้ายข้อมูลจาก ownCloud 10 ไปยัง oCIS โดยใช้แอปที่รองรับ คำสั่งที่เรียงลำดับ การตรวจสอบข้อมูลประจำตัว และรายการข้อมูลที่ต้องได้รับการจัดการแยกต่างหากอย่างชัดเจน

ตกแต่งแบรนด์ ownCloud Classic 10 ด้วย Theme App และ CSS

เปลี่ยนโลโก้ ownCloud Classic 10 และปรับแต่งสี UI บนเว็บด้วยแอปธีม พร้อมหลีกเลี่ยงข้อผิดพลาดในการอัปเกรดและการตรวจสอบความสมบูรณ์

ตั้งค่าโควต้าพื้นที่จัดเก็บข้อมูลเริ่มต้นตามบทบาทผู้ใช้ใน ownCloud oCIS

ตั้งค่าโควต้าพื้นที่จัดเก็บข้อมูลเริ่มต้นตามบทบาทผู้ใช้ใน ownCloud oCIS

กำหนดขีดจำกัดพื้นที่จัดเก็บข้อมูลแบบไบต์ให้กับผู้ใช้ ownCloud Infinite Scale รายใหม่ตามบทบาท โดยใช้ตัวอย่างไฟล์ proxy.yaml และรายการตรวจสอบความปลอดภัยในการยืนยัน

แก้ไขข้อผิดพลาดใบรับรองการซิงค์ ownCloud ที่แหล่งที่มา TLS

แก้ไขข้อผิดพลาดใบรับรองการซิงค์ ownCloud ที่แหล่งที่มา TLS

กู้คืนการซิงค์เดสก์ท็อป ownCloud โดยตรวจสอบชื่อโฮสต์เซิร์ฟเวอร์ ห่วงโซ่ใบรับรอง ความเชื่อถือ CA ส่วนตัว และปัญหาเกี่ยวกับ captive portal โดยไม่ต้องปิดใช้งานการตรวจสอบ TLS

ล้างคำเตือนความสมบูรณ์ของ ownCloud หลังจากอัปเกรด

ใช้รายงานไฟล์ที่ไม่ถูกต้องเพื่อระบุไฟล์หลักหรือลายเซ็นแอปที่ไม่ตรงกัน กู้คืนไฟล์เวอร์ชันที่ถูกต้อง และตรวจสอบความสมบูรณ์ของไฟล์ได้อย่างปลอดภัย

ติดตั้ง ownCloud Infinite Scale ด้วย Docker Compose

ติดตั้ง ownCloud Infinite Scale จากตัวอย่าง Compose อย่างเป็นทางการ กำหนดค่าโดเมนและพื้นที่จัดเก็บข้อมูลถาวร จากนั้นตรวจสอบ TLS คอนเทนเนอร์ และการเข้าสู่ระบบครั้งแรก