Prerequisites
- A Corridor account with a team created
- Owner role on your Corridor team
- A Devin account with permission to edit environments and organization secrets
- The repository imported into Corridor as a project
Setup
The order of these steps matters. Devin runs your environment configuration while it builds the snapshot, so the secret has to exist before you save the configuration.1
Open the Long-Running Agents page in Corridor
In the Corridor dashboard, navigate to Governance > Long-Running Agents and click the Configuration tab.Select Devin from the agent options.
2
Open your Devin settings
Go to app.devin.ai/settings. On Devin Enterprise, use your own subdomain instead —
https://<subdomain>.devinenterprise.com/settings.3
Generate a Corridor API key
Back in the Corridor Configuration tab, enter a name for your key (for example, “Devin cloud agents”) and click Generate key.Copy the full API key that is displayed in the modal. Note that the key is only shown once.
4
Add the API key as an organization secret in Devin
In your Devin settings, open the Organization tab and add a secret:
- Name:
CORRIDOR_API_KEY - Value: the API key you copied — the key on its own, not
CORRIDOR_API_KEY=<key>
5
Paste the setup snippet into your environment configuration
Copy the snippet shown in the Corridor Configuration timeline and paste it into your Devin environment configuration:
6
Build a snapshot
Devin runs the
initialize step when it builds a machine snapshot, so nothing is installed until it does. If the environment already has a snapshot, rebuild it to pick this up.Devin installs the Corridor CLI while building the snapshot, so the environment needs outbound network access. If your environment restricts network access, add these domains to the allowlist:
app.corridor.devgithub.comrelease-assets.githubusercontent.com
How it works
Once configured, your Devin environment will:- Install the Corridor CLI
- Install a git pre-commit hook
- Scan staged changes before each commit
- Block commits that contain security findings
Keeping a snapshot current
Devin fetches the setup script while building the snapshot, not at the start of each session. A snapshot keeps the version of the script — and of the Corridor CLI — that was current on the day it was built. Rebuild the snapshot to pick up Corridor updates. Rotating the API key also needs a rebuild, because the token is written into the snapshot.Managing API keys
You can view and revoke API keys in the Configuration tab under Team-Owned API Keys. Each key shows its name, creation date, and last used date. To rotate a key:- Generate a new key in Corridor
- Update the
CORRIDOR_API_KEYsecret in your Devin organization settings - Rebuild the environment’s snapshot so it picks up the new key
- Revoke the old key
Next steps
Guardrails
Configure the security rules that your agents enforce.
Findings
Learn how to review and resolve security findings.