API MSP

L'API MSP expose des endpoints dédiés /partner/* pour automatiser la gestion de vos tenants. Cela permet l'intégration avec votre CRM, votre système de ticketing, vos rapports BI internes, etc.

API keys MSP

Les API keys MSP sont distinctes des API keys de tenant standard. Source : table msp_api_keys (migration 000154_msp_api_keys.up.sql).

Différences

Créer une API key MSP

1. Naviguez vers /partner/api.
2. Cliquez sur Nouvelle clé MSP.
3. Renseignez :
   • Nom : libellé interne (ex. « CI/CD Provisioning », « CRM HubSpot »)
   • Permissions : array de scopes
     • tenants:read — lister vos tenants
     • tenants:write — créer / modifier / supprimer
     • tenants:act_as — opérer comme un tenant via API
     • billing:read — lire vos factures
     • usage:read — lire la consommation
     • dashboard:read — KPIs MSP
   • Rate limit : par minute (max = msp_accounts.api_rate_limit_per_min)
4. Cliquez sur Créer. La clé est affichée une seule fois — copiez-la immédiatement.

Format : mskp_live_xxxxxxxxxxxx (32 chars hex).

La clé est hachée bcrypt en DB et n'est jamais re-affichable.

Endpoints MSP principaux

Source : secuscan-api/internal/bootstrap/routes.go + secuscan-api/internal/api/handlers/partner.go, partner_msp.go.

Tier et compte

Gestion des tenants gérés

Opérer comme un tenant

Réponse :

{
  "act_as_token": "eyJhbGc...",
  "expires_in": 3600,
  "tenant_id": "uuid-du-tenant",
  "tenant_name": "Cabinet Tremblay"
}

Vous utilisez ensuite ce act_as_token comme un Bearer JWT classique pour appeler n'importe quel endpoint tenant standard. L'action est journalisée dans audit_logs (action='msp_act_as_tenant').

Branding

Custom domains (White-Label)

Billing

Reseller code

Compliance MSP

Source : secuscan-api/internal/api/handlers/compliance_msp.go.

Exemples complets

Lister tous les tenants gérés

curl https://api.scanyze.com/v1/partner/tenants \
  -H "X-MSP-API-Key: mskp_live_xxx"

Réponse :

{
  "data": [
    {
      "id": "uuid-tenant-1",
      "name": "Cabinet Tremblay",
      "plan_slug": "pro",
      "billing_delegated": true,
      "status": "active",
      "posture_score": 78,
      "findings_open": 23,
      "findings_critical": 2,
      "ai_credits_used_this_month": 412,
      "onboarded_at": "2026-01-15T09:00:00Z"
    },
    ...
  ],
  "pagination": {
    "total": 42,
    "limit": 50,
    "offset": 0
  }
}

Créer un nouveau client en mode delegated

curl -X POST https://api.scanyze.com/v1/partner/tenants \
  -H "X-MSP-API-Key: mskp_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "organization_name": "Notaire Bouchard",
    "contact_email": "info@notairebouchard.ca",
    "contact_name": "Sylvie Bouchard",
    "plan_slug": "pro",
    "billing_delegated": true,
    "tags": ["secteur:juridique", "region:saguenay"]
  }'

Opérer comme un client (act-as) — créer une cible pour lui

# 1. Obtenir un act-as token
ACT_TOKEN=$(curl -X POST https://api.scanyze.com/v1/partner/tenants/uuid-tenant-1/act-as \
  -H "X-MSP-API-Key: mskp_live_xxx" \
  | jq -r .act_as_token)

# 2. Utiliser le token pour créer une cible chez ce tenant
curl -X POST https://api.scanyze.com/v1/targets \
  -H "Authorization: Bearer $ACT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Site corporatif",
    "domain": "notairebouchard.ca"
  }'

L'action sera journalisée dans le tenant cible avec actor=MSP MaBoite Sécurité Inc. et son audit trail.

Récupérer le dashboard MSP

curl https://api.scanyze.com/v1/partner/dashboard \
  -H "X-MSP-API-Key: mskp_live_xxx"

Réponse :

{
  "tenants_active": 42,
  "tenants_suspended": 3,
  "monthly_recurring_revenue_cad": 18435.50,
  "ai_credits_used_this_month": 14275,
  "average_posture_score": 71,
  "critical_findings_total": 89,
  "pending_actions": 12,
  "trend_30d": {
    "tenants_active": "+5",
    "mrr_pct": "+12.4",
    "posture_pct": "+3.2"
  }
}

Webhooks sortants MSP

/partner/api → onglet Webhooks

Configurer des webhooks pour recevoir les événements MSP en push :

Chaque webhook est signé HMAC-SHA256 avec le secret stocké dans /partner/api. Vérifier le header X-Scanyze-MSP-Signature.

Rate limits

Configurable par MSP via msp_accounts.api_rate_limit_per_min (défaut 60 r/min).

Maximums par tier :

Pour des intégrations à très fort volume (sync minutaire avec un CRM, par exemple), demandez un upgrade à partners@scanyze.com.

Sources de cette page

• Backend : secuscan-api/internal/api/handlers/partner.go, partner_msp.go, compliance_msp.go, custom_domains.go
• Migration : 000154_msp_api_keys.up.sql
• Modèle : secuscan-api/internal/domain/models/msp_api_key.go

À jour pour Scanyze v0.130.x.