MateFlow는 관리자에게 커뮤니티를 스택의 나머지 부분과 연결하는 여러 방법을 제공합니다. 모든 것이 한곳에 모여 있습니다. Admin → 설정 → 연동을 열면 연동(연결된 앱), 웹훅, API 액세스, 문서, 활동 로그 탭이 있습니다. 싱글 사인온은 Admin → 설정 → SSO에서 별도로 구성합니다.
연결된 앱
연동 탭에는 몇 번의 클릭으로 연결할 수 있는 서드파티 서비스가 나열됩니다. 지원되는 앱에는 Zapier, Slack, Discord, Google Calendar, Mailchimp와 함께 맞춤형 옵션이 포함됩니다. 연결을 클릭하고 요청된 자격 증명을 입력하면 연결이 안전하게 저장됩니다. 동일한 카드에서 언제든지 연결을 해제할 수 있습니다.
웹훅
웹훅은 커뮤니티의 이벤트를 여러분이 제어하는 모든 URL로 전송하여 외부 시스템이 실시간으로 반응하도록 합니다. 웹훅을 만들려면 웹훅 탭으로 이동해 웹훅 추가를 클릭하고 다음을 설정하세요.
- 이름과 대상 URL
- 구독할 하나 이상의 이벤트
- 각 요청이 실제로 MateFlow에서 온 것인지 엔드포인트가 확인할 수 있도록 하는 서명 시크릿
- 후크를 삭제하지 않고 전송을 일시 중지하는 활성 토글
MateFlow가 발생시키는 이벤트는 멤버, 콘텐츠, 결제를 포괄합니다.
| 카테고리 | 이벤트 |
|---|---|
| 멤버 | member.joined, member.role_changed, member.suspended, member.reinstated |
| 콘텐츠 | post.created, post.deleted, comment.created, comment.deleted |
| 결제 | payment.received, payment.failed, subscription.created, subscription.renewed, subscription.canceled, refund.issued |
테스트를 사용해 샘플 페이로드를 전송하고, 활동 탭에서 전송 로그(상태, 응답 코드, 성공률)를 확인해 실패를 디버깅하세요. 웹훅은 요금제 기능이며, 만들 수 있는 개수는 요금제에 따라 정해집니다.
API 액세스
API 액세스 탭에서는 https://api.mateflow.com의 공개 API에 프로그래밍 방식으로 접근하기 위한 권한 제한 API 키를 생성할 수 있습니다. 키를 만들 때 이름을 지정하고 권한(site.read, content.read, content.write, media.write 등)을 선택하며, 선택적으로 특정 IP 주소로 제한할 수 있습니다. 전체 키는 생성 시 단 한 번만 표시되므로 즉시 복사하세요. 동일한 목록에서 어떤 키든 취소할 수 있습니다. 문서 탭에는 엔드포인트 레퍼런스가 있습니다.
싱글 사인온(SSO)
상위 요금제에서는 멤버가 여러분의 ID 공급자를 통해 로그인하도록 요구할 수 있습니다. MateFlow는 SAML 2.0과 OIDC를 지원합니다. Admin → 설정 → SSO에서 IdP 메타데이터를 붙여넣거나 분석하고, 서비스 공급자의 Entity ID와 ACS URL을 IdP에 다시 복사한 뒤 로그인 정책(SSO와 비밀번호, SSO와 모든 방법, 또는 SSO 전용)을 선택합니다. 저스트 인 타임 프로비저닝은 첫 로그인 시 계정을 생성하고, 허용 도메인은 접근 범위를 정하며, 복구 관리자는 잠금을 방지하고, 감사 탭은 SSO 로그인을 추적합니다. 모두에게 활성화하기 전에 연결 테스트를 사용하세요.
다음 단계
- 관리자가 구성할 수 있는 항목을 연동에서 살펴보세요.
- API 키나 관리자 액세스를 발급하기 전에 멤버 역할 및 권한을 검토하세요.
- 웹훅과 SSO의 요금제 한도는 요금 페이지에서 확인하세요.