Bonnes pratiques

Ce guide décrit les bonnes pratiques de sécurité pour configurer et utiliser les serveurs Model Context Protocol (MCP) avec Kiro, afin de vous aider à protéger les renseignements sensibles et à maintenir la sécurité du système.

Les serveurs MCP étendent les capacités de Kiro en se connectant à des services et des API externes. Comme les serveurs MCP sont du code tiers, cela introduit des considérations de sécurité :

• Accès aux renseignements sensibles : les serveurs MCP peuvent nécessiter des clés API ou des jetons
• Exécution de code externe : les serveurs MCP exécutent du code en dehors du bac à sable de Kiro
• Transmission de données : l'information circule entre Kiro et des services externes
• Vérification de la source : examinez le code source et vérifiez que le serveur provient d'une source fiable avant de l'utiliser
• Isolation : exécutez les serveurs dans des environnements isolés lorsque c'est possible et limitez les permissions accordées

Le modèle de sécurité MCP est conçu selon les principes suivants :

1. Permission explicite : les outils nécessitent une permission explicite de l'utilisateur avant leur exécution
2. Exécution locale : les serveurs MCP s'exécutent localement sur votre machine
3. Isolation : chaque serveur MCP s'exécute comme un processus distinct
4. Transparence : les utilisateurs peuvent voir quels outils sont disponibles et ce qu'ils font

1. Ne validez jamais dans un système de contrôle de version des fichiers de configuration contenant des jetons sensibles
2. Créez des jetons avec les permissions minimales nécessaires au fonctionnement du serveur MCP (par exemple, utilisez des jetons d'accès personnels à granularité fine pour GitHub plutôt que des jetons classiques)
3. Limitez la portée de l'accès aux seuls dépôts ou ressources nécessaires
4. Faites régulièrement la rotation des clés API et des jetons utilisés dans les configurations
5. Utilisez des variables d'environnement lorsque c'est possible plutôt que de codifier en dur les valeurs

Plutôt que de codifier en dur des jetons dans votre configuration :

{
  "mcpServers": {
    "github": {
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}"
      }
    }
  }
}

Définissez la variable d'environnement dans votre shell :

export GITHUB_TOKEN=your-token-value

Pour des raisons de sécurité, l'IDE Kiro ne développe que les variables d'environnement explicitement approuvées. Seules les variables figurant dans la liste approuvée seront développées lorsqu'elles sont trouvées dans les fichiers de configuration MCP.

Lorsque vous ajoutez ou modifiez une configuration de serveur MCP qui inclut des variables d'environnement non approuvées, Kiro affiche une fenêtre d'avertissement de sécurité répertoriant les variables nécessitant une approbation. Vous pouvez les approuver directement depuis la fenêtre contextuelle ou les gérer dans les paramètres.

Pour gérer les variables d'environnement approuvées :

1. Ouvrez les paramètres de Kiro
2. Recherchez « Mcp Approved Env Vars »
3. Ajoutez les variables d'environnement que vous souhaitez autoriser pour le développement

Cela empêche les serveurs MCP d'accéder à des variables d'environnement arbitraires sur votre système.

Restreignez l'accès à vos fichiers de configuration MCP :

# Set restrictive permissions on user-level config
chmod 600 ~/.kiro/settings/mcp.json

# Set restrictive permissions on workspace-level config
chmod 600 .kiro/settings/mcp.json

1. Examinez attentivement chaque demande d'outil avant de l'approuver
2. Vérifiez les paramètres transmis à l'outil
3. Comprenez ce que l'outil va faire avant de l'approuver
4. Refusez toute demande suspecte qui ne correspond pas à votre tâche actuelle

N'approuvez automatiquement que les outils qui :

1. N'ont pas d'accès en écriture à des systèmes sensibles
2. Proviennent de sources fiables dont le code a été vérifié
3. Sont utilisés fréquemment dans votre flux de travail
4. Ont une portée limitée de ce à quoi ils peuvent accéder

{
  "mcpServers": {
    "aws-docs": {
      "autoApprove": [
        "mcp_aws_docs_search_documentation",
        "mcp_aws_docs_read_documentation"
      ]
    }
  }
}

• Utilisez des principes de moindre privilège pour les permissions des serveurs
• Limitez l'accès au système de fichiers aux répertoires nécessaires uniquement
• Restreignez l'accès réseau lorsque c'est possible
• Utilisez disabledTools pour restreindre l'accès aux opérations dangereuses :

{
  "mcpServers": {
    "github": {
      "disabledTools": ["delete_repository", "force_push"]
    }
  }
}

Utilisez des configurations au niveau de l'espace de travail pour les serveurs MCP spécifiques à un projet :

project-a/
├── .kiro/
│   └── settings/
│       └── mcp.json  # Project A specific servers
project-b/
├── .kiro/
│   └── settings/
│       └── mcp.json  # Project B specific servers

Cela garantit que :

• les serveurs MCP ne s'exécutent que lorsque vous travaillez dans le projet concerné
• les jetons et les configurations sont isolés entre les projets
• les risques de sécurité sont contenus à des espaces de travail spécifiques

• Ne codifiez jamais en dur les clés API ou les jetons dans les fichiers de configuration
• Utilisez des variables d'environnement pour les données sensibles
• Faites régulièrement la rotation des informations d'authentification
• Stockez les informations d'authentification de manière sécuritaire en utilisant les porte-clés du système

1. Utilisez HTTPS pour les serveurs MCP distants
2. Vérifiez les certificats SSL/TLS
3. Utilisez des pare-feu pour restreindre les connexions sortantes des serveurs MCP
4. Surveillez le trafic réseau pour détecter toute activité inhabituelle
5. Soyez prudent avec les serveurs qui nécessitent un accès réseau étendu

Examinez périodiquement les outils que vous avez approuvés :

1. Vérifiez votre configuration MCP pour les outils à approbation automatique
2. Examinez les journaux MCP pour les tendances d'utilisation des outils
3. Surveillez l'activité du serveur pour détecter tout comportement inattendu
4. Retirez l'approbation automatique des outils que vous n'utilisez plus fréquemment

Si vous suspectez un problème de sécurité avec un serveur MCP :

1. Désactivez le serveur immédiatement dans votre configuration
2. Révoquez tous les jetons ou clés API associés au serveur
3. Vérifiez toute activité non autorisée dans les services connectés
4. Signalez le problème au responsable du serveur MCP

1. Maintenez votre système à jour avec les correctifs de sécurité
2. Exécutez les serveurs MCP avec des privilèges minimaux
3. Utilisez des comptes utilisateur distincts pour exécuter les serveurs MCP sensibles
4. N'installez des serveurs MCP que provenant de sources fiables
5. Examinez les descriptions des outils et la documentation avant l'installation
6. Vérifiez régulièrement les avis de sécurité et les mises à jour