Other Integrations

This guide covers additional integrations including GIF support (Klipy), CAPTCHA protection (Cloudflare Turnstile and Google reCAPTCHA), and Single Sign-On (SSO) for integrating ChatNet with external authentication systems.


GIF Support (Klipy)

Navigate to Chat & Features > GIF

Allow users to search and share GIFs in chat messages using the Klipy API.

Setup

  1. Sign up at klipy.co
  2. Create an application to get your API key
  3. Copy your API key

Configuration

SettingDescription
Klipy App KeyYour Klipy API key
GIFs Per PageNumber of GIFs shown in search results

After configuration, users will see a GIF button in the chat input area.


CAPTCHA Protection

Navigate to Moderation > Captcha

Protect registration and login forms from bots using CAPTCHA verification. ChatNet supports both Cloudflare Turnstile and Google reCAPTCHA.

Cloudflare Turnstile

Turnstile is a privacy-focused, user-friendly CAPTCHA alternative from Cloudflare.

Setup

  1. Log in to Cloudflare Dashboard
  2. Navigate to Turnstile in the sidebar
  3. Click "Add site"
  4. Enter your domain
  5. Choose widget type (Managed, Non-interactive, or Invisible)
  6. Copy the Site Key and Secret Key

Configuration

SettingDescription
Enable TurnstileTurn on Turnstile protection
Site KeyYour Turnstile Site Key
Secret KeyYour Turnstile Secret Key

Recommended: Turnstile is often invisible to users while still providing bot protection, creating a better user experience.

Google reCAPTCHA

Google's widely-used CAPTCHA service.

Setup

  1. Go to reCAPTCHA Admin
  2. Click the "+" to register a new site
  3. Enter a label for your site
  4. Choose reCAPTCHA type (v2 or v3)
  5. Add your domain(s)
  6. Accept terms and submit
  7. Copy the Site Key and Secret Key

Configuration

SettingDescription
Enable reCAPTCHATurn on reCAPTCHA protection
Site KeyYour reCAPTCHA Site Key
Secret KeyYour reCAPTCHA Secret Key

reCAPTCHA Versions


Single Sign-On (SSO)

Navigate to Integrations - SSO

SSO allows users to authenticate using an external identity provider, enabling seamless login from your existing website or application.

When to Use SSO

How SSO Works

  1. User clicks "Login with SSO" on ChatNet
  2. User is redirected to your external auth system
  3. After successful authentication, user is redirected back
  4. ChatNet receives a signed token with user information
  5. User is logged in (or account is created if new)

Configuration

SettingDescription
Enable SSOTurn on SSO authentication
SSO EndpointURL of your authentication server
Secret KeyShared secret for token verification
User MappingHow external user data maps to ChatNet fields

Setup Steps

  1. Navigate to Integrations - SSO
  2. Enable SSO
  3. Enter your SSO endpoint URL
  4. Set a secure shared secret key
  5. Configure user field mapping
  6. Save changes
  7. Implement the SSO endpoint on your server

Token Format

Your SSO endpoint should return a JWT or signed token containing user information:

{ "user_id": "external_user_id", "username": "john_doe", "email": "john@example.com", "avatar": "https://example.com/avatar.jpg", "timestamp": 1234567890 }

Security Considerations

Important: SSO implementation requires development work on your external authentication system. This is an advanced feature.


Integration Checklist

Quick reference for which integrations you may want to enable:

IntegrationPurposeDifficulty
Klipy GIFFun chat featureEasy
TurnstileBot protectionEasy
reCAPTCHABot protectionEasy
SSOExternal authAdvanced