README.md

Security Best Practices

Tietoturva on ratkaisevan tärkeää MCP-ratkaisuissa, erityisesti yritysympäristöissä. On tärkeää varmistaa, että työkalut ja data ovat suojattuja luvattomalta pääsyltä, tietomurroilta ja muilta tietoturvauhilta.

Introduction

Tässä oppitunnissa käsittelemme MCP-ratkaisujen tietoturvan parhaita käytäntöjä. Käymme läpi tunnistautumisen ja valtuutuksen, datan suojauksen, työkalujen turvallisen suorittamisen sekä tietosuoja-asetusten noudattamisen.

Learning Objectives

Oppitunnin lopuksi osaat:

• Toteuttaa turvalliset tunnistautumis- ja valtuutusmekanismit MCP-palvelimille.
• Suojata arkaluonteiset tiedot salauksella ja turvallisella tallennuksella.
• Varmistaa työkalujen turvallisen suorittamisen asianmukaisilla käyttöoikeuksilla.
• Soveltaa parhaita käytäntöjä tietosuojaan ja yksityisyyden suojaan.

Authentication and Authorization

Tunnistautuminen ja valtuutus ovat olennaisia MCP-palvelimien suojaamiseksi. Tunnistautuminen vastaa kysymykseen "Kuka olet?" ja valtuutus kysymykseen "Mitä voit tehdä?".

Tarkastellaan esimerkkejä siitä, miten toteuttaa turvallinen tunnistautuminen ja valtuutus MCP-palvelimilla .NET- ja Java-ympäristöissä.

.NET Identity Integration

ASP .NET Core Identity tarjoaa vankan kehyksen käyttäjien tunnistautumisen ja valtuutuksen hallintaan. Voimme integroida sen MCP-palvelimiin työkalujen ja resurssien suojaamiseksi.

Kun integroimme ASP.NET Core Identityä MCP-palvelimiin, on hyvä ymmärtää seuraavat keskeiset käsitteet:

• Identity Configuration: ASP.NET Core Identityn määrittäminen käyttäjärooleineen ja -väittäminensä. Väittämä on tieto käyttäjästä, kuten hänen roolinsa tai käyttöoikeutensa, esimerkiksi "Admin" tai "User".
• JWT Authentication: JSON Web Tokenien (JWT) käyttö turvalliseen API-pääsyyn. JWT on standardi, jolla välitetään tietoa osapuolten välillä JSON-objektina, ja se voidaan varmentaa digitaalisen allekirjoituksen avulla.
• Authorization Policies: Politiikkojen määrittely, joilla ohjataan pääsyä tiettyihin työkaluihin käyttäjäroolien perusteella. MCP käyttää valtuutuspolitiikkoja määrittämään, ketkä käyttäjät pääsevät mihinkin työkaluihin rooliensa ja väittämiensä perusteella.

public class SecureMcpStartup
{
    public void ConfigureServices(IServiceCollection services)
    {
        // Add ASP.NET Core Identity
        services.AddIdentity<ApplicationUser, IdentityRole>()
            .AddEntityFrameworkStores<ApplicationDbContext>()
            .AddDefaultTokenProviders();
        
        // Configure JWT authentication
        services.AddAuthentication(options =>
        {
            options.DefaultAuthenticateScheme = JwtBearerDefaults.AuthenticationScheme;
            options.DefaultChallengeScheme = JwtBearerDefaults.AuthenticationScheme;
        })
        .AddJwtBearer(options =>
        {
            options.TokenValidationParameters = new TokenValidationParameters
            {
                ValidateIssuer = true,
                ValidateAudience = true,
                ValidateLifetime = true,
                ValidateIssuerSigningKey = true,
                ValidIssuer = Configuration["Jwt:Issuer"],
                ValidAudience = Configuration["Jwt:Audience"],
                IssuerSigningKey = new SymmetricSecurityKey(
                    Encoding.UTF8.GetBytes(Configuration["Jwt:Key"]))
            };
        });
        
        // Add authorization policies
        services.AddAuthorization(options =>
        {
            options.AddPolicy("CanUseAdminTools", policy =>
                policy.RequireRole("Admin"));
                
            options.AddPolicy("CanUseBasicTools", policy =>
                policy.RequireAuthenticatedUser());
        });
        
        // Configure MCP server with security
        services.AddMcpServer(options =>
        {
            options.ServerName = "Secure MCP Server";
            options.ServerVersion = "1.0.0";
            options.RequireAuthentication = true;
        });
        
        // Register tools with authorization requirements
        services.AddMcpTool<BasicTool>(options => 
            options.RequirePolicy("CanUseBasicTools"));
            
        services.AddMcpTool<AdminTool>(options => 
            options.RequirePolicy("CanUseAdminTools"));
    }
    
    public void Configure(IApplicationBuilder app)
    {
        // Use authentication and authorization
        app.UseAuthentication();
        app.UseAuthorization();
        
        // Use MCP server middleware
        app.UseMcpServer();
    }
}

Edellisessä koodissa olemme:

