Add five API-key access-review connectors
Add Mercury, Apollo.io, Deepgram, ClickHouse Cloud, and Langfuse as access-review connectors. All are API-key, single-tenant providers (Pattern 3): the key identifies one tenant, so there is no OAuth flow, picker UI, or bootstrap/helm configuration. - Mercury: Bearer token, GET /api/v1/users, cursor pagination. - Apollo.io: x-api-key header, GET /api/v1/users/search (teammates). - Deepgram: Token scheme; lists members across every project and dedupes by member_id, unioning per-project scopes. - ClickHouse Cloud: HTTP Basic (keyId:keySecret); discovers the org via GET /v1/organizations, then lists its members. - Langfuse: HTTP Basic (publicKey:secretKey); a base-URL setting selects the regional cloud host or a self-hosted instance. Each adds the enum value, migration, GraphQL binding, provider Registration, a driver with a cassette-driven test, and a brand logo. Signed-off-by: Aurélien Sibiril <81782+aureliensibiril@users.noreply.github.com>
This commit is contained in:
Aurélien Sibiril
244
pkg/accessreview/drivers/deepgram.go
Normal file
244
pkg/accessreview/drivers/deepgram.go
Normal file
@@ -0,0 +1,244 @@
|
||||
// Copyright (c) 2026 Probo Inc <hello@probo.com>.
|
||||
//
|
||||
// Permission to use, copy, modify, and/or distribute this software for any
|
||||
// purpose with or without fee is hereby granted, provided that the above
|
||||
// copyright notice and this permission notice appear in all copies.
|
||||
//
|
||||
// THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
|
||||
// REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
|
||||
// AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
|
||||
// INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
|
||||
// LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
|
||||
// OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
|
||||
// PERFORMANCE OF THIS SOFTWARE.
|
||||
|
||||
package drivers
|
||||
|
||||
import (
|
||||
"context"
|
||||
"encoding/json"
|
||||
"fmt"
|
||||
"net/http"
|
||||
"net/url"
|
||||
"strings"
|
||||
|
||||
"go.probo.inc/probo/pkg/coredata"
|
||||
)
|
||||
|
||||
const deepgramAPIBaseURL = "https://api.deepgram.com"
|
||||
|
||||
// DeepgramDriver lists the members of every Deepgram project the API key
|
||||
// can access. The key (presented in the `Authorization: Token <key>`
|
||||
// scheme by the connection transport) is scoped to a single account, whose
|
||||
// members may span several projects; the driver aggregates them and dedupes
|
||||
// by member_id, unioning each member's per-project scopes.
|
||||
type DeepgramDriver struct {
|
||||
httpClient *http.Client
|
||||
}
|
||||
|
||||
var _ Driver = (*DeepgramDriver)(nil)
|
||||
|
||||
type deepgramProject struct {
|
||||
ProjectID string `json:"project_id"`
|
||||
Name string `json:"name"`
|
||||
}
|
||||
|
||||
type deepgramProjectsResponse struct {
|
||||
Projects []deepgramProject `json:"projects"`
|
||||
}
|
||||
|
||||
type deepgramMember struct {
|
||||
MemberID string `json:"member_id"`
|
||||
Email string `json:"email"`
|
||||
FirstName string `json:"first_name"`
|
||||
LastName string `json:"last_name"`
|
||||
Scopes []string `json:"scopes"`
|
||||
}
|
||||
|
||||
type deepgramMembersResponse struct {
|
||||
Members []deepgramMember `json:"members"`
|
||||
}
|
||||
|
||||
func NewDeepgramDriver(httpClient *http.Client) *DeepgramDriver {
|
||||
return &DeepgramDriver{httpClient: httpClient}
|
||||
}
|
||||
|
||||
func (d *DeepgramDriver) ListAccounts(ctx context.Context) ([]AccountRecord, error) {
|
||||
projects, err := d.fetchProjects(ctx)
|
||||
if err != nil {
|
||||
return nil, err
|
||||
}
|
||||
|
||||
// Aggregate members across projects, preserving first-seen order and
|
||||
// unioning the scopes a member holds in each project.
|
||||
order := make([]string, 0)
|
||||
merged := make(map[string]*deepgramMember)
|
||||
|
||||
for _, project := range projects {
|
||||
members, err := d.fetchProjectMembers(ctx, project.ProjectID)
|
||||
if err != nil {
|
||||
return nil, err
|
||||
}
|
||||
|
||||
for _, m := range members {
|
||||
existing, ok := merged[m.MemberID]
|
||||
if !ok {
|
||||
copied := m
|
||||
merged[m.MemberID] = &copied
|
||||
order = append(order, m.MemberID)
|
||||
|
||||
continue
|
||||
}
|
||||
|
||||
existing.Scopes = deepgramUnionScopes(existing.Scopes, m.Scopes)
|
||||
}
|
||||
}
|
||||
|
||||
records := make([]AccountRecord, 0, len(order))
|
||||
|
||||
for _, id := range order {
|
||||
m := merged[id]
|
||||
|
||||
email := strings.TrimSpace(m.Email)
|
||||
if email == "" {
|
||||
continue
|
||||
}
|
||||
|
||||
records = append(records, AccountRecord{
|
||||
Email: email,
|
||||
FullName: deepgramFullName(*m, email),
|
||||
Roles: deepgramRoles(m.Scopes),
|
||||
IsAdmin: deepgramIsAdmin(m.Scopes),
|
||||
MFAStatus: coredata.MFAStatusUnknown,
|
||||
AuthMethod: coredata.AccessReviewEntryAuthMethodUnknown,
|
||||
AccountType: coredata.AccessReviewEntryAccountTypeUser,
|
||||
ExternalID: strings.TrimSpace(m.MemberID),
|
||||
})
|
||||
}
|
||||
|
||||
return records, nil
|
||||
}
|
||||
|
||||
func (d *DeepgramDriver) fetchProjects(ctx context.Context) ([]deepgramProject, error) {
|
||||
endpoint, err := url.JoinPath(deepgramAPIBaseURL, "v1", "projects")
|
||||
if err != nil {
|
||||
return nil, fmt.Errorf("cannot build deepgram projects URL: %w", err)
|
||||
}
|
||||
|
||||
req, err := http.NewRequestWithContext(ctx, http.MethodGet, endpoint, nil)
|
||||
if err != nil {
|
||||
return nil, fmt.Errorf("cannot create deepgram projects request: %w", err)
|
||||
}
|
||||
|
||||
req.Header.Set("Accept", "application/json")
|
||||
|
||||
httpResp, err := d.httpClient.Do(req)
|
||||
if err != nil {
|
||||
return nil, fmt.Errorf("cannot execute deepgram projects request: %w", err)
|
||||
}
|
||||
|
||||
defer func() {
|
||||
_ = httpResp.Body.Close()
|
||||
}()
|
||||
|
||||
if httpResp.StatusCode < 200 || httpResp.StatusCode >= 300 {
|
||||
return nil, fmt.Errorf("cannot fetch deepgram projects: unexpected status %d", httpResp.StatusCode)
|
||||
}
|
||||
|
||||
var resp deepgramProjectsResponse
|
||||
if err := json.NewDecoder(httpResp.Body).Decode(&resp); err != nil {
|
||||
return nil, fmt.Errorf("cannot decode deepgram projects response: %w", err)
|
||||
}
|
||||
|
||||
return resp.Projects, nil
|
||||
}
|
||||
|
||||
func (d *DeepgramDriver) fetchProjectMembers(ctx context.Context, projectID string) ([]deepgramMember, error) {
|
||||
endpoint, err := url.JoinPath(deepgramAPIBaseURL, "v1", "projects", url.PathEscape(projectID), "members")
|
||||
if err != nil {
|
||||
return nil, fmt.Errorf("cannot build deepgram members URL: %w", err)
|
||||
}
|
||||
|
||||
req, err := http.NewRequestWithContext(ctx, http.MethodGet, endpoint, nil)
|
||||
if err != nil {
|
||||
return nil, fmt.Errorf("cannot create deepgram members request: %w", err)
|
||||
}
|
||||
|
||||
req.Header.Set("Accept", "application/json")
|
||||
|
||||
httpResp, err := d.httpClient.Do(req)
|
||||
if err != nil {
|
||||
return nil, fmt.Errorf("cannot execute deepgram members request: %w", err)
|
||||
}
|
||||
|
||||
defer func() {
|
||||
_ = httpResp.Body.Close()
|
||||
}()
|
||||
|
||||
if httpResp.StatusCode < 200 || httpResp.StatusCode >= 300 {
|
||||
return nil, fmt.Errorf("cannot fetch deepgram members: unexpected status %d", httpResp.StatusCode)
|
||||
}
|
||||
|
||||
var resp deepgramMembersResponse
|
||||
if err := json.NewDecoder(httpResp.Body).Decode(&resp); err != nil {
|
||||
return nil, fmt.Errorf("cannot decode deepgram members response: %w", err)
|
||||
}
|
||||
|
||||
return resp.Members, nil
|
||||
}
|
||||
|
||||
func deepgramFullName(m deepgramMember, fallback string) string {
|
||||
fullName := strings.TrimSpace(strings.TrimSpace(m.FirstName) + " " + strings.TrimSpace(m.LastName))
|
||||
if fullName != "" {
|
||||
return fullName
|
||||
}
|
||||
|
||||
return fallback
|
||||
}
|
||||
|
||||
func deepgramUnionScopes(a, b []string) []string {
|
||||
seen := make(map[string]bool, len(a))
|
||||
out := make([]string, 0, len(a)+len(b))
|
||||
|
||||
for _, scopes := range [][]string{a, b} {
|
||||
for _, s := range scopes {
|
||||
if seen[s] {
|
||||
continue
|
||||
}
|
||||
|
||||
seen[s] = true
|
||||
|
||||
out = append(out, s)
|
||||
}
|
||||
}
|
||||
|
||||
return out
|
||||
}
|
||||
|
||||
// deepgramRoles derives a role label from a member's scopes. Deepgram has no
|
||||
// dedicated role field; ownership/administration is expressed through the
|
||||
// scope list. Unknown scope sets fall back to "Member".
|
||||
func deepgramRoles(scopes []string) []string {
|
||||
switch {
|
||||
case deepgramHasScope(scopes, "owner"):
|
||||
return []string{"Owner"}
|
||||
case deepgramHasScope(scopes, "admin"):
|
||||
return []string{"Admin"}
|
||||
default:
|
||||
return []string{"Member"}
|
||||
}
|
||||
}
|
||||
|
||||
func deepgramIsAdmin(scopes []string) bool {
|
||||
return deepgramHasScope(scopes, "owner") || deepgramHasScope(scopes, "admin")
|
||||
}
|
||||
|
||||
func deepgramHasScope(scopes []string, want string) bool {
|
||||
for _, s := range scopes {
|
||||
if strings.EqualFold(strings.TrimSpace(s), want) {
|
||||
return true
|
||||
}
|
||||
}
|
||||
|
||||
return false
|
||||
}
|
||||
Reference in New Issue
Block a user