Credentials

Manage secrets, API keys, and OAuth connections for your workflows

Credentials provide a secure way to manage API keys, tokens, and third-party service connections across your workflows. Instead of hardcoding sensitive values into your workflow, you store them as credentials and reference them at runtime.

SteelEngine supports two categories of credentials: secrets for static values like API keys, and OAuth accounts for authenticated service connections like Google or Slack.

Provider API keys for hosted models (OpenAI, Anthropic, Google, and others) are managed separately as Bring Your Own Key keys. SteelEngine applies a BYOK key automatically whenever a block calls that provider. A secret is a value you reference yourself.

Getting Started

To manage secrets, open your workspace Settings and navigate to the Secrets tab. OAuth accounts and other service connections live in the Integrations tab.

Settings modal showing the Secrets tab with a list of saved credentials

From here you can search, add, edit, and delete secrets. Workspace secrets and your personal secrets appear in separate sections of the same grid.

Secrets

Secrets are key-value pairs that store sensitive data like API keys, tokens, and passwords. Each secret has a key (used to reference it in workflows) and a value (the actual secret).

Creating a Secret

You edit secrets in place. Each section of the grid ends with an empty row. When you save, SteelEngine creates, updates, or deletes secrets to match the grid.

Choose the section — Workspace (shared with your team) or Personal (private to you)

In the empty row, enter a Key name (letters, numbers, and underscores only, e.g. OPENAI_API_KEY)

Enter the Value. A new empty row appears below for the next secret

Click Save

Optionally click Details on the saved row to add a Description for your team, then Save the details

Adding, changing, or deleting Workspace secrets requires workspace:manage_environment, which is included in the workspace Admin role. Every member manages their own Personal secrets. Permission to write a value does not grant permission to reveal it.

Reading Secret Values

For PostgreSQL-backed secrets, management readback follows the rules below. On installations using Azure Key Vault storage, the Secrets management UI and API return metadata for Vault-backed workspace entries. The trusted runtime resolves the stored reference when a workflow uses the secret.

CallerValue access
Workspace environment readerMasked workspace values, except for secrets they actively administer
User with workspace:read_environment_valuesAuthorized workspace values
Active credential AdminThat credential's value, subject to workspace access
Personal secret ownerTheir personal values
Workload identityNames-only listing and independently granted writes; no plaintext-read operation

API keys owned by users must satisfy both the owner's authorization and the key's own scope and permission ceiling. See environment operations through MCP.

Successful management reads that return values emit an environment.values_revealed audit event containing the actor, scope, and counts, without values. Audit recording is best effort. Environment HTTP responses prevent caching, and failures return generic errors without echoing secret inputs.

Using Secrets in Workflows

