• auth
  • authentication
  • identity
  • integration
  • outline
  • oidc
  • oauth

Logto 를 사용하여 Outline 인증 간소화하기

이 기사에서는 Logto 를 Outline 을 위한 OpenID Connect (OIDC) 아이덴티티 제공자로 사용하는 방법을 설명합니다.

Gao
Gao
Founder

소개

  • Logto 는 필요한 모든 기능을 갖춘 간편한 아이덴티티 솔루션입니다. 사용자명, 이메일, 전화번호, Google 및 GitHub 과 같은 인기 있는 소셜 로그인을 포함한 다양한 로그인 방법을 지원합니다.
  • Outline 는 성장하는 팀을 위한 지식 베이스로 사용됩니다.

가장 좋은 점은 Logto 와 Outline 둘 다 오픈 소스라는 것입니다. 이 기사에서는 Logto 를 Outline 을 위한 OpenID Connect (OIDC) 아이덴티티 제공자로 사용하는 방법을 설명합니다.

사전 준비

시작하려면 다음을 확인하십시오:

  • 실행 중인 Logto 인스턴스 또는 Logto Cloud 계정에 대한 액세스.
  • 환경 변수에 액세스할 수 있는 Outline 호스팅 환경.

Logto 구성하기

Logto 를 자체 호스팅하는 경우, Logto "시작하기" 문서를 참조하여 Logto 인스턴스를 설정하십시오.

Logto Cloud 를 사용 중인 경우 URL https://cloud.logto.io/ 를 입력하여 Logto Console 을 엽니다. 또는 자체 호스팅을 위해 설정한 엔드포인트를 입력합니다.

다음으로 "Applications" 탭으로 이동하여 "Create application" 을 클릭하십시오.

Applications tab

나타나는 모달에서 "Traditional Web" 을 선택하고 "Outline" 과 같은 애플리케이션 이름을 제공하십시오. 그런 다음 "Create application" 을 클릭하십시오.

Create application

Logto 에서 튜토리얼 페이지로 이동합니다. 계속하려면 오른쪽 상단의 "Skip" 을 클릭하여 애플리케이션 세부 정보 페이지로 이동하십시오.

Applications details

"Redirect URIs" 섹션에 다음 값을 입력하십시오:

예를 들어, Outline 을 http://localhost:3000 에 호스팅하는 경우, 값은 다음과 같습니다:

Save changes

하단의 "Save Changes" 버튼을 클릭하십시오. 성공하면, 이 페이지를 열어 두십시오. Outline 설정에 유용할 것입니다.

Outline 구성하기

Outline 호스팅 가이드 에 명시된 단계를 따라 인증 구성 단계에 도달하십시오. Outline 은 기본적으로 OIDC 호환 인증 제공자를 지원하므로, Logto 애플리케이션 세부 정보 페이지에서 대부분의 필요한 구성 값을 쉽게 찾을 수 있습니다.

필요한 구성 세부 정보는 다음 표를 참조하십시오:

Outline 환경 변수Logto 표시 이름
OIDC_CLIENT_IDApp ID
OIDC_CLIENT_SECRETApp Secret
OIDC_AUTH_URIAuthorization Endpoint
OIDC_TOKEN_URIToken Endpoint
OIDC_USERINFO_URIUserinfo Endpoint

다음은 추가 변수들을 포함하는 또 다른 표입니다:

Outline 환경 변수설명
OIDC_USERNAME_CLAIM사용자명으로 설정
OIDC_DISPLAY_NAME선택 사항 - 필요에 따라 사용자 정의
OIDC_SCOPES기본값 유지; 설정 필요 없음

자체 호스팅 전용: Logto 에서 이메일 로그인 구성하기

Outline 은 사용자 이메일을 제공받아야 하므로, 신뢰할 수 있는 이메일 주소를 제공하는 이메일 로그인 또는 Google 로그인과 같은 소셜 로그인을 구성해야 합니다.

Logto 에서 커넥터를 구성하는 방법은 Configure connectors 를 참조하십시오.

체크포인트: Logto 와 Outline 통합 테스트

Outline 인스턴스를 시작하고 그 엔드포인트에 접근하십시오. 중앙에 "Continue with OpenID Connect" 라는 버튼이 표시될 것입니다; 이 버튼은 OIDC_DISPLAY_NAME 환경 변수를 설정하여 사용자 정의 할 수 있습니다.

Outline sign-in page

버튼을 클릭하면 Logto 로그인 경험으로 이동하게 됩니다.

Logto sign-in experience

모든 것이 올바르게 구성되었다면, Logto 에서 로그인 또는 등록 과정을 완료한 후 Outline 으로 다시 리디렉션됩니다. 그런 다음 페이지 왼쪽 하단에 개인 정보가 표시되는 것을 확인할 수 있습니다.

Outline home

통합 과정에서 문제가 발생하면 [email protected] 이메일로 연락하거나 Discord 서버에 가입하십시오!

추가 자료