Leitfaden zur HIPAA-Konfiguration für Codex Local

Für wen dieser Leitfaden bestimmt ist

Wenn Sie Workflows haben, die geschützte Gesundheitsinformationen (PHI) verarbeiten können, verwenden Sie diesen Leitfaden, um Codex Local entsprechend zu konfigurieren. Codex Local umfasst die ChatGPT-Desktop-App, die Codex IDE-Erweiterung und die Codex CLI, die auf den Computern Ihrer Benutzer ausgeführt werden.

Wenn Sie ChatGPT for Healthcare, ChatGPT for Clinicians oder einen Regulated-Arbeitsbereich verwenden und über ein anwendbares OpenAI Business Associate Agreement (BAA) verfügen, verarbeitet OpenAI die von Codex Local empfangenen PHI gemäß dem BAA. OpenAI verarbeitet Prompts, Dateien und andere Eingaben, die durch Ihre Nutzung von Codex empfangen werden, auf sichere Weise und gibt die Ausgaben sicher an Sie zurück.

OpenAI und Ihre Organisation tragen gemeinsam die Verantwortung für die Absicherung der OpenAI-Dienste. Sie sind für die sichere Konfiguration lokaler Arbeitsstationen, Quellcode-Repositorys, der lokalen Aufbewahrung, lokaler MCP-Server, der Browser Use- und Computer Use-Aktivitäten, von Desktop-Apps sowie von Drittanbieterdiensten wie Google Drive oder GitHub verantwortlich, auf die Codex zugreifen kann. Dieser Leitfaden erläutert, wie Sie diese Tools konfigurieren.

Gemeinsame Verantwortung

Wie bei den meisten Cloud-Lösungen tragen Cloud-Dienstanbieter und Kunde gemeinsam die Verantwortung für die Compliance. ChatGPT Enterprise speichert Ein- und Ausgaben in der OpenAI-Cloud. Die Arbeitsstationen Ihrer Benutzer bewahren Ein- und Ausgaben von Codex Local auf. Codex sendet Eingaben wie Prompts und Dateien zur Inferenz an OpenAI, und OpenAI gibt die Ausgaben zurück. Bei einer über ChatGPT authentifizierten Nutzung bewahrt OpenAI Audit-Datensätze bis zu 30 Tage lang auf, damit Sie diese über die Compliance API abrufen können. OpenAI trainiert nicht mit Daten aus ChatGPT Enterprise oder Codex Local.

Die Konfiguration Ihrer lokalen Arbeitsstation, insbesondere deren TOML-Richtliniendateien, bestimmt, was Codex auf dem Computer eines Benutzers tun kann. Sie legt fest, ob Codex Dateien lesen und schreiben, Befehle ausführen, Netzwerkzugriff nutzen, Plugins oder Connectors aufrufen, MCP-Tools verwenden, Browseroberflächen öffnen und lokale Transkripte aufbewahren kann. Diese Einstellungen ändern nichts an den Verpflichtungen von OpenAI gemäß dem BAA, sind jedoch für Ihre HIPAA-Schutzmaßnahmen von zentraler Bedeutung. Dieser Leitfaden beschreibt Einstellungen, mit denen Sie Codex Local entsprechend Ihren internen Richtlinien zur Nutzung und zum Schutz von PHI konfigurieren können.

Sicherheitsprogramm von OpenAI

OpenAI unterhält ein Sicherheitsprogramm für Unternehmen, das die von OpenAI-Diensten verarbeiteten Daten schützen und regulierte Organisationen bei der Erfüllung ihrer Compliance-Verpflichtungen unterstützen soll.

OpenAI setzt ein Programm für Enterprise Risk Management und eine formelle Risiko-Governance-Struktur ein, die auch die Berichterstattung an Vorstandsausschüsse umfasst. Maßnahmen zur Produktsicherung tragen dazu bei, dass bei Produkteinführungen Schutzmaßnahmen wie Verschlüsselung, Zugriff nach dem Prinzip der geringsten Berechtigung und granulare Protokollierung zur Unterstützung der HIPAA-Compliance erhalten bleiben. Produktrisikobewertungen, die Überwachung von Kontrollen und Compliance-Prüfungen helfen dabei, vernünftigerweise vorhersehbare Risiken für Ihre Daten zu identifizieren, die Wirksamkeit von Schutzmaßnahmen zu beurteilen und die kontinuierliche Verbesserung der von ChatGPT Enterprise, der API-Plattform und Codex-bezogenen Diensten eingesetzten Kontrollen zu unterstützen.