• Määrittäneet ASP.NET Core Identityn käyttäjien hallintaan.
• Ottaneet käyttöön JWT-tunnistautumisen turvallista API-pääsyä varten. Määrittelimme tokenin vahvistusparametrit, kuten julkaisijan, vastaanottajan ja allekirjoitusavaimen.
• Määrittäneet valtuutuspolitiikat työkalujen käyttöoikeuksien hallintaan käyttäjäroolien perusteella. Esimerkiksi "CanUseAdminTools" -politiikka vaatii käyttäjältä "Admin"-roolin, kun taas "CanUseBasic" edellyttää käyttäjän olevan tunnistautunut.
• Rekisteröineet MCP-työkalut tietyillä valtuutusvaatimuksilla varmistaaksemme, että vain oikeilla rooleilla varustetut käyttäjät pääsevät niihin käsiksi.

Java Spring Security Integration

Java-ympäristössä käytämme Spring Securityä toteuttamaan turvallisen tunnistautumisen ja valtuutuksen MCP-palvelimille. Spring Security tarjoaa kattavan tietoturvakehyksen, joka integroituu saumattomasti Spring-sovelluksiin.

Keskeiset käsitteet tässä ovat:

• Spring Security Configuration: Turvallisuusasetusten määrittäminen tunnistautumista ja valtuutusta varten.
• OAuth2 Resource Server: OAuth2:n käyttö turvalliseen pääsyyn MCP-työkaluihin. OAuth2 on valtuutuskehys, joka mahdollistaa kolmansien osapuolien vaihtavan käyttöoikeustunnuksia turvallista API-pääsyä varten.
• Security Interceptors: Turvainterseptorien toteutus, joilla valvotaan pääsyä työkalujen suorittamiseen.
• Role-Based Access Control: Roolipohjainen pääsynhallinta, jolla rajoitetaan pääsyä tiettyihin työkaluihin ja resursseihin.
• Security Annotations: Annotaatiot, joilla turvataan metodit ja päätepisteet.

@Configuration
@EnableWebSecurity
public class SecurityConfig extends WebSecurityConfigurerAdapter {

    @Override
    protected void configure(HttpSecurity http) throws Exception {
        http
            .csrf().disable()
            .authorizeRequests()
                .antMatchers("/mcp/discovery").permitAll() // Allow tool discovery
                .antMatchers("/mcp/tools/**").hasAnyRole("USER", "ADMIN") // Require authentication for tools
                .antMatchers("/mcp/admin/**").hasRole("ADMIN") // Admin-only endpoints
                .anyRequest().authenticated()
            .and()
            .oauth2ResourceServer().jwt();
    }
    
    @Bean
    public McpSecurityInterceptor mcpSecurityInterceptor() {
        return new McpSecurityInterceptor();
    }
}

// MCP Security Interceptor for tool authorization
public class McpSecurityInterceptor implements ToolExecutionInterceptor {
    @Autowired
    private JwtDecoder jwtDecoder;
    
    @Override
    public void beforeToolExecution(ToolRequest request, Authentication authentication) {
        String toolName = request.getToolName();
        
        // Check if user has permissions for this tool
        if (toolName.startsWith("admin") && !authentication.getAuthorities().contains("ROLE_ADMIN")) {
            throw new AccessDeniedException("You don't have permission to use this tool");
        }
        
        // Additional security checks based on tool or parameters
        if ("sensitiveDataAccess".equals(toolName)) {
            validateDataAccessPermissions(request, authentication);
        }
    }
    
    private void validateDataAccessPermissions(ToolRequest request, Authentication auth) {
        // Implementation to check fine-grained data access permissions
    }
}

Edellisessä koodissa olemme:

• Määrittäneet Spring Securityn suojaamaan MCP-päätepisteitä siten, että työkalujen löytäminen on julkista, mutta työkalujen suorittaminen vaatii tunnistautumisen.
• Käyttäneet OAuth2:ta resurssipalvelimena MCP-työkalujen turvalliseen käyttöön.
• Toteuttaneet turvainterseptorin, joka valvoo pääsyä työkalujen suorittamiseen tarkistamalla käyttäjäroolit ja -oikeudet ennen pääsyn myöntämistä.
• Määrittäneet roolipohjaisen pääsynhallinnan rajoittamaan pääsyä ylläpitäjätyökaluihin ja arkaluonteisiin tietoihin käyttäjäroolien perusteella.

Data Protection and Privacy

Datan suojaus on tärkeää, jotta arkaluonteiset tiedot käsitellään turvallisesti. Tämä koskee henkilökohtaisesti tunnistettavia tietoja (PII), taloustietoja ja muita arkaluonteisia tietoja, jotka on suojattava luvattomalta pääsyltä ja tietomurroilta.

Python Data Protection Example

Tarkastellaan esimerkkiä datan suojauksesta Pythonilla käyttäen salausta ja PII-tunnistusta.

from mcp_server import McpServer
from mcp_tools import Tool, ToolRequest, ToolResponse
from cryptography.fernet import Fernet
import os
import json
from functools import wraps

