Getting Started
Symphony bot clients require a JSON configuration file called config.json
that contains configuration information.
This JSON configuration file is generated by the Symphony bot generator. Its format and contents are the same across all implementation languages. The file contains the following information:
- Session Auth Host and Port
- Key Auth Host and Port
- Pod Host and Port
- Agent Host and Port
- Bot details
- Certificate Path and Password
The following shows an example of the configuration file:
{
"sessionAuthHost": "YOUR-POD-SUBDOMAIN-api.symphony.com",
"sessionAuthPort": 8444,
"keyAuthHost": "YOUR-POD-SUBDOMAIN-api.symphony.com",
"keyAuthPort": 8444,
"podHost": "YOUR-POD-SUBDOMAIN.symphony.com",
"podPort": 443,
"agentHost": "YOUR-POD-SUBDOMAIN.symphony.com",
"agentPort": 443,
"botCertPath": "PATH",
"botCertName": "BOT-CERT-NAME",
"botCertPassword": "BOT-PASSWORD",
"botEmailAddress": "BOT-EMAIL-ADDRESS",
"appCertPath": "",
"appCertName": "",
"appCertPassword": "",
"proxyURL": "",
"proxyUsername": "",
"proxyPassword": "",
"authTokenRefreshPeriod": "30"
}
Note:
• sessionAuthHost
: Your Pod url in Symphony, used for session authentication.
• sessionAuthPort
: Port used for session authentication. For cloud deployments, use 8444.
In-Cloud Deployments
In-cloud deployments of Symphony use the following formats as both the Agent URL and the Key Auth URL are the same as your pod subdomain:
- Session Auth URL: YOUR-POD-SUBDOMAIN-api.symphony.com:8444
- Key Auth URL: YOUR-POD-SUBDOMAIN-api.symphony.com:8444
- Pod Url: YOUR-POD-SUBDOMAIN.symphony.com:443
- Agent Url: YOUR-POD-SUBDOMAIN.symphony.com:443
Enterprise Deployments
For enterprise deployments of Symphony, the Agent URL and the Key Auth URL may differ from your pod subdomain because the Symphony software is deployed on premise. Therefore, enterprise deployments use the following formats:
- Session Auth URL: YOUR-POD-SUBDOMAIN-api.symphony.com:8444
- Key Auth URL: YOUR-KEYAUTH-URL-api.symphony.com:YOUR-PORT
- Pod Url: YOUR-POD-SUBDOMAIN.symphony.com:443
- Agent Url: YOUR-AGENT-URL.symphony.com:YOUR-PORT
Contact your Symphony administrator for details. For more information, see Authentication.
Contributing to the SDKs
If you see any missing functionality, or have suggested improvements, we encourage you to consider contributing to our code base.
Symphony SDKs are open-source, which means they are free for you to utilize and to contribute to. We’d also like to continuously improve our SDKs. If you find any bugs or think of ways to improve the Symphony SDKs, please feel free to share them with the Symphony team. You can follow the following simple process to become a contributor:
- Fork the Symphony API client repository
- Create your developer branch, add your codes, commit, and push
- Test your branch and merge with master
- Create a Pull Request (PR) on the public repository
- The Symphony team will review and either Approve, Request Changes, or Reject your PR
- Once approved, your codes will be part of the next minor release (frequency is once a month)
The process is straightforward, so why wait? We welcome you to contribute now!
Updated 5 months ago
What's Next
To learn more about certificates and authentication, click below.
Get Started with Node.js |
Get Started with Java |
Get Started with .NET |