> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cedarai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Bindings

> Grant access by linking a user group to a role and a scope.

<Info>
  A **binding** is the access grant. It connects three things: **who** (user group), **what** (role), and **where** (scope).
</Info>

## The binding formula

<CardGroup cols={3}>
  <Card title="User Group" icon="users">
    **Who** gets access
  </Card>

  <Card title="Role" icon="key">
    **What** they can do
  </Card>

  <Card title="Scope" icon="map-pin">
    **Where** it applies
  </Card>
</CardGroup>

```
Binding = User Group + Role + Scope
```

<Tip>
  Think of it as: "The **Operations Team** can perform **Operator actions** on **Carrier TRLDBLKDRY**"
</Tip>

## View existing bindings

Use the list to search by group, role, or resource. This is helpful for audits or troubleshooting access issues.

<Frame caption="Bindings list showing groups, roles, and resources">
  <img src="https://mintcdn.com/cedaraiinc/3XL8_nY45kQdoBAs/images/admin/bindings-list.png?fit=max&auto=format&n=3XL8_nY45kQdoBAs&q=85&s=226a529849a7a9ed5277dd133d578a06" alt="Bindings list showing groups, roles, and resources" width="1440" height="900" data-path="images/admin/bindings-list.png" />
</Frame>

## Create a new binding

<Steps>
  <Step title="Click Add Binding" icon="plus">
    From the Bindings page or Dashboard, click **Add Binding**.
  </Step>

  <Step title="Select the user group" icon="users">
    Choose which group should receive access. If you haven't created the group yet, do that first.
  </Step>

  <Step title="Select the role" icon="key">
    Choose what the group can do. Pick a built-in role or a custom role you've created.
  </Step>

  <Step title="Select the scope" icon="map-pin">
    Choose where the access applies:

    * **Carrier** — access to the entire carrier
    * **Customer** — access limited to a specific customer
    * **Organization** — access across multiple carriers

    <Warning>
      Carrier-level scope grants broader access. Only use it when the group truly needs access to everything.
    </Warning>
  </Step>

  <Step title="Save" icon="check">
    Review your selections and save. The binding takes effect immediately.
  </Step>
</Steps>

<Frame caption="Create New Binding dialog">
  <img src="https://mintcdn.com/cedaraiinc/3XL8_nY45kQdoBAs/images/admin/create-binding-dialog.png?fit=max&auto=format&n=3XL8_nY45kQdoBAs&q=85&s=6ae2d080c30d7bb005447c0318e7e0fa" alt="Create New Binding dialog with group, role, and resource fields" width="1440" height="900" data-path="images/admin/create-binding-dialog.png" />
</Frame>

### Dialog fields explained

| Field                       | Description                              |
| --------------------------- | ---------------------------------------- |
| **Group**                   | The user group that will receive access  |
| **Role**                    | The set of permissions to grant          |
| **Primary Resource Type**   | Usually "Carrier" — the main scope level |
| **Primary Resource**        | The specific carrier (e.g., TRLDBLKDRY)  |
| **Secondary Resource Type** | Optional narrower scope (e.g., Customer) |

## Binding details

<Frame caption="Binding detail view">
  <img src="https://mintcdn.com/cedaraiinc/3XL8_nY45kQdoBAs/images/admin/bindings-detail.png?fit=max&auto=format&n=3XL8_nY45kQdoBAs&q=85&s=af9745016deb383404f3a29f490fd172" alt="Binding details panel" width="1440" height="900" data-path="images/admin/bindings-detail.png" />
</Frame>

## Common mistakes

<AccordionGroup>
  <Accordion title="Wrong scope" icon="triangle-exclamation" defaultOpen>
    Picking **Carrier** scope when you meant **Customer** scope grants much broader access than intended. Always double-check the scope before saving.

    | Scope        | Access level                     |
    | ------------ | -------------------------------- |
    | Customer     | Limited to one customer's data   |
    | Carrier      | All data for the carrier         |
    | Organization | All carriers in the organization |
  </Accordion>

  <Accordion title="Wrong role" icon="key">
    Linking a group to the wrong role (e.g., Admin instead of Operator) can grant too much access. Review role permissions before creating bindings.
  </Accordion>

  <Accordion title="Duplicate bindings" icon="clone">
    Creating multiple bindings with the same group/role but different scopes is sometimes intentional, but can also be confusing. Document why you need multiple bindings.
  </Accordion>
</AccordionGroup>

<Note>
  Changes to bindings take effect immediately. There's no undo button, so review carefully before saving.
</Note>

## Best practices

<Tabs>
  <Tab title="Least privilege" icon="shield">
    Grant the minimum access needed. It's easier to add permissions later than to clean up over-provisioned access.
  </Tab>

  <Tab title="Use groups" icon="users">
    Never create bindings directly to users. Always use groups, even for single users.
  </Tab>

  <Tab title="Document intent" icon="file-lines">
    When creating bindings, make sure the group name and role name clearly indicate the purpose.
  </Tab>
</Tabs>

## Related: Admin Portal

<CardGroup cols={2}>
  <Card title="User Groups" href="/user-docs/admin/user-groups" icon="users">
    Create groups before binding
  </Card>

  <Card title="Roles" href="/user-docs/admin/roles" icon="key">
    Understand what roles include
  </Card>

  <Card title="Activity Log" href="/user-docs/admin/activity-log" icon="clock-rotate-left">
    Review binding changes
  </Card>

  <Card title="Glossary" href="/user-docs/admin/glossary" icon="book">
    Quick term reference
  </Card>
</CardGroup>

## Related: IAM Concepts

<CardGroup cols={2}>
  <Card title="IAM Concepts" href="/user-docs/iam/concepts" icon="list-tree">
    Deep dive into identities, resources, and permissions
  </Card>

  <Card title="Policies & Roles" href="/user-docs/iam/policies-and-roles" icon="scroll">
    How bindings create policies
  </Card>

  <Card title="Resource Hierarchy" href="/user-docs/iam/overview#resource-examples-and-hierarchy" icon="sitemap">
    Understanding scope inheritance
  </Card>

  <Card title="Customer Portal" href="/user-docs/iam/customer-portal" icon="building-user">
    Granting customer access with bindings
  </Card>
</CardGroup>
