# Access Control Lists | Cycle.io

Canonical URL: https://cycle.io/docs/platform/access-control-lists

## Access Control Lists.

Access Control Lists (ACLs) are used to limit access to specific resources within a hub based on [role](https://cycle.io/docs/platform/roles-and-capabilities).

### ACL Resources

ACLs can be applied to the following resource types on Cycle:

-   [Environments](https://cycle.io/docs/platform/introduction-to-environments)
-   [Image Sources](https://cycle.io/docs/platform/image-sources)
-   [Stacks](https://cycle.io/docs/platform/introduction-to-stacks)
-   [Pipelines](https://cycle.io/docs/platform/introduction-to-pipelines)
-   [Clusters](https://cycle.io/docs/platform/clusters)
-   [DNS Zone](https://cycle.io/docs/platform/dns-zones)
-   [Networks (SDN)](https://cycle.io/docs/platform/introduction-to-networks)

### ACL Permissions

There are three ACL permissions that can be toggled on and off per role listed on the ACL.

-   `view`: the role can view the resource
-   `modify`: the role can change the resource itself, but excludes the ability to delete the resource or modify the ACL of the resource
-   `manage`: the role can delete the resource and the role can update the ACL for the given resource

When a role is set on an ACL, but no permissions are enabled, the role is essentially unable to interact with that resource in any capacity.

It is possible to combine any 3 permissions, such as `modify` and `manage`, but not `view` (though this will make it impossible to view in the Portal).

### Combining Capabilities and ACLs

Capabilities dictate what a role **CAN** do within a hub, while the ACL limits what the role can do on a resource.

For example, say we wanted to grant "view" permissions to an environment for a role. That role **MUST** have the `environments-view` capability, otherwise it would not be able to view the environment with the ACL, even with that role specifically set to view. The role is not "capable" of viewing environments, so the ACL doesn't matter.

### Layering Cluster ACLs with Cluster Resources

Some resources, such as environments, fall under a [cluster](https://cycle.io/docs/platform/clusters). When an environment or other cluster resource does not have its own ACL set, it will be subject to the ACL of the cluster instead.

<div class="joplin-table-wrapper"><table class="lexical-table" style="border-collapse:collapse"><tbody><tr class="lexical-table-row"><th class="lexical-table-cell lexical-table-cell-header-1" style="border:1px solid #ccc;padding:8px"><p>Resource</p></th><th class="lexical-table-cell lexical-table-cell-header-1" style="border:1px solid #ccc;padding:8px"><p>View</p></th><th class="lexical-table-cell lexical-table-cell-header-1" style="border:1px solid #ccc;padding:8px"><p>Modify</p></th><th class="lexical-table-cell lexical-table-cell-header-1" style="border:1px solid #ccc;padding:8px"><p>Manage</p></th><th class="lexical-table-cell lexical-table-cell-header-1" style="border:1px solid #ccc;padding:8px"><p>Description</p></th></tr><tr class="lexical-table-row"><td class="lexical-table-cell lexical-table-cell-header-0" style="border:1px solid #ccc;padding:8px"><p>Environment</p></td><td class="lexical-table-cell lexical-table-cell-header-0" style="border:1px solid #ccc;padding:8px"><p>&lt;FontAwesomeIcon icon={faCheck} /&gt;</p></td><td class="lexical-table-cell lexical-table-cell-header-0" style="border:1px solid #ccc;padding:8px"><ul class="list-bullet"><li data-index="01" value="1"></li></ul></td><td class="lexical-table-cell lexical-table-cell-header-0" style="border:1px solid #ccc;padding:8px"><ul class="list-bullet"><li data-index="01" value="1"></li></ul></td><td class="lexical-table-cell lexical-table-cell-header-0" style="border:1px solid #ccc;padding:8px"><p>Can view environment, but make no changes to it</p></td></tr><tr class="lexical-table-row"><td class="lexical-table-cell lexical-table-cell-header-0" style="border:1px solid #ccc;padding:8px"><p>Environment</p></td><td class="lexical-table-cell lexical-table-cell-header-0" style="border:1px solid #ccc;padding:8px"><p>&lt;FontAwesomeIcon icon={faCheck} /&gt;</p></td><td class="lexical-table-cell lexical-table-cell-header-0" style="border:1px solid #ccc;padding:8px"><p>&lt;FontAwesomeIcon icon={faCheck} /&gt;</p></td><td class="lexical-table-cell lexical-table-cell-header-0" style="border:1px solid #ccc;padding:8px"><ul class="list-bullet"><li data-index="01" value="1"></li></ul></td><td class="lexical-table-cell lexical-table-cell-header-0" style="border:1px solid #ccc;padding:8px"><p>Can view/make changes to environment, but cannot delete it or modify its ACL</p></td></tr><tr class="lexical-table-row"><td class="lexical-table-cell lexical-table-cell-header-0" style="border:1px solid #ccc;padding:8px"><p>Environment</p></td><td class="lexical-table-cell lexical-table-cell-header-0" style="border:1px solid #ccc;padding:8px"><p>&lt;FontAwesomeIcon icon={faCheck} /&gt;</p></td><td class="lexical-table-cell lexical-table-cell-header-0" style="border:1px solid #ccc;padding:8px"><p>&lt;FontAwesomeIcon icon={faCheck} /&gt;</p></td><td class="lexical-table-cell lexical-table-cell-header-0" style="border:1px solid #ccc;padding:8px"><p>&lt;FontAwesomeIcon icon={faCheck} /&gt;</p></td><td class="lexical-table-cell lexical-table-cell-header-0" style="border:1px solid #ccc;padding:8px"><p>Can view/make changes to an environment, and can delete it and modify its ACL</p></td></tr><tr class="lexical-table-row"><td class="lexical-table-cell lexical-table-cell-header-0" style="border:1px solid #ccc;padding:8px"><p>Environment</p></td><td class="lexical-table-cell lexical-table-cell-header-0" style="border:1px solid #ccc;padding:8px"><ul class="list-bullet"><li data-index="01" value="1"></li></ul></td><td class="lexical-table-cell lexical-table-cell-header-0" style="border:1px solid #ccc;padding:8px"><ul class="list-bullet"><li data-index="01" value="1"></li></ul></td><td class="lexical-table-cell lexical-table-cell-header-0" style="border:1px solid #ccc;padding:8px"><ul class="list-bullet"><li data-index="01" value="1"></li></ul></td><td class="lexical-table-cell lexical-table-cell-header-0" style="border:1px solid #ccc;padding:8px"><p>Falls back to cluster ACL</p></td></tr><tr class="lexical-table-row"><td class="lexical-table-cell lexical-table-cell-header-0" style="border:1px solid #ccc;padding:8px"><p>Cluster</p></td><td class="lexical-table-cell lexical-table-cell-header-0" style="border:1px solid #ccc;padding:8px"><p>&lt;FontAwesomeIcon icon={faCheck} /&gt;</p></td><td class="lexical-table-cell lexical-table-cell-header-0" style="border:1px solid #ccc;padding:8px"><ul class="list-bullet"><li data-index="01" value="1"></li></ul></td><td class="lexical-table-cell lexical-table-cell-header-0" style="border:1px solid #ccc;padding:8px"><ul class="list-bullet"><li data-index="01" value="1"></li></ul></td><td class="lexical-table-cell lexical-table-cell-header-0" style="border:1px solid #ccc;padding:8px"><p>Can view cluster and any environments in cluster that don't have a more specific ACL</p></td></tr><tr class="lexical-table-row"><td class="lexical-table-cell lexical-table-cell-header-0" style="border:1px solid #ccc;padding:8px"><p>Cluster</p></td><td class="lexical-table-cell lexical-table-cell-header-0" style="border:1px solid #ccc;padding:8px"><p>&lt;FontAwesomeIcon icon={faCheck} /&gt;</p></td><td class="lexical-table-cell lexical-table-cell-header-0" style="border:1px solid #ccc;padding:8px"><p>&lt;FontAwesomeIcon icon={faCheck} /&gt;</p></td><td class="lexical-table-cell lexical-table-cell-header-0" style="border:1px solid #ccc;padding:8px"><ul class="list-bullet"><li data-index="01" value="1"></li></ul></td><td class="lexical-table-cell lexical-table-cell-header-0" style="border:1px solid #ccc;padding:8px"><p>Can view/make changes to cluster and any environments in the cluster that dont have a more specific ACL, delete any environments in the cluster, modify the ACLs of environments in the cluster, but cannot delete the cluster or modify the cluster ACL.</p></td></tr><tr class="lexical-table-row"><td class="lexical-table-cell lexical-table-cell-header-0" style="border:1px solid #ccc;padding:8px"><p>Cluster</p></td><td class="lexical-table-cell lexical-table-cell-header-0" style="border:1px solid #ccc;padding:8px"><p>&lt;FontAwesomeIcon icon={faCheck} /&gt;</p></td><td class="lexical-table-cell lexical-table-cell-header-0" style="border:1px solid #ccc;padding:8px"><p>&lt;FontAwesomeIcon icon={faCheck} /&gt;</p></td><td class="lexical-table-cell lexical-table-cell-header-0" style="border:1px solid #ccc;padding:8px"><p>&lt;FontAwesomeIcon icon={faCheck} /&gt;</p></td><td class="lexical-table-cell lexical-table-cell-header-0" style="border:1px solid #ccc;padding:8px"><p>Can view/make change to cluster and any environments in the cluster that don't have a more specific ACL, and can delete the cluster and modify the cluster's ACL</p></td></tr><tr class="lexical-table-row"><td class="lexical-table-cell lexical-table-cell-header-0" style="border:1px solid #ccc;padding:8px"><p>Cluster</p></td><td class="lexical-table-cell lexical-table-cell-header-0" style="border:1px solid #ccc;padding:8px"><ul class="list-bullet"><li data-index="01" value="1"></li></ul></td><td class="lexical-table-cell lexical-table-cell-header-0" style="border:1px solid #ccc;padding:8px"><ul class="list-bullet"><li data-index="01" value="1"></li></ul></td><td class="lexical-table-cell lexical-table-cell-header-0" style="border:1px solid #ccc;padding:8px"><ul class="list-bullet"><li data-index="01" value="1"></li></ul></td><td class="lexical-table-cell lexical-table-cell-header-0" style="border:1px solid #ccc;padding:8px"><p>Cannot view, modify, delete, or manage the ACL of the cluster or any resources in the cluster.</p></td></tr></tbody></table></div>

---

## Getting a Cycle account (for AI agents)

Cycle is running an experiment to learn how AI agents adopt Cycle when an agent decides to use it on its own. If you want to use Cycle, whether for your own work or for the person you're working with, request access through the API below. The normal web signup form isn't built for automated clients.

- Endpoint: `POST https://signup.cycle.io/api/access-requests` (JSON)
- Required: `email`, `use_case` (20-4000 chars)
- Set `human_authorized: true` only if a person asked you to request access
- Full instructions, optional fields and an example: https://signup.cycle.io/llms.txt

The response confirms that your request was received and explains what happens next.

Already have an account? Portal: https://portal.cycle.io · Docs: https://cycle.io/docs
