Overview
Connection Config stores the credentials and connection details needed to communicate with external systems. Before you can create inbound or outbound connections, you must first configure the connection settings for each external system.
Connection Config List
The list displays all configured connections with the following information:| Column | Description |
|---|---|
| Name | The display name of the connection configuration |
| Endpoint URL | The API endpoint or server URL for the external system |
| Actions | Edit or delete the connection configuration |
List Features
- Search - Filter configurations by name
- New Button - Create a new connection configuration
- Pagination - Navigate through multiple pages
- Items per Page - Choose 5, 10, 25, 50, or 100 items per page
Creating a Connection Config
- Click the New button from the Connection Config list
- Enter a name and endpoint URL
- Select the system type from the dropdown
- Fill in the type-specific credentials
- Click Connect to test the connection
- Click Save to store the configuration
Basic Fields
| Field | Description | Required |
|---|---|---|
| Name | A descriptive name for this connection (e.g., “[LIVE] Production SAP”, “[DEV] Test Environment”) | Yes |
| Endpoint URL | The base URL of the external system’s API | Yes |
| Type | The integration type - determines which additional fields appear | Yes |
Type-Specific Configuration
Different system types require different authentication credentials. Select the type to see the appropriate fields.SAP B1 Configuration
| Field | Description |
|---|---|
| Company DB | The SAP Business One company database name |
| Username | SAP B1 service layer username |
| Password | SAP B1 service layer password |
| Session ID | Auto-populated after successful connection |
The SAP B1 Service Layer typically runs on port 50000. Example endpoint:
https://your-sap-server:50000/b1s/v1Fentu-FSM Configuration
| Field | Description |
|---|---|
| Username | Fentu FSM user email |
| Password | Fentu FSM user password |
| Endpoint URL | The Fentu FSM API URL (e.g., https://api.fentu.io) |
Other System Types
Each system type displays its specific authentication fields when selected. Common patterns include:- API Key Authentication - Single API key field
- OAuth - Client ID and Client Secret
- Basic Auth - Username and Password
- Token-based - Access token or bearer token
Testing the Connection
Before saving, always test your connection:- Fill in all required fields
- Click the Connect button
- If successful, a session ID or confirmation will appear
- If failed, check your credentials and endpoint URL
Editing a Connection Config
- Find the configuration in the list
- Click the edit icon in the Actions column
- Update the necessary fields
- Click Re-Connect to test with new credentials
- Click Save to apply changes
Deleting a Connection Config
- Find the configuration in the list
- Click the delete icon in the Actions column
- Confirm the deletion
Security Best Practices
Use Descriptive Names with Environment Tags
Use Descriptive Names with Environment Tags
Create Service Accounts
Create Service Accounts
Create dedicated service accounts in external systems for Fentu Connect rather than using personal user credentials. This:
- Improves security
- Simplifies credential rotation
- Provides clearer audit trails
Rotate Credentials Regularly
Rotate Credentials Regularly
Implement a schedule to rotate API keys and passwords periodically. Update the Connection Config when credentials change.
Principle of Least Privilege
Principle of Least Privilege
Grant the minimum permissions necessary for the integration to function. Avoid using admin-level credentials when read-only access is sufficient.
Troubleshooting
Connection Test Fails
Connection Test Fails
Common causes:
- Incorrect endpoint URL (check for typos, missing port numbers)
- Invalid credentials
- Network firewall blocking the connection
- External system is down or unreachable
- SSL/TLS certificate issues
- Verify the endpoint URL is correct
- Confirm credentials work by logging into the external system directly
- Check if the Fentu Connect server can reach the external system (firewall rules, VPN)
Connection Works But Data Doesn't Sync
Connection Works But Data Doesn't Sync
The Connection Config only establishes connectivity. If data isn’t syncing:
- Check the Inbound/Outbound connection settings
- Verify field mappings are correct
- Ensure the connection is marked as Active
- Check the service account has permissions to read/write the relevant data
Session Expired Errors
Session Expired Errors
Some systems (like SAP B1) use session-based authentication that expires. Fentu Connect automatically handles session renewal in most cases. If you see persistent session errors:
- Verify the credentials are still valid
- Check if the external system has session limits or timeouts configured
Related Documentation
Inbound Connections
Configure inbound data connections using your Connection Config
Outbound Connections
Configure outbound data connections using your Connection Config
Connector
Create connectors that use your Connection Config
Connect Wizard
Quickly set up integrations with guided wizard