feat(embed): add backend embed channels with auth and rate limiting (#1657)

Introduce embed_channels storage, publish-token and session-token auth,
origin allowlist enforcement, shared Redis rate limiter, public embed API
routes, webhooks with SSRF validation, and session listing by embed source.
This commit is contained in:
wizardchen
2026-06-12 22:40:18 +08:00
committed by lyingbug
parent a0786b6fe7
commit ed9802ff2b
30 changed files with 4070 additions and 216 deletions
@@ -0,0 +1,78 @@
package repository
import (
"context"
"errors"
"github.com/Tencent/WeKnora/internal/types"
"github.com/Tencent/WeKnora/internal/types/interfaces"
"gorm.io/gorm"
)
type embedChannelRepository struct {
db *gorm.DB
}
func NewEmbedChannelRepository(db *gorm.DB) interfaces.EmbedChannelRepository {
return &embedChannelRepository{db: db}
}
func (r *embedChannelRepository) Create(ctx context.Context, ch *types.EmbedChannel) error {
return r.db.WithContext(ctx).Create(ch).Error
}
func (r *embedChannelRepository) GetByID(ctx context.Context, id string) (*types.EmbedChannel, error) {
var ch types.EmbedChannel
err := r.db.WithContext(ctx).Where("id = ?", id).First(&ch).Error
if errors.Is(err, gorm.ErrRecordNotFound) {
return nil, nil
}
if err != nil {
return nil, err
}
return &ch, nil
}
func (r *embedChannelRepository) GetByPublishToken(ctx context.Context, token string) (*types.EmbedChannel, error) {
var ch types.EmbedChannel
err := r.db.WithContext(ctx).Where("publish_token = ?", token).First(&ch).Error
if errors.Is(err, gorm.ErrRecordNotFound) {
return nil, nil
}
if err != nil {
return nil, err
}
return &ch, nil
}
func (r *embedChannelRepository) ListByAgent(
ctx context.Context, tenantID uint64, agentID string,
) ([]*types.EmbedChannel, error) {
var rows []*types.EmbedChannel
err := r.db.WithContext(ctx).
Where("tenant_id = ? AND agent_id = ?", tenantID, agentID).
Order("created_at DESC").
Find(&rows).Error
return rows, err
}
func (r *embedChannelRepository) ListByTenant(
ctx context.Context, tenantID uint64,
) ([]*types.EmbedChannel, error) {
var rows []*types.EmbedChannel
err := r.db.WithContext(ctx).
Where("tenant_id = ?", tenantID).
Order("created_at DESC").
Find(&rows).Error
return rows, err
}
func (r *embedChannelRepository) Update(ctx context.Context, ch *types.EmbedChannel) error {
return r.db.WithContext(ctx).Save(ch).Error
}
func (r *embedChannelRepository) Delete(ctx context.Context, tenantID uint64, id string) error {
return r.db.WithContext(ctx).
Where("tenant_id = ? AND id = ?", tenantID, id).
Delete(&types.EmbedChannel{}).Error
}
+18 -3
View File
@@ -148,13 +148,28 @@ func (r *sessionRepository) QueryPaged(
joinClause := "LEFT JOIN im_channel_sessions ics ON ics.session_id = s.id"
applySource := func(db *gorm.DB) *gorm.DB {
switch strings.ToLower(strings.TrimSpace(q.Source)) {
src := strings.TrimSpace(q.Source)
lower := strings.ToLower(src)
embedPrefix := types.EmbedSessionMarkerPrefix
switch lower {
case "":
return db
case "web":
return db.Where("ics.id IS NULL")
// User web chats only — exclude embed-widget sessions (same IM-null row).
return db.Where(
"ics.id IS NULL AND (s.description = '' OR s.description NOT LIKE ?)",
embedPrefix+"%",
)
case "embed":
return db.Where("ics.id IS NULL AND s.description LIKE ?", embedPrefix+"%")
default:
return db.Where("ics.platform = ?", strings.ToLower(q.Source))
if strings.HasPrefix(lower, "embed:") {
channelID := strings.TrimSpace(src[len("embed:"):])
if channelID != "" {
return db.Where("ics.id IS NULL AND s.description = ?", embedPrefix+channelID)
}
}
return db.Where("ics.platform = ?", lower)
}
}
applyAgent := func(db *gorm.DB) *gorm.DB {
@@ -222,3 +222,26 @@ func TestSessionRepositoryQueryPagedKeepsClearedIMSessionsOutOfWeb(t *testing.T)
require.ElementsMatch(t, []string{active.ID, cleared.ID}, listItemIDsForTest(wecomItems),
"wecom must include both the active and the cleared IM session")
}
func TestSessionRepositoryQueryPagedSplitsWebAndEmbedSessions(t *testing.T) {
repo, db := newSessionRepositoryForTest(t)
require.NoError(t, db.AutoMigrate(&testIMChannelSession{}))
ctx := context.Background()
web := createSessionForTest(t, db, 1, "alice")
embed := createSessionForTest(t, db, 1, "alice")
require.NoError(t, db.Model(&types.Session{}).Where("id = ?", embed.ID).
Update("description", types.EmbedSessionMarkerPrefix+"ch-1").Error)
webItems, _, err := repo.QueryPaged(ctx, &types.SessionListQuery{
TenantID: 1, UserID: "alice", Source: "web", Page: 1, PageSize: 50,
})
require.NoError(t, err)
require.Equal(t, []string{web.ID}, listItemIDsForTest(webItems))
embedItems, _, err := repo.QueryPaged(ctx, &types.SessionListQuery{
TenantID: 1, UserID: "alice", Source: "embed:ch-1", Page: 1, PageSize: 50,
})
require.NoError(t, err)
require.Equal(t, []string{embed.ID}, listItemIDsForTest(embedItems))
}