Creating a Service Account

Guide for creating a bot user in the admin portal

Please note the below steps can only be performed by a Symphony Messaging Pod Administrator as only they will have the necessary administrator privileges to access the Admin Portal. Please do not attempt this if you are not a Pod Administrator and reach out to your internal IT Helpdesk if you are unsure who your Symphony Messaging Pod Administrator is.

If you are attempting to use the Developer Sandbox at develop2.symphony.com, this section is not relevant for you. Please register for an account at the Developer Center at developers.symphony.com and click on the request link in the welcome email to obtain your sandbox credentials.

In order to create a bot and begin your development journey, you must first create a bot user, also known as a service account. You can only do this yourself if you are a pod administrator on your Symphony Messaging pod. Otherwise, please seek assistance from your pod administrator or your internal IT Service Desk if you are unsure who to contact.

Create a Bot User

1. Navigate to your Symphony Messaging Admin Portal for your Pod

For example, https://mycompany.symphony.com/?admin

2. Select Create an Account in the left navigation pane

3. Select the Service Account tab

4. Fill in your bot information

The bot username here has to match the username supplied by a bot configuration file exactly.

5. Fill in the RSA Public Key

Paste the entire contents of the public key in the Authentication section. This public key has to match the private key supplied by a bot. If you are unsure how to generate an RSA key pair, use the Symphony Messaging Generator.

6. Set roles and entitlements

Enable the required roles that your bot requires.

Enable the required entitlements that your bot requires.

Navigate to Bot Permissions for a full list of bot roles and privileges.

7. Confirm Bot Creation