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

# Enable Security • AI Agents Framework

> enable_security: Enable all security features in one call.

# enable\_security

Function

> This function is defined in the [**security**](https://praison.ai/docs/sdk/reference/praisonai/modules/security.md) module.

Enable all security features in one call.

Activates both injection defense and audit logging globally.

.. warning::
These hooks register on the **process-global** `praisonaiagents.hooks`
registry and apply to every Agent in the process. This one-liner is not
tenant-scoped: in a multi-tenant host (e.g. `praisonai serve`) one
tenant's `extra_patterns` would apply to all tenants. Keep the returned
hook IDs and remove them via `praisonaiagents.hooks.remove_hook` to
disable per feature.

## Signature

```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
def enable_security(log_path: Optional[str], include_output: bool, extra_patterns: Optional[List[str]]) -> dict
```

## Parameters

**log\_path** `Optional[str]`

Audit log path (default: \~/.praisonai/audit.jsonl).

**include\_output** `bool` (default: False)

Include tool output in audit entries.

**extra\_patterns** `Optional`

Extra injection detection patterns.

### Returns

**Returns** `dict`

\{"injection": str, "audit": str}

## Usage

```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
>>> from praisonai.security import enable_security
    >>> enable_security()

    Then use Agent normally — no extra parameters needed:
    >>> from praisonaiagents import Agent
    >>> agent = Agent(instructions="You are a researcher")
    >>> agent.start("Research AI news")
```

## Uses

* `enable_injection_defense`
* `enable_audit_log`

## Source

> [card] [View on GitHub](https://github.com/MervinPraison/PraisonAI/blob/main/src/praisonai/praisonai/security/__init__.py#L172)
>
> `praisonai/security/__init__.py` at line 172


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.