Cloud Connectors¶
Connect your cloud marketplace accounts securely to Vell using industry-standard IAM roles.
Supported Platforms¶
| Platform | Status | Documentation |
|---|---|---|
| AWS Marketplace | ✅ Available | AWS Setup Guide |
| Azure Marketplace | 🚧 Coming Soon | - |
| Google Cloud Marketplace | 🚧 Coming Soon | - |
How It Works¶
Vell uses cross-account IAM roles to securely access your marketplace data without storing credentials:
graph LR
A[Your AWS Account] -->|IAM Role| B[Vell Platform]
B -->|AssumeRole with External ID| A
A -->|Marketplace Data| B
Security Benefits¶
- No Credentials Stored - Vell never has access to your AWS access keys
- External ID Validation - Prevents confused deputy attacks
- Least Privilege - Only marketplace API permissions granted
- Fully Revocable - Delete the IAM role anytime to revoke access
- Auditable - Full CloudFormation template transparency
Getting Started¶
Choose your cloud provider to get started:
-
AWS Marketplace
Connect your AWS Marketplace account in 5-10 minutes using CloudFormation.
-
Azure Marketplace
Azure Marketplace support coming soon.
-
Google Cloud Marketplace
GCP Marketplace support coming soon.
FAQs¶
Do you store my AWS credentials?¶
No. Vell uses temporary session credentials obtained through IAM role assumption. We never have access to your long-term AWS access keys.
Can you modify my marketplace listings?¶
No. The IAM role only has read-only permissions for AWS Marketplace APIs. We cannot create, modify, or delete any AWS resources.
How do I revoke access?¶
Simply delete the CloudFormation stack or use the "Revoke Access" button in your Vell dashboard. Access is revoked immediately.
Is this secure?¶
Yes. This follows AWS security best practices and is the same method used by major SaaS platforms like Datadog, New Relic, and CloudHealth.
For more questions, see our FAQ or Troubleshooting Guide.
Importing your listings (sync_marketplace_listings)¶
Once a Cloud Connector is verified, the sync_marketplace_listings capability imports your existing marketplace listings into Vellocity's Product catalog so other capabilities (content generation, listing optimization, predictions, co-sell matching) can operate on real listing data.
| Field | Detail |
|---|---|
| Capability slug | sync_marketplace_listings |
| Credit cost | 0 credits — no AI; pure API calls against the connected marketplace |
| Required parameters | marketplace (aws, azure, or gcp), company_id |
| Backing model | App\Models\Product (one row per imported listing) |
| Returns | synced_count (rows inserted/updated) and the raw listings payload |
When it runs. The platform schedules a sync after a connector verifies for the first time, and exposes the capability for manual re-syncs from the agent runtime. Trigger a manual run when you've made listing changes in the AWS console and want them reflected in Vellocity without waiting for the next scheduled sync.
Marketplace coverage today. AWS Marketplace is fully supported; Azure and GCP are roadmap.
Partner API access. Scope a Partner API key with manage_cloud_connections and sync_marketplace_listings to trigger syncs programmatically. See Partner API Capabilities.