Sichere Entwicklungs- und CI/CD-Schutzmaßnahmen tragen dazu bei, das Risiko zu verringern, dass Änderungen an Codex-bezogenen Diensten zu unbefugtem Zugriff, Datenlecks oder Integritätsproblemen führen. Zu diesen Schutzmaßnahmen gehören kontrollierter Zugriff auf den Quellcode, Peer-Reviews, automatisierte Tests, Sicherheitsprüfungen in Build- und Bereitstellungsworkflows, Kontrollen für den Umgang mit Geheimnissen und überwachte Bereitstellungsprozesse. Ein kontrollierter Softwarebereitstellungsprozess unterstützt die OpenAI-Dienstebene, während Sie weiterhin für die Ordnung und Sicherheit lokaler Repositorys und Arbeitsstationen sowie für das durch die Konfiguration lokaler Richtliniendateien zugelassene Verhalten verantwortlich sind.

Das Schwachstellenmanagementprogramm von OpenAI umfasst kontinuierliche Scans, Prüfungen von Abhängigkeiten und Infrastruktur, eine nach Schweregrad geordnete Triage, die Nachverfolgung von Behebungsmaßnahmen und die Validierung von Korrekturen. OpenAI setzt außerdem interne und externe Red Teams, unabhängige Sicherheitstests und Kanäle für die verantwortungsvolle Offenlegung ein, um Sicherheitslücken zu identifizieren und zu beheben, bevor sie Ihre Daten beeinträchtigen können.

Datenschutzkontrollen umfassen die Verschlüsselung Ihrer Daten bei der Übertragung und im Ruhezustand, Identitäts- und Zugriffskontrollen, rollenbasierte Administration, Protokollierung und Aufbewahrungskontrollen, die den jeweils geltenden Einstellungen der ChatGPT Enterprise- oder API-Organisation entsprechen.

Anmeldung bei Codex Local

Codex unterstützt bei der Verwendung von OpenAI-Modellen zwei OpenAI-Anmeldemethoden: die ChatGPT-Anmeldung für den Zugriff im Rahmen eines Abonnements und die Anmeldung mit einem API key für die nutzungsbasierte Abrechnung. OpenAI unterstützt bei beiden Methoden die HIPAA-Compliance im Rahmen des jeweils anwendbaren OpenAI BAA.

Bei der ChatGPT-Anmeldung richtet sich die Codex-Nutzung nach den Berechtigungen des ChatGPT-Arbeitsbereichs des Benutzers, der rollenbasierten Zugriffskontrolle (RBAC) sowie den Aufbewahrungs- und Datenresidenzeinstellungen von ChatGPT Enterprise. Bei der Anmeldung mit einem API key richtet sich die Codex-Nutzung nach den Einstellungen der OpenAI API-Organisation für Aufbewahrung, Datenfreigabe und Administration und nicht nach den Einstellungen des ChatGPT-Arbeitsbereichs. Die Anmeldung mit einem API key wird häufig für programmatische Codex CLI-Workflows wie vertrauenswürdige CI/CD-Aufträge verwendet. Sie sollten API keys jedoch nicht in öffentlichen oder nicht vertrauenswürdigen Ausführungsumgebungen offenlegen.

Ihre Verantwortlichkeiten

Sie bleiben für die Arbeitsstationen verantwortlich, auf denen Codex Local ausgeführt wird. Führen Sie für die lokale Nutzung von Codex eine eigene Risikoanalyse durch, einschließlich Kontrollen wie Arbeitsstationskonfiguration, Betriebssystemsicherheit, Festplattenverschlüsselung, Schadsoftwareschutz, Geräteverwaltung, Patch-Management, Benutzerzugriff, sichere Speicherung von Anmeldedaten und lokale Aufbewahrung.

Sie entscheiden, welche Benutzer Codex Local verwenden dürfen, welche Anmeldemethoden ihnen zur Verfügung stehen, auf welche Arbeitsbereiche sie zugreifen können, ob sie sich mit einem API key anmelden dürfen, welche Repositorys und Ordner PHI enthalten dürfen und ob Codex externe Dienste verwenden darf.

