Manage Services

Set up and configure integrated Services in Sym.

Overview

Services are Sym's representation of external systems, both for control (e.g. Slack) and for execution (e.g. AWS SSO). Each Service is represented as:

  • Service Type -- the Sym-defined service_type, e.g. slack
  • External ID -- the external ID of the specific service, e.g. Slack Workspace ID
  • Label -- a User-supplied string for each external Service, e.g. slack-test

While Services do not need to be configured in order to add Users, they do need to be configured for Users to do anything meaningful.

πŸ“˜

Don't forget the help command!

When in doubt, -h or --help will tell you everything you need to know.

Commands

Command

What it does

Example

list

Lists currently installed Services.

symflow services list

create

Kicks off the Service creation wizard.

symflow services create

delete

Deletes a single Service configuration.

symflow services delete slack

Usage details

list

$ symflow services list
Service Type   External ID                        Label
-------------  ---------------------------------  -------------------
sym            cloud                              Sym
aws_sso        arn:aws:sso:::instance/1234567890  AWS SSO:Sym test
slack          T234567890                         Slack: Healthy-Health

create

If you know the Service you're trying to configure, you can declare it directly to kick off the relevant setup process, e.g.:

$ symflow services create --service-type google
Email domain: ...

Alternatively, you can omit the --service-type, which will kick off a wizard that:

  • Shows you all available services and prompts for selection
  • Walks you through the configuration for which ever service you enter

delete

Use this command to delete a Service. Note that if a Service has User identities associated with it, you will not be able to delete it directly, and will receive a warning. In that case, run symflow users update, delete all IDs associated with the Service you're trying to delete, and try again.

For more information on managing Users, read on.


What’s Next
Did this page help you?