Sicherheit

Kontrollieren Sie den Zugriff auf Daten, die von den A2A-Agents verwendet werden, indem Sie Sicherheits-Policys und Auditingmechanismen anwenden.

VPD-Policy

Verwenden Sie Virtual Private Database-(VPD-)Policys, um eine feingranulierte Zugriffskontrolle basierend auf dem Agent-Kontext durchzusetzen. Mit den VPD-Policys können Sie den Zeilenzugriff auf Datenbankobjekte kontrollieren, die von A2A-Agents verwendet werden. Bei der Verarbeitung einer authentifizierten A2A-Anforderung legt Select AI Werte im Anwendungskontext A2A_AGENT_ACCESS_CONTEXT$ fest. Das Attribut USER_IDENTITY identifiziert den Datenbankbenutzer, der mit der Anforderung verknüpft ist. Das Attribut TEAM_NAME identifiziert das Select AI-Agent-Team, das die Anforderung verarbeitet. Mit diesen Werten kann eine VPD-Policy steuern, auf welche Zeilen ein Agent zugreifen kann. Weitere Informationen finden Sie unter Oracle Virtual Private Database zur Kontrolle des Datenzugriffs verwenden.

Beispiel: Die Policy im Beispiel fügt eine Teamname-Bedingung zu Abfragen in HR.EMPLOYEES hinzu. Er gibt nur Zeilen zurück, wenn die Anforderung das Team REPORT_SUMMARY_AGENT_TEAM verwendet. Diese Bedingung schränkt den Zugriff nach Teamname und nicht nach Anmeldebenutzer ein. Um den Zugriff nach Datenbankbenutzer einzuschränken, definieren Sie ein Policy-Prädikat, das USER_IDENTITY prüft. Ersetzen Sie den Teamnamen und die Tabellendetails durch Werte für Ihre Umgebung.

Verfügbare Kontextwerte:

SYS_CONTEXT('A2A_AGENT_ACCESS_CONTEXT$', 'USER_IDENTITY')
SYS_CONTEXT('A2A_AGENT_ACCESS_CONTEXT$', 'TEAM_NAME')

Beispiel: VPD-Policys definieren und anwenden

-- Define VPD policy
CREATE OR REPLACE FUNCTION limit_access (v_schema IN VARCHAR2, v_objname IN VARCHAR2)
RETURN VARCHAR2 authid current_user AS
BEGIN
RETURN 'SYS_CONTEXT(''A2A_AGENT_ACCESS_CONTEXT$'', ''TEAM_NAME'') = ''REPORT_SUMMARY_AGENT_TEAM''';
END;

-- Apply policy on table
BEGIN
DBMS_RLS.ADD_POLICY(
object_schema        => 'HR',
object_name          => 'EMPLOYEES',
policy_name          => 'POL',
policy_function      => 'LIMIT_ACCESS');
END;
/

Weitere Informationen finden Sie unter DBMS_RLS und SYS_CONTEXT.

Audittrail

Wählen Sie "AI" aus, um den Agent-Zugriff auf A2A im einheitlichen Audittrail über eine von Oracle verwaltete Audit-Policy aufzuzeichnen. Für dieses Standardauditing müssen Sie keine benutzerdefinierte Audit-Policy für jedes Team erstellen. Eine benutzerdefinierte Policy fügt Auditing für ausgewählte Datenbankaktionen hinzu, wie SELECT-Aktionen für eine Tabelle, wenn die Bedingungen mit dem Anforderungskontext A2A übereinstimmen. Der Audittrail für die autonome KI-Datenbank ist über die Ansicht UNIFIED_AUDIT_TRAIL verfügbar, die Sie abfragen können, um die auditierte Aktivität zu prüfen.

Sie können benutzerdefinierte Audit-Policys definieren, die den Anwendungskontext A2A_AGENT_ACCESS_CONTEXT$ verwenden, um den Zugriff für ein bestimmtes Select AI-Agent-Team zu prüfen. Im Ausdruck SYS_CONTEXT('A2A_AGENT_ACCESS_CONTEXT$', 'TEAM_NAME') ist TEAM_NAME der Kontextattributname. Ersetzen Sie TEAM_NAME nicht. Ersetzen Sie nur den Vergleichswert, wie 'REPORT_SUMMARY_AGENT_TEAM', durch den Namen Ihres Agent-Teams. Ihre Policy vergleicht diesen Kontextwert mit dem tatsächlichen Namen des Agent-Teams. Beispiel:

SYS_CONTEXT('A2A_AGENT_ACCESS_CONTEXT$', 'TEAM_NAME') =
      'REPORT_SUMMARY_AGENT_TEAM'

SYS_CONTEXT gibt den Wert des benannten Attributs aus dem Anwendungskontext zurück, und der Oracle-Anwendungskontext wird häufig mit Sicherheits- und Policy Enforcement-Features wie VPD und Unified Auditing verwendet.

Im folgenden Beispiel wird eine Policy für SELECT-Aktionen in HR.EMPLOYEES erstellt, wenn eine A2A-Anforderung einen Teamnamen bereitstellt. Da die Bedingung nur prüft, dass TEAM_NAME nicht Null ist, kann sie Anforderungen von jedem Team abgleichen. Um ein bestimmtes Team zu prüfen, vergleichen Sie TEAM_NAME mit dem Namen dieses Teams, wie oben gezeigt.

Beispiel: Audit-Policy erstellen