Sie sind außerdem für aktivierte Drittanbieterdienste und dafür verantwortlich, welche Benutzer Zugriff darauf haben. Wenn Ihre Organisation in einer Umgebung mit PHI ein Browserziel, Plugin, einen Connector oder MCP-Server für Microsoft SharePoint, Google Drive, GitHub oder einen anderen Dienst aktiviert, vergewissern Sie sich, dass Ihre Organisation den Dienst für PHI genehmigt hat und über ein entsprechendes BAA oder einen vergleichbaren Zusatz für das Gesundheitswesen verfügt. Das BAA von OpenAI macht einen anderen Anbieter nicht zu einem HIPAA-konformen Ziel.

In den folgenden Abschnitten wird erläutert, wie Sie Ihre HIPAA-Compliance mithilfe der Richtlinienkonfigurationsdatei requirements.toml und zugehöriger Einstellungen verwalten können. Prüfen Sie die OpenAI-Dokumentation auf weitere Einstellungen und wiederholen Sie diese Prüfung, wenn sich die Funktionen von Codex ändern.

Codex aktivieren

Befolgen Sie die Anleitung zur Administratoreinrichtung, um Codex Local für Ihren Arbeitsbereich zu aktivieren. Wenden Sie sich an Ihren OpenAI Account Director, um die HIPAA-Unterstützung von Codex für den Arbeitsbereich zu aktivieren.

Das BAA gilt nicht für Codex cloud. Verwenden Sie Codex cloud nicht mit PHI.

Rollenbasierte Zugriffskontrolle konfigurieren

Sie können den Zugriff auf Codex Local und dessen Konfiguration mithilfe von RBAC anpassen. Beispielsweise können Benutzer, die nicht mit PHI arbeiten, eine weniger restriktive Konfiguration erhalten, während Benutzer, die mit PHI arbeiten, die in diesem Leitfaden beschriebene Konfiguration erhalten können. Steuern Sie den organisationsweiten Zugriff auf Codex Local über die Seite für ChatGPT-Administratorberechtigungen und -rollen. Um den Zugriff für bestimmte Benutzer zu steuern, erstellen Sie Gruppen und bearbeiten Sie die Berechtigungen dieser Gruppen.

Plugins und Connectors prüfen

Codex Local unterstützt Plugins, die Connectors und Skills enthalten können. Mit Connectors können Sie Daten mit Datenquellen von Drittanbietern austauschen. Bevor Sie ein Plugin mit einem Connector aktivieren, klären Sie, ob Sie ein BAA mit einem Drittanbieter benötigen, der über den Connector Daten empfängt. Skills sind Anweisungen, die innerhalb der Richtlinienkonfiguration ausgeführt werden. Prüfen Sie Skills wie jedes andere Skript darauf, ob sie für den vorgesehenen Zweck geeignet sind.

Arbeitsbereichsadministratoren müssen ein Plugin über die Plugin-Steuerung verfügbar machen und dessen Connectors separat aktivieren, bevor Benutzer sie verwenden können. Konfigurieren Sie den Connector- Zugriff in den Connector-Einstellungen.

Verwaltete Anforderungen und Standardwerte konfigurieren

Anforderungen und verwaltete Standardwerte in TOML-Konfigurationsdateien steuern das Verhalten von Codex. Lokale Arbeitsstationen speichern die Konfiguration auf Benutzerebene unter ~/.codex/config.toml. Die CLI und die IDE-Erweiterung verwenden dieselben Konfigurationsebenen. Verwenden Sie verwaltete Anforderungen in requirements.toml, um von Administratoren erzwungene Einschränkungen festzulegen, die Benutzer nicht überschreiben können. OpenAI empfiehlt, Ihre Anforderungen an den Umgang mit PHI durch eine verwaltete Konfiguration durchzusetzen.

Administratoren können auf der Codex-Richtlinienseite cloudverwaltete Anforderungen mit einer zu requirements.toml kompatiblen Syntax konfigurieren. Sie können Anforderungen außerdem über eine Geräteverwaltung wie macOS MDM verteilen. Codex wendet Anforderungsebenen in dieser Reihenfolge an: cloudverwaltete Anforderungen, macOS MDM-Anforderungen und systemweites requirements.toml. Frühere Anforderungen haben bei jedem von ihnen festgelegten Feld Vorrang.