# PII Detector - identifies and protects sensitive information
class PiiDetector:
    def __init__(self):
        # Load patterns for different types of PII
        with open("pii_patterns.json", "r") as f:
            self.patterns = json.load(f)
    
    def scan_text(self, text):
        """Scans text for PII and returns detected PII types"""
        detected_pii = []
        # Implementation to detect PII using regex or ML models
        return detected_pii
    
    def scan_parameters(self, parameters):
        """Scans request parameters for PII"""
        detected_pii = []
        for key, value in parameters.items():
            if isinstance(value, str):
                pii_in_value = self.scan_text(value)
                if pii_in_value:
                    detected_pii.append((key, pii_in_value))
        return detected_pii

# Encryption Service for protecting sensitive data
class EncryptionService:
    def __init__(self, key_path=None):
        if key_path and os.path.exists(key_path):
            with open(key_path, "rb") as key_file:
                self.key = key_file.read()
        else:
            self.key = Fernet.generate_key()
            if key_path:
                with open(key_path, "wb") as key_file:
                    key_file.write(self.key)
        
        self.cipher = Fernet(self.key)
    
    def encrypt(self, data):
        """Encrypt data"""
        if isinstance(data, str):
            return self.cipher.encrypt(data.encode()).decode()
        else:
            return self.cipher.encrypt(json.dumps(data).encode()).decode()
    
    def decrypt(self, encrypted_data):
        """Decrypt data"""
        if encrypted_data is None:
            return None
        
        decrypted = self.cipher.decrypt(encrypted_data.encode())
        try:
            return json.loads(decrypted)
        except:
            return decrypted.decode()

# Security decorator for tools
def secure_tool(requires_encryption=False, log_access=True):
    def decorator(cls):
        original_execute = cls.execute_async if hasattr(cls, 'execute_async') else cls.execute
        
        @wraps(original_execute)
        async def secure_execute(self, request):
            # Check for PII in request
            pii_detector = PiiDetector()
            pii_found = pii_detector.scan_parameters(request.parameters)
            
            # Log access if required
            if log_access:
                tool_name = self.get_name()
                user_id = request.context.get("user_id", "anonymous")
                log_entry = {
                    "timestamp": datetime.now().isoformat(),
                    "tool": tool_name,
                    "user": user_id,
                    "contains_pii": bool(pii_found),
                    "parameters": {k: "***" for k in request.parameters.keys()}  # Don't log actual values
                }
                logging.info(f"Tool access: {json.dumps(log_entry)}")
            
            # Handle detected PII
            if pii_found:
                # Either encrypt sensitive data or reject the request
                if requires_encryption:
                    encryption_service = EncryptionService("keys/tool_key.key")
                    for param_name, pii_types in pii_found:
                        # Encrypt the sensitive parameter
                        request.parameters[param_name] = encryption_service.encrypt(
                            request.parameters[param_name]
                        )
                else:
                    # If encryption not available but PII found, you might reject the request
                    raise ToolExecutionException(
                        "Request contains sensitive data that cannot be processed securely"
                    )
            
            # Execute the original method
            return await original_execute(self, request)
        
        # Replace the execute method
        if hasattr(cls, 'execute_async'):
            cls.execute_async = secure_execute
        else:
            cls.execute = secure_execute
        return cls
    
    return decorator

# Example of a secure tool with the decorator
@secure_tool(requires_encryption=True, log_access=True)
class SecureCustomerDataTool(Tool):
    def get_name(self):
        return "customerData"
    
    def get_description(self):
        return "Accesses customer data securely"
    
    def get_schema(self):
        # Schema definition
        return {}
    
    async def execute_async(self, request):
        # Implementation would access customer data securely
        # Since we used the decorator, PII is already detected and encrypted
        return ToolResponse(result={"status": "success"})

Edellisessä koodissa olemme:

• Toteuttaneet PiiDetector class to scan text and parameters for personally identifiable information (PII).
• Created an EncryptionService class to handle encryption and decryption of sensitive data using the cryptography library.
• Defined a secure_tool decorator that wraps tool execution to check for PII, log access, and encrypt sensitive data if required.
• Applied the secure_tool decorator to a sample tool (SecureCustomerDataTool varmistaaksemme, että arkaluonteiset tiedot käsitellään turvallisesti.

What's next

• 5.9 Web search

Vastuuvapauslauseke:
Tämä asiakirja on käännetty käyttämällä tekoälypohjaista käännöspalvelua Co-op Translator. Vaikka pyrimme tarkkuuteen, huomioithan, että automaattikäännöksissä saattaa esiintyä virheitä tai epätarkkuuksia. Alkuperäistä asiakirjaa sen alkuperäiskielellä tulee pitää ensisijaisena ja luotettavana lähteenä. Tärkeiden tietojen osalta suositellaan ammattimaista ihmiskäännöstä. Emme ole vastuussa tämän käännöksen käytöstä mahdollisesti aiheutuvista väärinymmärryksistä tai tulkinnoista.