All skills
redis avatar

/redis-security

@17faa8d official
by redisredis/agent-skills163 stars
30

Redis security guidance covering authentication (requirepass and ACL users), TLS, ACL-based least-privilege access control, restricting network exposure via bind and protected-mode, firewall rules, and disabling dangerous commands. Use when deploying Redis to production, defining ACL users for an application, configuring TLS connections, locking down a Redis instance behind a firewall, or auditing a Redis deployment for security hardening.

Use this Skill: https://skilld.dev/gh/redis/agent-skills/redis-security

This session only. Nothing lands on disk.

SKILL.md

≈115 tokens always: the name and description. ≈783 when used: this file. ≈854 more on demand in 3 files.

Redis Security

Production hardening for Redis: authentication, ACL-based access control, and network exposure. Cover all three together — any one of them on its own leaves an exploitable gap.

When to apply

  • Deploying or reviewing a Redis instance destined for production.
  • Setting up application credentials beyond a shared password.
  • Auditing a Redis deployment against a security checklist.
  • Receiving "Redis exposed to the internet" findings from a scanner.

1. Always authenticate (and use TLS)

Never run a production Redis without a password. Pair authentication with TLS so credentials and data aren't sent in clear text.

# redis.conf
requirepass your-strong-password
tls-port 6380
tls-cert-file /path/to/redis.crt
tls-key-file  /path/to/redis.key
r = redis.Redis(
    host="localhost",
    port=6380,
    password="your-strong-password",
    ssl=True,
    ssl_cert_reqs="required",
)

If you can use ACL users (next section) instead of the single requirepass, do — requirepass is effectively the legacy "default user" shortcut.

See references/auth.md.

2. ACLs for least-privilege access

The default user with a shared password is fine for development. For production, give each application a dedicated ACL user with only the commands and key patterns it actually needs.

# Cache-only reader
ACL SETUSER app_readonly on >password ~cache:* +get +mget +scan

# Writer that can't run dangerous ops
ACL SETUSER app_writer   on >password ~*        +@all -@dangerous

# Admin (use sparingly, never for application traffic)
ACL SETUSER admin        on >strong-password ~* +@all

Useful command categories:

Category What it covers
@read Read commands (GET, MGET, HGET, ...)
@write Write commands (SET, DEL, XADD, ...)
@dangerous FLUSHALL, DEBUG, KEYS, etc.
@admin Administrative commands

If app credentials leak, a tight ACL bounds the blast radius — the attacker can't FLUSHALL your DB just because they grabbed a cache reader's password.

See references/acls.md.

3. Restrict network access

The most common Redis breach is a public-internet Redis with no auth. Avoid that with three layers:

# redis.conf — bind to specific interfaces, keep protected-mode on
bind 127.0.0.1 192.168.1.100
protected-mode yes
# Firewall — allow only application subnets
iptables -A INPUT -p tcp --dport 6379 -s 192.168.1.0/24 -j ACCEPT
iptables -A INPUT -p tcp --dport 6379 -j DROP

Anti-pattern: bind 0.0.0.0 + protected-mode no — exposes Redis to the whole network without protection.

Optional but recommended: rename or disable destructive commands so a compromised client can't trash the DB:

rename-command FLUSHALL ""
rename-command DEBUG ""
rename-command CONFIG ""

See references/network.md.

References

Source: SKILL.md on GitHub

1 warning1mo3 checks · Risk SAFE
  • Gen Agent Trust Hub1mo

    This skill provides standard security hardening guidance for Redis deployments, including instructions for authentication, TLS configuration, ACL management, and network security. No malicious patterns were detected.

  • Socket1mo

    No alerts

  • Snyk1mo

    Risk: MEDIUM · 1 issue

Signed by skilld at 17faa8d. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 2 days ago.

Activeupdated 4 months ago
metadata
{
  "author": "Redis, Inc.",
  "version": "0.1.0"
}
  • redis
  • authentication
  • acl
  • tls
  • network-security
  • firewall
  • access-control
  • production
  • hardening

README badge

README badge for redis/agent-skills/redis-security

Configures Redis authentication via requirepass and ACL users, enables TLS encryption, restricts network exposure with bind and protected-mode, and disables dangerous commands. Apply this skill when deploying Redis to production, setting up per-application credentials, or auditing an instance against security hardening requirements.

Generated from the current SKILL.md.

Does this skill cover both authentication and network isolation?
Yes. The skill covers authentication (requirepass and ACL users), TLS encryption, network binding, protected-mode, firewall rules, and command disabling. All three layers are recommended together to avoid exploitable gaps.
Can I use this skill to set up ACL users for different applications?
Yes. The skill includes examples of creating dedicated ACL users with least-privilege access — e.g., read-only cache users, writers without dangerous commands, and admin users. Each user can be restricted to specific command categories and key patterns.
Does this cover TLS/SSL configuration?
Yes. The skill includes redis.conf settings for tls-port, tls-cert-file, and tls-key-file, plus a Python client example using SSL connections.
What commands can be disabled or renamed?
The skill covers disabling or renaming dangerous commands like FLUSHALL, DEBUG, KEYS, and CONFIG using the rename-command directive in redis.conf.
Is this skill for development or production only?
Primarily production. The skill notes that a single shared password with the default user is acceptable for development, but recommends ACL users and full hardening for production deployments.

Generated from the current SKILL.md. These answers refresh after source changes.