Verwaltete Standardwerte sind von Anforderungen getrennt. Sie legen die anfängliche Konfiguration fest, mit der Codex startet, Benutzer können diese Einstellungen jedoch während einer Sitzung ändern. Codex wendet die Standardwerte beim nächsten Start erneut an. Verwenden Sie verwaltete Standardwerte zur Standardisierung, nicht zur strikten Durchsetzung von Compliance. Sie können beispielsweise ein Standardmodell, ein Berechtigungsprofil oder ein anderes bevorzugtes lokales Verhalten festlegen. Wenn eine Einstellung für PHI-Workflows nicht umgangen werden darf, nehmen Sie sie stattdessen in die Anforderungen auf. Bei verwalteten Standardwerten haben die von macOS MDM verwalteten Einstellungen die höchste Priorität, gefolgt vom systemweiten managed_config.toml und anschließend dem lokalen config.toml des Benutzers.

Die folgende Tabelle fasst einige der verfügbaren Einstellungen zur Konfiguration von Codex Local zusammen. Prüfen Sie diese Einstellungen und die Ressourcen unter Referenzen, um Codex Local so zu konfigurieren, dass es Ihren Compliance-Anforderungen entspricht.

requirements.toml für den Einstieg

OpenAI stellt für ChatGPT Enterprise und Regulated Workspaces eine Einstiegskonfiguration bereit, die einen Teil der Einstellungen aus der vorherigen Tabelle verwendet. Wenn Sie cloudverwaltete Anforderungen als Mechanismus zur Verteilung der Konfiguration verwenden, finden Sie diese Einstiegskonfiguration auf der Codex-Richtlinienseite. Sie können sie für bestimmte RBAC-Gruppen überschreiben.

Diese Konfiguration reduziert unbefugte Datenabflüsse und ermöglicht zugleich die normale, beaufsichtigte Arbeit mit Codex Local. Prüfen Sie sie vor der Einführung und passen Sie sie an. Die folgenden beiden Beispiele zeigen, wie Sie die Konfiguration zur Unterstützung gängiger Workflows anpassen können.

Zulassungslisten für Berechtigungsprofile erfordern Codex 0.138.0 oder neuer. Stellen Sie dieses Beispiel erst bereit, nachdem auf allen verwalteten Clients eine unterstützte Version ausgeführt wird.

# Starter requirements.toml for Codex Local use with PHI.
# Review and adapt this policy before rollout.

allowed_approval_policies = ["on-request", "untrusted"]
allowed_approvals_reviewers = ["user"]
allowed_web_search_modes = ["cached"]

default_permissions = ":workspace"

[allowed_permission_profiles]
":read-only" = true
":workspace" = true

[features]
computer_use = false
browser_use = false
browser_use_full_cdp_access = false
in_app_browser = false

[mcp_servers]
# None allowed by default.

Beispiel 1: Google-Drive-Plugin aktivieren

Aktivieren Sie Google Drive nur für eine genehmigte Gruppe, nachdem Sie den Datenfluss, die OAuth-Berechtigungsumfänge, die Zugriffskontrollen und den BAA-Status des Drittanbieters geprüft haben. Das BAA von OpenAI regelt den Umgang von OpenAI mit PHI; es schließt Google als Empfänger oder Verwahrer von PHI nicht automatisch ein.

Codex verwendet den Konfigurationsschlüssel apps für Konnektoreinstellungen. Dieses Beispiel aktiviert den Google-Drive-Konnektor über diesen Schlüssel.

# Example config.toml change for a group approved to use
# the Google Drive connector with PHI, after legal and security review.

[features]
apps = true

[apps.google_drive]
enabled = true
destructive_enabled = false
default_tools_enabled = true
default_tools_approval_mode = "prompt"

[apps.google_drive.tools."files/delete"]
enabled = false

Lassen Sie destruktive Aktionen standardmäßig deaktiviert, verlangen Sie vor der Verwendung von Konnektor-Tools eine Bestätigung, beschränken Sie den Zugriff nach RBAC-Gruppe und prüfen Sie, sofern verfügbar, die Google-Workspace-Auditprotokolle auf Konnektoraktivitäten.

Beispiel 2: GitHub lokal verwenden

Für die lokale Entwicklung verwenden viele Teams Git oder die GitHub CLI auf dem Entwicklerarbeitsplatz. Dies unterscheidet sich von Codex Cloud. Wenn Repositorys, Issues, Pull Requests oder Kommentare PHI enthalten können, vergewissern Sie sich vor der Aktivierung dieses Pfads, dass Ihre Organisation die GitHub-Umgebung für diese Daten genehmigt hat.

# Example requirements.toml addition for local GitHub use.
# This doesn't enable Codex cloud. It keeps repository actions reviewable.

