> ## Documentation Index
> Fetch the complete documentation index at: https://wb-21fd5541-dependabot-npm-and-yarn-scripts-css-minify-npm.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# LDAP로 SSO 설정

> 연결 매개변수와 환경 변수를 포함하여 W&B Server용 LDAP 기반 SSO 인증을 설정합니다.

이 가이드는 W\&B Server에서 LDAP 기반 single sign-on(SSO)을 사용 설정하는 W\&B 관리자용입니다. 이를 통해 사용자는 별도의 W\&B 자격 증명을 관리하지 않고 기존 LDAP 디렉터리를 통해 인증할 수 있습니다. 이 문서에서는 W\&B App 시스템 설정 UI 또는 환경 변수를 사용하여 LDAP 연결을 설정하는 방법을 설명합니다. 또한 주소, 기본 DN, 속성을 포함한 필수 및 선택 설정 매개변수도 설명합니다. 익명 바인드를 설정하거나 관리자 DN 및 비밀번호로 바인드할 수 있습니다.

<Note>
  LDAP 인증은 W\&B Admin 역할만 활성화하고 설정할 수 있습니다.
</Note>

<h2 id="configure-ldap-connection">
  LDAP 연결 구성
</h2>

다음 방법 중 하나를 선택하여 LDAP 연결을 구성하세요. W\&B App 탭을 사용하면 시스템 설정 UI를 통해 LDAP를 구성할 수 있고, 환경 변수 탭을 사용하면 배포 시 LDAP를 구성할 수 있습니다.

<Tabs>
  <Tab title="W&B App">
    W\&B App을 통해 LDAP를 구성하려면 다음을 수행하세요:

    1. W\&B App으로 이동합니다.
    2. 프로필 아이콘을 선택한 다음 **System Settings**를 선택합니다.
    3. **Configure LDAP Client**를 켭니다.
    4. 양식에 세부 정보를 입력합니다. 각 입력 항목에 대한 자세한 내용은 [설정 매개변수](#configuration-parameters)를 참조하세요.
    5. 설정을 테스트하려면 **Update Settings**를 클릭합니다. 이 단계에서는 W\&B Server와의 테스트 클라이언트 또는 연결을 설정합니다.
    6. 연결이 확인되면 **Enable LDAP Authentication**를 켜고 **Update Settings**를 선택합니다.

    이 단계를 완료하면 W\&B Server가 LDAP 디렉터리를 기준으로 사용자를 인증합니다.
  </Tab>

  <Tab title="환경 변수">
    다음 환경 변수로 LDAP 연결을 설정합니다:

    | 환경 변수 | 필수 | 예시 |
    | - | - | - |
    | `LOCAL_LDAP_ADDRESS` | 예 | `ldaps://ldap.example.com:636` |
    | `LOCAL_LDAP_BASE_DN` | 예 | `email=mail,group=gidNumber` |
    | `LOCAL_LDAP_BIND_DN` | 아니요 | `cn=admin`, `dc=example,dc=org` |
    | `LOCAL_LDAP_BIND_PW` | 아니요 | |
    | `LOCAL_LDAP_ATTRIBUTES` | 예 | `email=mail`, `group=gidNumber` |
    | `LOCAL_LDAP_TLS_ENABLE` | 아니요 | |
    | `LOCAL_LDAP_GROUP_ALLOW_LIST` | 아니요 | |
    | `LOCAL_LDAP_LOGIN` | 아니요 | |

    다음 [설정 매개변수](#configuration-parameters) 섹션에서 각 환경 변수를 정의합니다. 명확성을 위해 정의 이름에서는 환경 변수 접두사 `LOCAL_LDAP`를 생략합니다.
  </Tab>
</Tabs>

<h2 id="configuration-parameters">
  설정 매개변수
</h2>

다음 표에는 필수 및 선택 LDAP 설정 항목과 각 항목의 설명이 나와 있습니다.

| 환경 변수 | 정의 | 필수 |
| - | - | - |
| `ADDRESS` | W\&B Server를 호스팅하는 VPC 내 LDAP 서버의 주소입니다. | Yes |
| `BASE_DN` | 검색이 시작되는 루트 경로로, 이 디렉터리에 대한 모든 쿼리에 필요합니다. | Yes |
| `BIND_DN` | LDAP 서버에 등록된 관리 사용자 경로입니다. LDAP 서버가 인증되지 않은 바인딩을 지원하지 않는 경우 필요합니다. 지정하면 W\&B Server는 이 사용자로 LDAP 서버에 연결합니다. 그렇지 않으면 W\&B Server는 익명 바인딩으로 연결합니다. | No |
| `BIND_PW` | 관리 사용자의 비밀번호이며, 바인딩 인증에 사용됩니다. 비워 두면 W\&B Server는 익명 바인딩으로 연결합니다. | No |
| `ATTRIBUTES` | 이메일 및 그룹 ID 속성 이름을 쉼표로 구분된 string 값으로 제공하세요. | Yes |
| `TLS_ENABLE` | TLS를 활성화합니다. | No |
| `GROUP_ALLOW_LIST` | 그룹 허용 목록입니다. | No |
| `LOGIN` | W\&B Server가 LDAP를 사용해 인증하도록 설정합니다. `True` 또는 `False`로 설정하세요. 필요에 따라 LDAP 설정을 테스트하려면 `False`로 설정할 수 있습니다. LDAP 인증을 시작하려면 `True`로 설정하세요. | No |