feat(16-03): add Postman and SwaggerHub recon sources

- PostmanSource searches public collections via internal search proxy
- SwaggerHubSource searches published API specs for embedded keys
- Both credentialless, use BuildQueries + ciLogKeyPattern
- httptest-based tests for both sources

pkg/recon/sources/postman.go

@@ -0,0 +1,98 @@
+package sources
+
+import (
+	"context"
+	"fmt"
+	"io"
+	"net/http"
+	"net/url"
+	"time"
+
+	"golang.org/x/time/rate"
+
+	"github.com/salvacybersec/keyhunter/pkg/providers"
+	"github.com/salvacybersec/keyhunter/pkg/recon"
+)
+
+// PostmanSource searches public Postman collections and workspaces for
+// hardcoded API keys. The Postman public network exposes a search proxy
+// that does not require authentication.
+type PostmanSource struct {
+	BaseURL  string
+	Registry *providers.Registry
+	Limiters *recon.LimiterRegistry
+	Client   *Client
+}
+
+var _ recon.ReconSource = (*PostmanSource)(nil)
+
+func (s *PostmanSource) Name() string              { return "postman" }
+func (s *PostmanSource) RateLimit() rate.Limit      { return rate.Every(3 * time.Second) }
+func (s *PostmanSource) Burst() int                 { return 3 }
+func (s *PostmanSource) RespectsRobots() bool       { return false }
+func (s *PostmanSource) Enabled(_ recon.Config) bool { return true }
+
+func (s *PostmanSource) Sweep(ctx context.Context, query string, out chan<- recon.Finding) error {
+	base := s.BaseURL
+	if base == "" {
+		base = "https://www.postman.com/_api"
+	}
+	client := s.Client
+	if client == nil {
+		client = NewClient()
+	}
+
+	queries := BuildQueries(s.Registry, "postman")
+	if len(queries) == 0 {
+		return nil
+	}
+
+	for _, q := range queries {
+		if err := ctx.Err(); err != nil {
+			return err
+		}
+
+		if s.Limiters != nil {
+			if err := s.Limiters.Wait(ctx, s.Name(), s.RateLimit(), s.Burst(), false); err != nil {
+				return err
+			}
+		}
+
+		// Use Postman's internal search proxy. The encoded request parameter
+		// targets /search/all with the query text.
+		searchPath := fmt.Sprintf("/search/all?querytext=%s&size=10&type=all",
+			url.QueryEscape(q))
+		searchURL := fmt.Sprintf("%s/ws/proxy?request=%s",
+			base, url.QueryEscape(searchPath))
+
+		req, err := http.NewRequestWithContext(ctx, http.MethodGet, searchURL, nil)
+		if err != nil {
+			continue
+		}
+
+		resp, err := client.Do(ctx, req)
+		if err != nil {
+			continue
+		}
+
+		data, err := io.ReadAll(io.LimitReader(resp.Body, 512*1024))
+		_ = resp.Body.Close()
+		if err != nil {
+			continue
+		}
+
+		// Scan the raw response body for key patterns. Postman search results
+		// include snippets of collection contents where keys may appear.
+		content := string(data)
+		if ciLogKeyPattern.MatchString(content) {
+			out <- recon.Finding{
+				ProviderName: q,
+				Source:       fmt.Sprintf("https://www.postman.com/search?q=%s", url.QueryEscape(q)),
+				SourceType:   "recon:postman",
+				Confidence:   "medium",
+				DetectedAt:   time.Now(),
+			}
+		}
+	}
+	return nil
+}