# Guardrails Management

### Overview

**Guardrails Management** in Xygeni provides a centralized interface to define, configure, and enforce [**security guardrails**](/xygeni-scanner-cli/xygeni-cli-overview/guardrails.md) for projects.\
Guardrails are logic-based policies (written in the **XyFlow Guardrail DSL**) that determine how the Xygeni scanner behaves when certain conditions are met—such as failing a build when a *critical issue* or *new vulnerability* is detected. This feature ensures automated compliance enforcement and consistent security posture across projects.

### Guardrails Management Interface

To acces the **Guardrails Management tab** go to **Settings → Guardrails Management**.

The main panel lists all existing guardrails and their current status. You can create, edit, or delete guardrails directly from this page.

<figure><img src="/files/H6sLOUieMvD122IjKagt" alt=""><figcaption></figcaption></figure>

| Column                  | Description                                                                               |
| ----------------------- | ----------------------------------------------------------------------------------------- |
| **Guardrail Name**      | The unique name assigned to the guardrail definition.                                     |
| **Status**              | Indicates whether the guardrail is currently *Enabled* or *Disabled*.                     |
| **Associated Projects** | Lists the projects to which this guardrail applies. Hover or click to view the full list. |

### Creating a Guardrail

To create a new guardrail, click on the ***New Guardrail*** button at the top right of the interface. This will open a slide where you can configure a new guardrail:

<figure><img src="/files/tgEYKAPFOonCq826UnCR" alt=""><figcaption></figcaption></figure>

| Field            | Description                                                                                                                                                                                                                                       |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Name**         | Enter a unique name for your guardrail (e.g., `Block Critical Issues`).                                                                                                                                                                           |
| **Status**       | Choose between: **Enabled** — activates the guardrail immediately. **Disabled** — saves the guardrail without applying it.                                                                                                                        |
| **Apply From**   | Defines application scope: **Wildcard** — applies to all projects matching the specified wildcard. **Projects** — limits to specific projects selected manually.                                                                                  |
| **Set Wildcard** | Specify a matching pattern (e.g., `*prod*`, `*backend*`) if **Wildcard** is selected.                                                                                                                                                             |
| **Set Project**  | Specify what projects you desire to apply the guardrail to.                                                                                                                                                                                       |
| **Editor**       | Code area for defining guardrail logic using the [**XyFlow Guardrail Syntax**](/xygeni-scanner-cli/xygeni-cli-overview/guardrails.md#guardrail_convention). Syntax highlighting is supported. You may also upload a guardrail as a file directly. |

After configuring your guardrail, click on **Create** to complete the setup.

<figure><img src="/files/S8oveRkakwxbjO2HS23K" alt=""><figcaption></figcaption></figure>

### Modifying and Removing a Guardrail

From this interface you can also modify existing guardrails by selecting the <img src="/files/kPnjPsEHZvbeDBdgBEC8" alt="" data-size="line"> edit button for a specific guardrail. As well as remove a guardrail completely by selecting the <img src="/files/DsxxyfZDmT6PntJCOEzX" alt="" data-size="line"> delete button.

<figure><img src="/files/cXspBfMcHvnMkNmLH0F8" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
For more information about guardails please visit the [Guardrail Documentation](/xygeni-scanner-cli/xygeni-cli-overview/guardrails.md).
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.xygeni.io/xygeni-administration/platform-administration/guardrails-management.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.