# AI Governance

To manage AI deployments effectively, StackAI offers governance features like:

* Role-Based Access Control (RBAC): Define user permissions at granular levels, including access to the knowledge base and connections.
* Single Sign-On (SSO): Integrate with identity providers like Okta and Entra ID for user authentication and inheritance of groups and permissions.
* Project Publishing Controls: Restrict project publishing capabilities to authorized personnel, ensuring oversight.
* Centralized Monitoring: A unified dashboard allows administrators to monitor agent activities, usage metrics, and error logs in real-time.

Below is a comprehensive guide to StackAI’s governance model, designed for teams that need **speed without losing control**.

## The StackAI Governance Model (8 Layers) <a href="#header-1" id="header-1"></a>

**1) Role-Based Access Control (RBAC) and Groups**

<figure><img src="https://3697023207-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFSlso1Kjob5CLDrh0dVn%2Fuploads%2FmwxPZDkpypy0SrdTq6PQ%2Fgroups.avif?alt=media&#x26;token=2a41af7b-794f-46c7-8aba-58340f861172" alt=""><figcaption></figcaption></figure>

Admins can create **groups** (e.g., “Legal,” “HR,” “Capture Team”) and assign them to workspaces/projects for coarse-grained control.

**2) Workspace and Folder Access (Scope Control)**

Easily create private group folders with specific allowlists. Only assigned users or groups can see what’s inside—others see nothing.

<figure><img src="https://3697023207-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFSlso1Kjob5CLDrh0dVn%2Fuploads%2FnGA7TAKLxctg5fjewYoy%2Fkb_group_access.gif?alt=media&#x26;token=48104660-fc3b-43a9-b467-a04a2e456f58" alt=""><figcaption></figcaption></figure>

Easily view project owners and editors as well, by hovering over a project or in a list view.

<figure><img src="https://3697023207-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFSlso1Kjob5CLDrh0dVn%2Fuploads%2FejnRYcjj81OnGoWV55lh%2Fcreatedby.png?alt=media&#x26;token=1166bf69-9769-4ac2-b093-77d16e8d2e36" alt=""><figcaption></figcaption></figure>

**3) Project Controls (Edit, Lock, Versioning)**

Creators can **lock** a project (only the owner edits; admins can override).

<figure><img src="https://3697023207-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFSlso1Kjob5CLDrh0dVn%2Fuploads%2FqAkFXZOkzQzCrwa7R5DS%2Flock_projects.avif?alt=media&#x26;token=39abc26c-a635-49c1-a8cd-bae6a6aa0d94" alt=""><figcaption></figcaption></figure>

All changes made to projects can be tracked with **version control** and diffs, so you can see exactly who changed what and when, and roll back. You can easily see all previously published versions of a project; and versions can be tagged with a commit message to clarify what changes were made. Easily go back to a previous version if desired.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFSlso1Kjob5CLDrh0dVn%2Fuploads%2FCnTCmhb7V8QySaZgKQwI%2FVersioning.mp4?alt=media&token=69174abb-6f99-4037-b08c-21568fc3ab0e>" %}

**4) Interface-Level Security (How You Publish)**

When you export an agent (advanced form, chatbot, Slackbot, etc.), you can:

* Enable one-click SSO on the interface editor
* Set a **password** for external collaborators.
* Restrict by **allowed origins/URLs** and even a **user allowlist**.

<figure><img src="https://3697023207-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFSlso1Kjob5CLDrh0dVn%2Fuploads%2FbRVdu5mFNy9wc2B5gwhV%2Fsso_protect_singleproject.png?alt=media&#x26;token=4e935174-3f7f-4bf7-a31d-b008f9c35541" alt=""><figcaption></figcaption></figure>

**5) Global Governance and Admin Policy (Feature Access and Guardrails)**

Org admins can set cross-cutting policy:

* Require SSO on all interfaces.
* Restrict who can **publish**, so that non-admins don't publish projects.

<figure><img src="https://3697023207-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFSlso1Kjob5CLDrh0dVn%2Fuploads%2FI3jCRJ3KYmsCeR3pCzHZ%2Fadmin_view.gif?alt=media&#x26;token=b0867277-2c04-481e-9b29-a2e5e7550fa2" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3697023207-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFSlso1Kjob5CLDrh0dVn%2Fuploads%2FNxvtHKzFYXyGmZZBM9dj%2Fpublish_project_FF.png?alt=media&#x26;token=73f9ef14-eb47-455c-a91a-8b70f6418e11" alt=""><figcaption></figcaption></figure>

