Megosztás:

Biztonság > üzembe helyezés

A DevUI mintaalkalmazásként lett kialakítva a helyi fejlesztéshez. Ez az oldal biztonsági szempontokat és ajánlott eljárásokat tartalmaz, ha a DevUI-t a localhoston kívül is el kell helyeznie.

Figyelmeztetés

A DevUI nem éles használatra készült. A "production környezet telepítéséhez" saját egyedi felületet hozhat létre az Agent Framework SDK segítségével, a megfelelő biztonsági intézkedések figyelembevételével.

Hamarosan elérhető

A C# devUI-dokumentációja hamarosan elérhető lesz. Tekintse meg később, vagy tekintse meg a Python dokumentációját fogalmi útmutatásért.

Felhasználói felületi módok

A DevUI két módot kínál a funkciókhoz való hozzáférés szabályozására:

Fejlesztői mód (alapértelmezett)

Teljes hozzáférés az összes funkcióhoz:

  • Hibakeresési panel nyomkövetési információkkal
  • Gyors újratöltés gyors fejlesztéshez (/v1/entities/{id}/reload)
  • Üzembehelyezési eszközök (/v1/deployments)
  • Bőbeszédű hibaüzenetek hibakereséshez
devui ./agents  # Developer mode is the default

Felhasználói mód

Egyszerűsített, korlátozott felület:

  • Csevegési felület és beszélgetéskezelés
  • Entitáslista és alapinformációk
  • A fejlesztői API-k le vannak tiltva (gyakori elérésű újratöltés, üzembe helyezés)
  • Általános hibaüzenetek (a naplózott kiszolgálóoldal részletei)
devui ./agents --mode user

Authentication

A Bearer-token hitelesítés engedélyezése a --auth jelzővel.

devui ./agents --auth

Ha a hitelesítés engedélyezve van:

  • Localhost esetén: A jogkivonat automatikusan létre lesz hozva és megjelenik a konzolon
  • Közvetlenül hálózatnak kitéve üzemelő példányok esetén: Környezeti változón vagy kapcsolón keresztül kell megadnia egy jogkivonatot
# Auto-generated token (localhost only)
devui ./agents --auth

# Custom token via CLI
devui ./agents --auth --auth-token "your-secure-token"

# Custom token via environment variable
export DEVUI_AUTH_TOKEN="your-secure-token"
devui ./agents --auth --host 0.0.0.0

Minden API-kérésnek tartalmaznia kell egy érvényes Bearer tokent a Authorization fejlécben.

curl http://localhost:8080/v1/entities \
  -H "Authorization: Bearer your-token-here"

Ha közzé kell tennie a DevUI-t a végfelhasználók számára (éles környezetben nem ajánlott):

devui ./agents --mode user --auth --host 0.0.0.0

Ez a konfiguráció:

  • A fejlesztő által használt API-k korlátozása
  • Hitelesítést igényel
  • Kötések az összes hálózati adapterhez

Biztonsági funkciók

A DevUI számos biztonsági intézkedést tartalmaz:

Tulajdonság Description
Localhost-kötés Alapértelmezés szerint a 127.0.0.1-hez kapcsolódik
Felhasználói mód A fejlesztői API-k korlátozása
Tulajdonos hitelesítése Nem kötelező token-alapú hitelesítés
Helyi entitás betöltése Csak a helyi könyvtárakból vagy a memóriában tárolt entitásokat tölti be.
Nincs távoli végrehajtás Nincsenek távoli kódvégrehajtási képességek

Ajánlott eljárások

Hitelesítő adatok kezelése

  • API-kulcsok és titkos kódok tárolása fájlokban .env
  • Soha ne véglegesítse .env a fájlokat a forrásvezérlőben
  • Fájlok használata .env.example a szükséges változók dokumentálásához
# .env.example (safe to commit)
OPENAI_API_KEY=your-api-key-here
AZURE_OPENAI_ENDPOINT=https://your-resource.openai.azure.com/

# .env (never commit)
OPENAI_API_KEY=sk-actual-key
AZURE_OPENAI_ENDPOINT=https://my-resource.openai.azure.com/

Hálózati biztonság

  • A DevUI-t a localhosthoz kell kötni fejlesztés céljából
  • Használjon fordított proxyt (nginx, Caddy), ha külső hozzáférésre van szükség
  • HTTPS engedélyezése fordított proxyn keresztül
  • A megfelelő hitelesítés implementálása proxyszinten

Entitás biztonsága

  • Futtatás előtt tekintse át az összes ügynök-/munkafolyamat-kódot
  • Csak megbízható forrásokból származó entitások betöltése
  • Legyen óvatos a mellékhatásokat okozó eszközökkel (fájlhozzáférés, hálózati hívások)

Erőforrás-karbantartás

Regisztrálja a törlési horgokat a hitelesítő adatok és erőforrások megfelelő bezárásához a leállításkor:

from azure.identity.aio import DefaultAzureCredential
from agent_framework import Agent
from agent_framework.azure import AzureOpenAIChatClient
from agent_framework_devui import register_cleanup, serve

credential = DefaultAzureCredential()
client = AzureOpenAIChatClient()
agent = Agent(name="MyAgent", chat_client=client)

# Register cleanup hook - credential will be closed on shutdown
register_cleanup(agent, credential.close)
serve(entities=[agent])

MCP-eszközök szempontjai

Ha a Model Kontextus Protokoll (MCP) eszközöket használja a DevUI-val:

# Correct - DevUI handles cleanup automatically
mcp_tool = MCPStreamableHTTPTool(url="http://localhost:8011/mcp", chat_client=chat_client)
agent = Agent(tools=mcp_tool)
serve(entities=[agent])

Fontos

Ne használjon async with környezetmenedzsereket a DevUI-hoz készült MCP-eszközökkel rendelkező ügynökök létrehozásakor. A kapcsolatok a végrehajtás előtt bezárulnak. Az MCP-eszközök lusta inicializálást használnak, és első használatkor automatikusan csatlakoznak.

Következő lépések

  • Minták – Mintaágensek és munkafolyamatok tallózása
  • API-referencia – Az API-végpontok ismertetése
  • Last updated on