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

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.