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 |
---|---|---|
| Lists currently installed Services. |
|
| Kicks off the Service creation wizard. |
|
| Deletes a single Service configuration. |
|
Usage details
list
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
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
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.
Updated 8 months ago