CommunityProductivité et collaborationgithub.com

elastic/elasticsearch-security-troubleshooting

Diagnostiquez et résolvez les erreurs de sécurité Elasticsearch : échecs 401/403, problèmes TLS, clés API expirées, inadéquations de mappage de rôles et problèmes de connexion Kibana. Utilisez cette compétence lorsque l'utilisateur signale une erreur de sécurité.

Qu'est-ce que elasticsearch-security-troubleshooting ?

Cette compétence est conçue pour aider les développeurs et les administrateurs à diagnostiquer et résoudre rapidement les problèmes de sécurité courants liés à Elasticsearch. Elle cible spécifiquement les erreurs 401 et 403, les problèmes de certificat TLS/SSL, les clés API expirées, les configurations de mappage de rôles incorrectes, et les difficultés de connexion à Kibana. En se basant sur un ensemble de vérifications et de correctifs documentés, elle guide l'utilisateur pas à pas pour identifier la cause racine du problème. La compétence peut être invoquée automatiquement ou manuellement dès qu'un utilisateur signale une erreur de sécurité, et elle analyse les logs, les configurations et les dépendances système pour fournir des recommandations précises. Elle est compatible avec les versions récentes d'Elasticsearch et de Kibana, et son fonctionnement repose sur des commandes CLI et des requêtes API standard, sans nécessiter d'outils supplémentaires. Son objectif est de réduire le temps de résolution et d'éviter les erreurs de configuration récurrentes dans les environnements de production.

Compatible avec~Claude Code~Codex CLI~Cursor
Part ofAgent Workflows
npx skills add https://github.com/elastic/agent-skills/tree/main/skills/elasticsearch-security-troubleshooting

Installed? Explore more Productivité et collaboration skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

Voir l'original→Voir toutes les compétences

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

OpenAIChatGPTClaudeClaudeGeminiGeminiGrokGrokPerplexityPerplexityDeepSeekDeepSeek

Documentation

Que fait elasticsearch-security-troubleshooting ?

Diagnostiquez et résolvez les erreurs de sécurité Elasticsearch : échecs 401/403, problèmes TLS, clés API expirées, inadéquations de mappage de rôles et problèmes de connexion Kibana. Utilisez cette compétence lorsque l'utilisateur signale une erreur de sécurité.

Comment ça fonctionne

Cette compétence analyse en profondeur l'environnement Elasticsearch pour identifier les causes des échecs de sécurité. Elle examine les fichiers de configuration, les logs, les certificats, les clés API et les mappages de rôles. À chaque étape, elle fournit des diagnostics clairs et des commandes de correction exécutables.

Vérifications communes

  • Erreurs 401/403 : Vérifie les autorisations des utilisateurs, les rôles et les jetons d'authentification.
  • Problèmes TLS : Vérifie la validité des certificats, les chemins de configuration elasticsearch.yml et kibana.yml, ainsi que les autorisations des fichiers.
  • Clés API expirées : Liste les clés API et vérifie leur date d'expiration via l'API REST /_security/api_key.
  • Mappages de rôles : Compare les rôles attendus avec les rôles attribués aux utilisateurs, en inspectant le fichier role_mapping.yml.
  • Connexion Kibana : Vérifie l'état de la connexion entre Kibana et Elasticsearch, y compris les paramètres CORS et les endpoints.

Utilisation

Invoquez cette compétence automatiquement lorsque l'utilisateur décrit une erreur de sécurité, ou manuellement avec la commande :

/troubleshoot-security

Exemple de diagnostic

Diagnostic en cours...
Étape 1 : Vérification des certificats TLS...
[echec] Certificat expiré : /etc/elasticsearch/certs/elastic-certificate.pem
Remédiation : Générez un nouveau certificat avec 'elasticsearch-certutil' et redémarrez le service.

Notes importantes

  • Assurez-vous que l'utilisateur a les droits d'accès nécessaires (superuser ou manage_security).
  • Les modifications de configuration peuvent nécessiter un redémarrage des services Elasticsearch ou Kibana.
  • Consultez la documentation officielle d'Elasticsearch pour les versions spécifiques : Documentation Sécurité.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

elastic/cloud-access-management

Manage Elastic Cloud organization access: invite users, assign roles to Serverless projects, and create or revoke Cloud API keys. Use when granting, modifying, or auditing user access.

elastic/cloud-create-project

Creates Elastic Cloud Serverless projects (Elasticsearch, Observability, or Security) via the REST API, saves credentials to file, and bootstraps a scoped Elasticsearch API key. Use when creating a new serverless project, provisioning a search or observability environment, or spinning up a new Elastic Cloud project.

elastic/cloud-manage-project