To reference a secret in any input field, type {{ to open the dropdown. It will show your available secrets grouped by scope.

Typing {{ in a code block opens a dropdown showing available workspace secrets

Select the secret you want to use. The reference will appear highlighted in blue, indicating it will be resolved at runtime.

A resolved secret reference shown in blue text as {{OPENAI_API_KEY}}

Secret references resolve during execution. Diagnostic redaction does not prevent workflow code from returning a secret or sending it to another service. Control who can modify and execute secret-using workflows if those users must not be able to disclose the values.

Bulk Import

You can import multiple secrets at once by pasting .env-style content:

  1. Copy your environment variables in KEY=VALUE format
  2. Paste them into any Key or Value cell of the section you want them in
  3. Review the new rows, one per line
  4. Click Save

The parser supports standard KEY=VALUE pairs, an optional export prefix, quoted values, comments (#), and blank lines. If the pasted text has no KEY=VALUE lines, SteelEngine inserts it into the cell as a single value.

GitHub repository review uses a separate organization-owned GitHub App. Set it up under Settings > Source Control, where you can browse or create repositories and map an environment branch. See Connect GitHub. Workflow-action OAuth accounts remain separate.

Manage saved repository connections under Settings > Integrations > GitHub Source Control with organization settings permission. Remove disconnects an unused SteelEngine connection and keeps its history; it leaves the GitHub repository and workflow-action OAuth accounts intact. An authentication error does not prove repository deletion. See connection checks and removal.

OAuth Accounts

OAuth accounts are authenticated connections to third-party services like Google, Slack, GitHub, and more. SteelEngine handles the OAuth flow, token storage, and automatic refresh.

You can connect multiple accounts per provider — for example, two separate Gmail accounts for different workflows.

Authorizing the same personal account again reuses its existing workspace connection and preserves its saved name and sharing settings. After authorization, SteelEngine identifies an already-connected account by that saved name; it does not create a second connection with the new draft name.

For Slack and Salesforce, you can also use an OAuth app your workspace owns. See Custom Apps for setup, manifest review, and connection permissions. Slack bot installations are workspace integrations; personal Slack connections use private user tokens for actions.

The Integrations tab groups available connections into:

  • Workspace installations — Slack bot installations you own, that are shared with you, or that you are allowed to use.
  • My connections — Accounts and credentials you connected.
  • Shared with me — Connections shared with you directly or through a permission group.

Other members' personal connections are not listed merely because you belong to the workspace. Read-only shared connections can appear even when you cannot use them; each action still requires its own permission. Personal Slack user-token connections remain private to their owner.

Connecting an OAuth Account

Open your workspace Settings, go to the Integrations tab, and click Connect (or Connect / Add account next to a listed service)

In Connect Integration, search for the service and select it. If the same account is already connected elsewhere in your organization, you can reuse it here or choose Connect a different account

Enter a Display name to identify this connection (e.g. "Work Gmail" or "Marketing Slack")

Optionally add a Description

Click Connect (or Use this connection when reusing an account) and complete the authorization flow

The same Connect flow also adds two connections that do not use OAuth:

  • Google Service Account: paste a JSON key file. See Google Service Accounts.
  • Apprise ERP: enter a username, password, tenant URL, and system ID. After you save it, the Details panel offers a connection test.

Connecting from Chat or MCP

Chat and MCP can return a connection link when you ask to connect a service or an integration needs credentials. Open the link in your browser. If you are signed out of SteelEngine, sign in with the same SteelEngine account that requested the link; then continue to the provider's authorization screen.

Links under /connect/ expire after 30 minutes and can be used once. A Wrong Account message means you need to switch to the requesting SteelEngine account. For an expired or already-used link, ask the assistant for a new one. If you cancel the provider's authorization after opening the link, request a new link before trying again.

The link keeps the workspace and any workflow or chat context from the request. Trello and Shopify use their own authorization routes instead of this connection-link flow.

Using OAuth Accounts in Workflows

Blocks that require authentication (e.g. Gmail, Slack, Google Sheets) display a credential selector dropdown. Select the OAuth account you want the block to use. Slack credential choices include the connected workspace name so you can distinguish installations of the same app.

Gmail block showing the account selector dropdown with a connected account and option to connect another

You can also connect additional accounts directly from the block by selecting Connect another account at the bottom of the dropdown.

If a block requires an OAuth connection and none is selected, the workflow will fail at that step.

Workspace vs. Personal

Credentials can be scoped to your workspace (shared with your team) or kept personal (private to you).

WorkspacePersonal
VisibilityAll workspace membersOnly you
Use in workflowsAny member can useOnly you can use
Best forProduction workflows, shared servicesTesting, personal API keys
Who can editUsers with workspace:manage_environmentOnly you
Auto-sharedYes — all members get access on creationNo — only you have access

When a workspace and personal secret share the same key name, the workspace secret takes precedence.

Resolution Order

When a workflow runs, SteelEngine resolves secrets in this order:

  1. Workspace secrets are checked first
  2. Personal secrets are used as a fallback — from the user who triggered the run (manual) or the workflow owner (automated runs via API, webhook, or schedule)

The fallback uses that user's own personal secrets. For a user who is not the workspace owner, it also includes personal secrets that other members shared with them. If several of those secrets use the same key, the user's own value wins. Otherwise the most recently updated one wins.

Access Control

Each credential has role-based access control:

  • Admin — can view, edit, delete, and manage who has access
  • Member — can use the credential in workflows (read-only)

When you create a workspace secret, all current workspace members are automatically granted access. Personal secrets are only accessible to you by default.

Sharing a Credential

To share a credential with specific team members:

  1. Click Details on the credential
  2. Under Members, pick a workspace member from Add member...
  3. Choose Admin or Member as the Role and click Add

The member picker shows names and email addresses so you can distinguish accounts with the same name. Search by either name or email.

Only a credential's admins can manage its members, and the last admin cannot be removed.

Best Practices

  • Use workspace credentials for production so workflows work regardless of who triggers them
  • Use personal credentials for development to keep your test keys separate
  • Name keys descriptively — STRIPE_SECRET_KEY over KEY1
  • Connect multiple OAuth accounts when you need different permissions or identities per workflow
  • Never hardcode secrets in workflow input fields — always use {{KEY}} references

Common Questions

Yes. Values stored in PostgreSQL are encrypted before storage. Installations with native Azure Key Vault can store eligible workspace secret values in the approved vault and keep references in PostgreSQL. Authorized users can retrieve local values through secret management. Workflow code with permission to use a secret can disclose it in results or outbound requests.
The workspace secret takes precedence. During execution, the resolver checks workspace secrets first and uses personal secrets only as a fallback. This ensures that production workflows use the shared, team-managed value.
For manual runs, the personal secrets of the user who clicked Run are used as fallback. For automated runs triggered by API, webhook, or schedule, the personal secrets of the workflow owner are used instead. In both cases, personal secrets that other members shared with that user are included. On a duplicate key, the user's own value wins.
Yes. When an OAuth token is used during execution, the platform checks whether the access token has expired and automatically refreshes it using the stored refresh token before making the API call. You do not need to handle token refresh manually.
Yes. You can connect multiple accounts per provider (for example, two separate Gmail accounts). Each block that requires OAuth lets you select which specific account to use from the credential dropdown. This is useful when different workflows or blocks need different permissions or identities.
If a block references a deleted credential, the workflow will fail at that block during execution because the credential cannot be resolved. Make sure to update any blocks that reference a credential before deleting it.
Yes. Paste .env-style content in KEY=VALUE format into any key or value cell of the Secrets grid. Each line becomes a row in that section. The parser supports an export prefix, quoted values, comments (lines starting with #), and blank lines. Click Save to create them.

On this page