[rules]
prefix_rules = [
  { pattern = [{ token = "git" }, { any_of = ["push", "commit"] }], decision = "prompt", justification = "Require review before changing repository history." },
  { pattern = [{ token = "gh" }], decision = "prompt", justification = "Require review before using GitHub CLI." },
]

Diese Richtlinie blockiert die Verwendung von GitHub nicht. Sie schafft einen Prüfpunkt, bevor Codex den Repository-Verlauf ändert oder Befehle der GitHub CLI verwendet.

Optional: Einen geprüften GitHub-MCP-Server verwenden

Wenn Ihr Team statt ausschließlich lokaler Git-Befehle einen GitHub-MCP-Server verwendet, setzen Sie die exakte Identität des genehmigten Servers auf die Zulassungsliste und beschränken Sie die Tools auf den kleinstmöglichen genehmigten Umfang.

# Optional: allow a vetted GitHub MCP server.
# Use the exact approved server identity for your environment.

# requirements.toml
[mcp_servers.github]
identity = { url = "https://github-mcp.example.com/mcp" }

# config.toml
[mcp_servers.github]
url = "https://github-mcp.example.com/mcp"
enabled = true
default_tools_approval_mode = "prompt"
enabled_tools = ["<approved-read-tools>", "<approved-pr-tools>"]

Praktische Schritte zur Einführung

1. Wählen Sie den genehmigten Anmeldepfad aus. Entscheiden Sie, ob sich Benutzer mit ChatGPT bei Codex Local authentifizieren, API keys verwenden oder beides für getrennte Workflows einsetzen sollen.
2. Bestätigen Sie das BAA mit OpenAI. Vergewissern Sie sich, dass Sie für Ihre genehmigten Anmeldepfade ein BAA mit OpenAI abgeschlossen haben. Wenden Sie sich an Ihren OpenAI Account Director, um die Codex-HIPAA-Unterstützung für einen ChatGPT-Workspace zu aktivieren.
3. Aktivieren Sie Codex Local und definieren Sie RBAC-Gruppen. Verwenden Sie die Einrichtung der Codex Enterprise-Administration, um Codex Local zu aktivieren, eine kleine Gruppe von Codex-Administratoren zu erstellen und den Codex-Zugriff über RBAC-Gruppen wie Codex Users und Codex PHI Users zuzuweisen.
4. Stellen Sie durch Administratoren erzwungene requirements.toml und verwaltete Standardwerte bereit. Verwenden Sie cloudverwaltete Anforderungen, MDM oder die Systemkonfiguration, um die Einstiegsrichtlinie für PHI-Benutzer durchzusetzen. Konfigurieren Sie Berechtigungsprofile, Genehmigungsrichtlinien, Websuchmodi, Funktionsvorgaben, Netzwerkanforderungen, Befehlsregeln und MCP-Zulassungslisten.
5. Schulen Sie Benutzer zu Genehmigungen und Sandbox-Grenzen. Erläutern Sie mithilfe von Agent-Genehmigungen und Sicherheit, wann Codex innerhalb der Sandbox handeln kann, wann es um Genehmigung bittet und warum Benutzer Netzwerk-, Dateiübertragungs-, Repository-Schreib- und Drittanbieter-Konnektoraktionen prüfen sollten.
6. Prüfen Sie Drittanbieter-Plugins vor der Verwendung von PHI. Vergewissern Sie sich vor der Aktivierung von Plugins mit Konnektoren wie Google Drive und GitHub, Browserzielen oder MCP-Servern, dass Ihre Organisation alle Drittanbieter genehmigt hat, die PHI empfangen, und mit diesen ein geeignetes BAA abgeschlossen hat.
7. Verfolgen, prüfen und aktualisieren Sie die Bereitstellung. Nutzen Sie Exporte der Compliance API, Workspace-Analysen, Endpunktprotokolle, Auditprotokolle von Plugins und verbundenen Diensten sowie Repository-Auditprotokolle, um sicherzustellen, dass die bereitgestellte Sicherheitskonfiguration weiterhin Ihren internen Richtlinien entspricht.

Referenzen

• Codex-Authentifizierung
• Grundlagen der Codex-Konfiguration
• Einrichtung der Codex Enterprise-Administration
• Verwaltete Codex-Konfiguration
• Agent-Genehmigungen und Sicherheit
• Codex Model Context Protocol
• Codex-Governance
• Codex-Berechtigungen
• Funktionen von ChatGPT Healthcare und Regulated Workspace
• ChatGPT for Clinicians
• Business Associate Agreement für OpenAI API-Dienste
• Codex-Whitepaper