Connections
The Connections page in Vince Live is used to manage and configure integrations to external systems (e.g., M3, Salesforce, Azure). Each connection contains authentication and environment details used for secure communication with external platforms.
📋 Connections List
Navigation
Go to: Administration > Connections
You will see a list of all configured connections including:
- Connection Name
- Description
- System (e.g., M3, Salesforce, Azure)
- Authentication Type (OAuth, Basic, API Key)
- Environment
- Labels
- Actions (⋮)
Actions Menu (⋮)
Available per connection:
- ✅ Validate Connection — Tests the connection parameters.
- 🔁 Revoke Certificate — Revokes linked SSL certificates (if used).
- ✏️ Edit — Opens the connection details for editing.
- 🗑️ Delete — Removes the connection.
🛠️ Edit or Create Connection
Click + New Connection or use Edit on an existing one to configure.
Required Fields
| Field | Description |
|---|---|
| Connection Name | Unique name for internal reference |
| Alias | Optional alias name |
| Description | Purpose or notes for the connection |
| System | Select system type (e.g., M3, Salesforce, Azure, Other) |
| Authentication Type | Choose from OAuth, Basic, API Key |
| Protocol | HTTP or HTTPS |
| Environment | Select an existing environment or create a new one |
| Base URI | The base endpoint of the external system |
| Token URI | (OAuth only) Token endpoint URL |
| Username | Login credential (if needed) |
| Password | Secret credential |
| Client ID / Secret | OAuth client credentials |
| Grant Type, Scope, Resource, Audience | OAuth-specific fields |
You may also:
- Use Autofill from File for certificate-based or prefilled connections.
- Check Ignore Certificate Errors if necessary.
- Enable Use Static IP when required by firewall policies.
Validate Connection
Click the Validate Connection button to confirm all settings are functional.
🧪 Best Practices
- Use descriptive Connection Names to easily identify usage.
- Group connections by Environment (e.g., DEV, TEST, PROD).
- Regularly Validate connections to prevent silent failures.
- Rotate Client Secrets and Passwords as part of your security routine.