* Enable an **approval/feature-flag** workflow for changes, wherein users request for their project to be reviewed and published by admin.

<figure><img src="https://3697023207-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFSlso1Kjob5CLDrh0dVn%2Fuploads%2FlulLd3bLN6eucsVKtfDy%2Fpull_request.png?alt=media&#x26;token=5218bc50-6985-418a-97ea-39d7963199b1" alt=""><figcaption></figcaption></figure>

* Allow/deny specific **tools, connectors, and more through Feature Access** (e.g., block Notion/Box across the org).

<figure><img src="https://3697023207-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFSlso1Kjob5CLDrh0dVn%2Fuploads%2F1J6mgiB2cg8r2kLxrUfT%2Ffeature_flags.gif?alt=media&#x26;token=7e71311c-3377-4171-a19f-c9f2ac3fbd4b" alt=""><figcaption></figcaption></figure>

* Set **usage limits** (e.g., token caps) as a security throttle.
* Assigning user roles.

![](https://3697023207-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFSlso1Kjob5CLDrh0dVn%2Fuploads%2FkrfUNqFBfzteB3I2U1eS%2F14.png?alt=media)

* Disabling LLMs and adding default connections (i.e., your company’s API keys).

![](https://3697023207-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFSlso1Kjob5CLDrh0dVn%2Fuploads%2FYTmqJmwVuy6bjRhf8s5T%2F15.png?alt=media)

You can also build **policy by group** (e.g., “only Legal can access the Legal agents”).

**6) Connection and Knowledge-Base Permissions**

Connections (SharePoint, Dropbox, ServiceNow, etc.) are owned by their creator, with private details and credentials encrypted and hidden from others. Owners and admins can share a connection org-wide or limit it to specific users or groups.

Knowledge bases support the same allowlisting, so only authorized teams can reference sensitive content.

<figure><img src="https://3697023207-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFSlso1Kjob5CLDrh0dVn%2Fuploads%2FCZ8QMyzcQjMKYnNuK6Vc%2Fkb_group_access.gif?alt=media&#x26;token=859c0b46-3bd8-4cf3-9540-68ce3747cb44" alt=""><figcaption></figcaption></figure>

**7) Production Analytics and Auditing**

Downloadable project analytics show **who ran what, when, with which models**, token counts, latency, and per-step traces (inputs, KB hits, outputs). Builders can **mask or disable logs** when required, or limit visibility to the owner. For certain cases of **external security tooling**, StackAI can deliver **scheduled exports** and can **post to a customer webhook** (e.g., daily digests) for alerting pipelines.

Below are some of the most widely used governance features, developed in close collaboration with our customers:

<figure><img src="https://3697023207-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFSlso1Kjob5CLDrh0dVn%2Fuploads%2FLKvni93N0hVNyL51rFtb%2Fanalytics_tab.avif?alt=media&#x26;token=19cdf520-ffc7-456d-a20d-7be1c53f6c3e" alt=""><figcaption></figcaption></figure>

Learn more about Analytics [here](https://docs.stackai.com/agentic-adoption-and-security/observability/analytics).

**8) Authentication and MFA**

Organizations can use **email/password** (when enabled) or **SSO** (recommended). Enabling SSO means protecting **any or all** interfaces from access by members outside of your organization; further, SSO allows you to capture the email addresses of all users of your interfaces to easily keep track of who is using your workflows. You can also require SSO for all interfaces. By default, SSO users land as **users** until granted higher roles.

<figure><img src="https://3697023207-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFSlso1Kjob5CLDrh0dVn%2Fuploads%2F13q1l18prUicKSOgDpeq%2Frequire_SSO_forall.png?alt=media&#x26;token=82e5820d-e0f1-4600-a00a-b90e5b36437e" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3697023207-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFSlso1Kjob5CLDrh0dVn%2Fuploads%2FPQhH6uPg5KkVho7n8QMI%2Fturn_on_MFA.gif?alt=media&#x26;token=5ad55ddc-db88-4de8-96fa-a52a3e57e00b" alt=""><figcaption></figcaption></figure>
