소셜 로그인 설정하기

소셜 로그인을 사용하면 멤버가 이미 가지고 있는 Google, Apple, Facebook, X(Twitter) 계정으로 로그인하고 가입할 수 있습니다. Mateflow의 공유 OAuth 앱으로 바로 사용할 수 있으며, 제공자의 동의 화면에 브랜드가 표시되도록 자체 OAuth 앱을 연결할 수도 있습니다.

사용 가능한 사람: 소유자와 관리자. 제공자 설정을 변경하면 관리자 비밀번호를 다시 입력해야 합니다. · 위치: 웹(관리 콘솔). 멤버에게는 웹과 Mateflow 앱에 로그인 버튼이 표시됩니다. · 플랜: 플랫폼 자격증명을 사용하는 소셜 로그인은 플랜에 따른 제한이 없습니다. 자체 OAuth 자격증명(커스텀 자격증명) 사용 여부는 플랫폼 플랜에 따라 다릅니다.

소셜 로그인 켜고 로그인 모드 선택하기

1. 관리자 → 설정 → 소셜 로그인으로 이동합니다.
2. 일반 설정에서 소셜 로그인 활성화를 켭니다.
3. 로그인 모드를 선택합니다.
   • 선택: 멤버가 어떤 로그인 방법이든 사용할 수 있습니다. 이메일 양식이 먼저 표시됩니다.
   • 우선: 소셜 로그인 버튼이 이메일 양식보다 위에 먼저 표시됩니다.
   • 소셜만: 멤버는 소셜 계정으로만 로그인하거나 가입할 수 있습니다. 이 옵션은 사용 가능한 제공자를 하나 이상 켠 뒤에 선택할 수 있습니다.
4. 변경사항 저장을 클릭합니다.

Google, Apple, Facebook, X 켜기

소셜 로그인 제공자에는 제공자마다 카드와 스위치가 있습니다.

1. 제공자의 스위치를 켭니다.
2. 관리자 인증 필요가 나타나면 관리자 비밀번호를 입력하고 인증을 클릭합니다.

제공자 스위치는 바로 저장됩니다. 각 카드의 배지에 제공자가 어떻게 설정되어 있는지 표시됩니다.

• 플랫폼 자격증명: Mateflow의 공유 OAuth 앱을 사용합니다. 따로 설정할 것이 없습니다.
• 커스텀 자격증명: 자체 OAuth 앱을 사용합니다.
• 커스텀 자격증명 필요: 이 제공자는 플랫폼 자격증명을 사용할 수 없으므로 자체 자격증명이 필요합니다.
• 업그레이드 필요: 플랫폼 플랜에 이 옵션이 포함되어 있지 않습니다.
• 마지막 검증 실패: Mateflow가 커스텀 자격증명을 확인하지 못했습니다. 설정을 열어 수정하세요.

자체 OAuth 앱 사용하기(커스텀 자격증명)

커스텀 자격증명을 사용하면 제공자의 동의 화면에 Mateflow 대신 여러분 앱의 이름이 표시됩니다.

1. 제공자 카드에서 설정을 클릭합니다.
2. 자격증명에서 커스텀 자격증명을 선택합니다.
3. 리디렉션 URI를 복사해 제공자의 개발자 콘솔에서 OAuth 앱에 추가합니다. 제공자 설정 가이드에서 절차를 확인할 수 있습니다.
4. 클라이언트 ID와 클라이언트 시크릿을 입력합니다. Apple의 경우 서비스 ID, 팀 ID, 키 ID를 입력하고, 개인 키 (.p8 내용) 입력란에 붙여 넣거나 .p8 파일 업로드를 클릭합니다.
5. 연결 테스트를 클릭합니다. 테스트를 통과해야 저장할 수 있습니다.
6. 변경 사항 저장을 클릭하고 관리자 비밀번호로 인증합니다.

테스트에 실패하면 메시지에 이유가 표시됩니다. 예를 들어 "클라이언트 ID 또는 시크릿이 올바르지 않습니다." 또는 "제공자에 mateflow의 리디렉션 URI가 등록되어 있지 않습니다."와 같은 메시지입니다.

제공자를 다시 플랫폼 자격증명으로 전환하기

1. 설정을 클릭하고 플랫폼 자격증명을 선택한 다음 변경 사항 저장을 클릭합니다.
2. 플랫폼 자격증명으로 전환하시겠습니까? 대화상자에서 전환을 클릭합니다.

커스텀 자격증명은 삭제되며 되돌릴 수 없습니다. 동의 화면에는 다시 Mateflow의 이름이 표시되며, 기존 멤버는 다음에 로그인할 때 액세스를 다시 승인해야 할 수 있습니다. 해당 제공자에 플랫폼 자격증명을 사용할 수 없다면 제공자가 꺼집니다.

플랫폼 플랜에 더 이상 커스텀 자격증명이 포함되지 않으면 페이지에 영향을 받는 제공자 수와 함께 커스텀 OAuth 자격증명 일시 중지됨이 표시됩니다.

멤버가 소셜 계정으로 로그인할 때 보이는 화면

커뮤니티의 로그인 및 가입 페이지에는 켜 둔 제공자마다 Google로 로그인 같은 버튼이 Google, Apple, Facebook, X 순서로 표시됩니다. Mateflow 앱에도 같은 옵션이 표시됩니다.

멤버는 설정 → 보안 → 소셜 계정에서 소셜 계정을 연결하거나 연결 해제할 수 있습니다. 로그인 방법은 하나 이상 남겨 두어야 합니다.

관련 문서

• 커뮤니티 보안 설정
• 싱글 사인온(SSO) 설정하기
• 로그인 문제 해결하기
• 프로필 및 계정 수정하기