> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 인증

> Kubernetes 배포에서 로그인을 구성합니다 - OIDC, SAML, LDAP, 공개 접근, reCAPTCHA 및 비밀번호 규칙.

모든 로그인 방식은 모든 Ayakaleaf Pro 파드의 **web** 서비스에서 실행됩니다. 어느 방식도 추가 파드나 주기적 작업이 필요하지 않으며, 모두 로그인 상태를 Redis의 세션에 보관하므로 레플리카가 하나이든 여러 개이든 동일하게 동작합니다. Kubernetes에서 다른 점은 설정, 시크릿, 인증서를 어디에 두는지와 어떤 네트워크 경로가 열려 있어야 하는지입니다.

| 방식 | Secret `overleaf-secrets` | Secret `overleaf-certs` | 파드가 접근해야 하는 대상 |
| - | - | - | - |
| [OIDC](https://ayakaleaf-pro.mintlify.site/ko/on-premises/configuration/kubernetes/authentication/oidc-authentication.md) | `OVERLEAF_OIDC_CLIENT_SECRET` | 사설 CA인 경우 해당 CA | OP의 토큰 및 userinfo 엔드포인트 |
| [SAML](https://ayakaleaf-pro.mintlify.site/ko/on-premises/configuration/kubernetes/authentication/saml-authentication.md) | – | IdP 인증서, Overleaf 자체 키 | 없음: 메시지가 브라우저를 통해 전달됨 |
| [LDAP](https://ayakaleaf-pro.mintlify.site/ko/on-premises/configuration/kubernetes/authentication/ldap-authentication.md) | `OVERLEAF_LDAP_BIND_CREDENTIALS` | 사설 CA인 경우 LDAP CA | LDAP 서버 |
| [공개 접근](https://ayakaleaf-pro.mintlify.site/ko/on-premises/configuration/kubernetes/authentication/public-access.md) | 활성화 이메일용 SMTP 비밀번호 | – | SMTP 서버 |
| [reCAPTCHA](https://ayakaleaf-pro.mintlify.site/ko/on-premises/configuration/kubernetes/authentication/recaptcha.md) | `RECAPTCHA_SECRET_KEY`, `DEVICE_HISTORY_SECRET` | – | `www.google.com`(또는 `RECAPTCHA_ENDPOINT`) |
| [비밀번호 제한](https://ayakaleaf-pro.mintlify.site/ko/on-premises/configuration/kubernetes/authentication/password-restrictions.md) | – | – | – |

`EXTERNAL_AUTH`는 ConfigMap에서 공백으로 구분된 목록으로 SSO 방식을 켭니다. 예: `EXTERNAL_AUTH: ldap oidc`. SSO를 켰을 때의 계정 처리와 사용자가 변경할 수 있는 항목은 Toolkit과 동일합니다. [인증](https://ayakaleaf-pro.mintlify.site/ko/on-premises/configuration/overleaf-toolkit/authentication)을 참고하세요.

> [!WARNING]
>
> 설정이 잘못된 방식이 있어도 파드가 준비 상태가 되는 것을 막지는 않습니다. web은 `/var/log/overleaf/web.log`에 `error setting up passport in modules`를 기록하고, 해당 방식과 `ldap`, `saml`, `oidc` 순서에서 그 뒤에 오는 방식은 꺼진 상태로 남습니다. 변경할 때마다 로그를 확인하세요. `EXTERNAL_AUTH: saml oidc`에 IdP 인증서가 없는 상태로 시험해 보았더니, 파드는 준비 상태가 되었고 인증서 경로를 수정할 때까지 `/saml/login`과 `/oidc/login` 모두 "Something went wrong"(500)을 응답했습니다.

> [card] [OIDC 인증](https://ayakaleaf-pro.mintlify.site/ko/on-premises/configuration/kubernetes/authentication/oidc-authentication.md)

> [card] [SAML 인증](https://ayakaleaf-pro.mintlify.site/ko/on-premises/configuration/kubernetes/authentication/saml-authentication.md)

> [card] [LDAP 인증](https://ayakaleaf-pro.mintlify.site/ko/on-premises/configuration/kubernetes/authentication/ldap-authentication.md)

> [card] [공개 접근](https://ayakaleaf-pro.mintlify.site/ko/on-premises/configuration/kubernetes/authentication/public-access.md)

> [card] [reCAPTCHA](https://ayakaleaf-pro.mintlify.site/ko/on-premises/configuration/kubernetes/authentication/recaptcha.md)

> [card] [비밀번호 제한](https://ayakaleaf-pro.mintlify.site/ko/on-premises/configuration/kubernetes/authentication/password-restrictions.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.