create audit policy MY_A2A_AGENT_ACCESS_AUDIT_POLICY
actions SELECT on HR.EMPLOYEES
when sys_context('A2A_AGENT_ACCESS_CONTEXT$', 'TEAM_NAME') is not null;

Nachdem Sie die benutzerdefinierte Audit-Policy erstellt haben, aktivieren Sie sie mit der AUDIT POLICY-Anweisung:

AUDIT POLICY MY_A2A_AGENT_ACCESS_AUDIT_POLICY;

Oracle wertet die Policy für Abgleichsvorgänge aus und schreibt einheitliche Auditdatensätze für die Aktivität, die den Policy-Bedingungen entspricht. Diese Datensätze werden dann in UNIFIED_AUDIT_TRAIL angezeigt. Eine einheitliche Audit-Policy wird in der nächsten Benutzersession für die Benutzer wirksam, die auditiert werden. Der Zugriff auf die Auditlogs hängt von Datenbankberechtigungen und Sicherheitskonfiguration ab. Weitere Informationen finden Sie unter CREATE AUDIT POLICY (Unified Auditing) und AUDIT (Unified Auditing).

Die Policy-Bedingung filtert Aktionen nach Team, fügt dem Auditdatensatz jedoch keine Kontextwerte hinzu. Um USER_IDENTITY und TEAM_NAME in Auditdatensätze aufzunehmen, konfigurieren Sie das Application-Context-Auditing:

AUDIT CONTEXT NAMESPACE A2A_AGENT_ACCESS_CONTEXT$
  ATTRIBUTES USER_IDENTITY, TEAM_NAME;

Fragen Sie dann UNIFIED_AUDIT_TRAIL ab, um übereinstimmende Datensätze und ihre erfassten Kontextwerte zu prüfen:

SELECT event_timestamp,
       dbusername,
       action_name,
       object_schema,
       object_name,
       unified_audit_policies,
       application_contexts
FROM   unified_audit_trail
WHERE  INSTR(unified_audit_policies,
             'MY_A2A_AGENT_ACCESS_AUDIT_POLICY') > 0
ORDER BY event_timestamp DESC;

Netzwerkkonfiguration für privaten Endpunkt

Wenn die Datenbank einen privaten Endpunkt verwendet, kann nur über das konfigurierte virtuelle Cloud-Netzwerk (VCN) auf den A2A-Serverendpunkt zugegriffen werden. Externe Clients außerhalb des VCN können keine Verbindung herstellen.

Endpunktformat:

https://{hostname_prefix}.adb.{region-identifier}.oraclecloudapps.com/adb/a2a/v1/{database-ocid}
    Hinweis

  • hostname_prefix: Bei der Einrichtung des privaten Endpunkts definierter oder generierter Wert.

  • region-identifier: Oracle Cloud-Region.

  • database-ocid: OCID der autonomen KI-Datenbank. Hinweis: Stellen Sie sicher, dass der Client, der auf den A2A-Server zugreift, innerhalb desselben VCN bereitgestellt ist oder über Netzwerkkonnektivität verfügt, z.B. VPN.

Rufen Sie die hostname_prefix von der Seite mit den Datenbankdetails in der OCI-Konsole ab.

Weitere Informationen finden Sie unter Privater Endpunktzugriff.

Sie können den A2A-Agent nur dann mit einer autonomen KI-Datenbank mit privatem Endpunkt verwenden, wenn der A2A-Client-Agent in demselben privaten VCN ausgeführt wird oder eine Netzwerkverbindung zur Datenbank aufweist. Wenn der A2A-Client-Agent in einer anderen Cloud oder einer externen Umgebung ausgeführt wird, konfigurieren Sie das Netzwerk gemäß den Konnektivitätsrichtlinien für diese Plattform, um die Kommunikation mit der autonomen KI-Datenbank zu ermöglichen.

Wenn Sie beispielsweise eine Google Gemini Enterprise-Anwendung konfigurieren, befolgen Sie die privaten Netzwerkrichtlinien von Google. Weitere Informationen finden Sie unter Private Multi-Agent-Netzwerkmuster in Google Cloud.

Hinweis

Hinweis: Wenn Sie den Autonomous AI Database MCP-Server oder Agent2Agent-(A2A-)Server aktivieren, werden keine zusätzlichen Compute-Ressourcen wie separate VMs bereitgestellt. Diese Funktionen sind als Teil der autonomen KI-Datenbank mit Ihrer aktuellen Compute-Zuweisung enthalten. Der Ressourcenverbrauch wird durch die Ausführung von Tools (für MCP) oder Agent-Vorgängen (für A2A) innerhalb der vorhandenen Datenbankumgebung bestimmt.

Empfehlungen

  • Definieren Sie object_list im AI-Profil "Select" nur mit erforderlichen Datenbankobjekten. Weitere Informationen finden Sie unter Profilattribute und Beispiel: Filmanalyse-Agent mit integrierten Tools erstellen.

  • Zwei-Schema-Ansatz: Dieser Ansatz dient in erster Linie der Organisation und Sicherung der Select AI Agent-Entwicklung, nicht für die A2A-spezifische Konfiguration.

    • Verwenden Sie ein Schema, z.B. A2A_USER, für Select AI Agent-Objekte wie Agents, Agent-Teams, Aufgaben und Tools.

    • Verwenden Sie ein separates Schema, z.B. SALES_USER, für PL/SQL-Funktionen und andere Anwendungsobjekte, die diese Agents unterstützen.