Manages existing Elastic Cloud Serverless projects: list, get, update, delete, reset credentials, resume, and load saved credentials. Connects to existing projects by resolving endpoints and acquiring scoped Elasticsearch API keys. Use when performing day-2 operations on serverless projects, connecting to an existing project, loading or resetting project credentials, or looking up project details.

elastic/cloud-network-security

Manage Serverless network security (traffic filters): create, update, and delete IP filters and AWS PrivateLink VPC filters. Use when restricting network access or configuring private connectivity.

elastic/cloud-setup

Configures Elastic Cloud authentication and environment defaults. Use when setting up EC_API_KEY, configuring Cloud API access, or when another cloud skill requires credentials.

elastic/elasticsearch-audit

Enable, configure, and query Elasticsearch security audit logs. Use when the task involves audit logging setup, event filtering, or investigating security incidents like failed logins.

elastic/elasticsearch-authn

Authenticate to Elasticsearch using native, file-based, LDAP/AD, SAML, OIDC, Kerberos, JWT, or certificate realms. Use when connecting with credentials, choosing a realm, or managing API keys. Assumes the target realms are already configured.

elastic/elasticsearch-authz

Manage Elasticsearch RBAC: native users, roles, role mappings, document- and field-level security. Use when creating users or roles, assigning privileges, or mapping external realms like LDAP/SAML.

elastic/elasticsearch-esql

Execute ES|QL (Elasticsearch Query Language) queries, use when the user wants to query Elasticsearch data, analyze logs, aggregate metrics, explore data, or create charts and dashboards from ES|QL results.

elastic/elasticsearch-file-ingest

Ingest and transform data files (CSV/JSON/Parquet/Arrow IPC) into Elasticsearch with stream processing and custom transforms. Use when loading files or batch importing data — not for reindexing, general ingest pipeline design, or bulk API patterns.

elastic/elasticsearch-onboarding

Help developers new to Elasticsearch get from zero to a working search experience. Guide them through understanding their intent, mapping their data, and building a search experience with best practices baked in. Use this when the user shows intent to build search-related functionality, asks about Elasticsearch-related concepts for their use case, or expresses the need for help getting started with Elasticsearch.

elastic/kibana-agent-builder

Create and manage Agent Builder agents and custom tools in Kibana. Use when asked to create, update, delete, test, or inspect agents or tools in Agent Builder.

elastic/kibana-alerting-rules

Create and manage Kibana alerting rules via REST API or Terraform. Use when creating, updating, or managing rule lifecycle (enable, disable, mute, snooze) or rules-as-code workflows.

elastic/kibana-audit

Enable and configure Kibana audit logging for saved object access, logins, and space operations. Use when setting up Kibana audit, filtering events, or correlating Kibana and ES audit logs.

elastic/kibana-connectors

Create and manage Kibana connectors for Slack, PagerDuty, Jira, webhooks, and more via REST API or Terraform. Use when configuring third-party integrations or managing connectors as code.

elastic/kibana-dashboards

Create and manage Kibana Dashboards and visualizations. Use when you need to define dashboards and visualizations declaratively, version control them, or automate their deployment.

elastic/kibana-streams

List, inspect, enable, disable, and resync Kibana Streams via the REST API. Use when the user needs stream details, ingest/query settings, queries, significant events, or attachments.

elastic/kibana-vega

Create Vega and Vega-Lite visualizations with ES|QL data sources in Kibana. Use when building custom charts, dashboards, or programmatic panel layouts beyond standard Lens charts.

elastic/observability-edot-dotnet-instrument

Instrument a .NET application with the Elastic Distribution of OpenTelemetry (EDOT) .NET SDK for automatic tracing, metrics, and logs. Use when adding observability to a .NET service that has no existing APM agent.

elastic/observability-edot-dotnet-migrate

Migrate a .NET application from the classic Elastic APM .NET agent to the EDOT .NET SDK. Use when switching from Elastic.Apm.* packages to Elastic.OpenTelemetry.

Skills associés

steipete/gemini

Gemini CLI one-shot prompts, summaries, generation, skills, hooks, MCP, or Gemma routing.

community

steipete/gh-issues

Fetch GitHub issues, select candidates, spawn background fix agents, open PRs, and optionally process PR review comments.

community

steipete/skill-creator

Create, edit, audit, tidy, validate, or restructure AgentSkills and SKILL.md files.

community

steipete/clawhub

Search, install, update, sync, or publish agent skills with the ClawHub CLI and registry.

community

steipete/coding-agent

Delegate coding work to Codex, Claude Code, or OpenCode as background workers; not simple edits or read-only code lookup.

community

steipete/mcporter

List, configure, authenticate, call, and inspect MCP servers/tools with mcporter over HTTP or stdio.

community
← More Productivité et collaboration skills