Berechtigungen auf API-Ebene für Sandboxes

Prüfen Sie die Zugriffs- und Autorisierungsinformationen für den OCI Generative AI-Sandbox-Ressourcentyp, und erteilen Sie Sandbox-Workloads den erforderlichen OCI-Ressourcenzugriff.

Für bestimmte Berechtigungen für diesen Ressourcentyp prüfen Sie diese Seite. Eine Liste aller Ressourcentypen, die in OCI Generative AI verfügbar sind, finden Sie unter Benutzerzugriff auf einzelne Ressourcen.

Die auf dieser Seite aufgeführten Sandbox-Vorgänge sind Data-Plane-Vorgänge in der Sandbox-API für generative KI. Bei der Projektkonfiguration werden separate Control-Plane-Vorgänge verwendet. Siehe Berechtigungen auf API-Ebene für Projekte.

Ressourcentyp

Ressourcentyp für IAM-Berechtigungen Dokumentationsreferenz API-Referenz
generative-ai-sandbox Sandboxes in OCI Generative AI Generative KI-Sandbox-API

Berechtigung prüfen

Erteilen Sie den Benutzergruppen die Berechtigung inspect, um den folgenden Vorgang auszuführen:

  • ListSandboxes abrufen

Leseberechtigung

Erteilen Sie den Benutzergruppen die Berechtigung read, um die folgenden Vorgänge auszuführen:

  • ListSandboxes abrufen
  • GetSandbox abrufen

Berechtigung verwenden

Erteilen Sie den Benutzergruppen die Berechtigung use, um die folgenden Vorgänge auszuführen:

  • ListSandboxes abrufen
  • GetSandbox abrufen
  • PUT UpdateSandbox
  • POST RunSandboxCommand

Die Berechtigung GENERATIVE_AI_SANDBOX_USE ermöglicht eine aktive Interaktion mit einer vorhandenen Sandbox, wie z.B. die Ausführung eines Befehls. Er erteilt keine Berechtigung zum Erstellen oder Löschen einer Sandbox.

Berechtigung verwalten

Erteilen Sie den Benutzergruppen die Berechtigung manage, um die folgenden Vorgänge auszuführen:

  • ListSandboxes abrufen
  • GetSandbox abrufen
  • PUT UpdateSandbox
  • POST RunSandboxCommand
  • POST CreateSandbox
  • DeleteSandbox LÖSCHEN
Hinweis

  • Die Berechtigung manage umfasst alle Aktionen, die für use, read und inspect zulässig sind.
  • Die Berechtigung use umfasst alle Aktionen, die von read und inspect zulässig sind.
  • Die Berechtigung read umfasst alle Aktionen, die von inspect zulässig sind.
Tipp

Der Ressourcentyp generative-ai-sandbox ist Teil von generative-ai-family. Wenn Sie die Berechtigung für die Familie haben, haben Sie die gleiche Berechtigung für diesen Ressourcentyp. Beispiel:
allow group <your-group-name> to manage generative-ai-family
in compartment <your-compartment-name>

1-1 Berechtigungen für APIs

Hinweis

Es wird empfohlen, die übergeordneten IAM-Verben manage, use, read und inspect zu verwenden. Beispiel: Die Berechtigung zum Löschen einer Sandbox erteilt nicht auch die Berechtigung zum Auflisten von Sandboxes.

Wenn ein Anwendungsfall Zugriff auf einen bestimmten API-Vorgang erfordert, verwenden Sie die hier aufgeführten individuellen Berechtigungen.

generative-ai-sandbox

Berechtigung API-Vorgang Vorgangstyp Verb
GENERATIVE_AI_SANDBOX_INSPECT ListSandboxes GET inspect
GENERATIVE_AI_SANDBOX_READ GetSandbox GET read
GENERATIVE_AI_SANDBOX_UPDATE UpdateSandbox PUT use
GENERATIVE_AI_SANDBOX_USE RunSandboxCommand POST use
GENERATIVE_AI_SANDBOX_CREATE CreateSandbox POST manage
GENERATIVE_AI_SANDBOX_DELETE DeleteSandbox DELETE manage

Policys für Projekte und Sandbox-Workloads

Benutzerzugriff

Ein Administrator kann diese Compartment-bezogenen Policys für eine Gruppe verwenden, die Sandboxes und ihre Projekte erstellt und verwaltet. Ersetzen Sie die Platzhalter durch die Gruppen- und Compartment-Namen.

Allow group <group-name> to manage generative-ai-sandbox in compartment <compartment-name>
Allow group <group-name> to manage generative-ai-project in compartment <compartment-name>

Die erste Policy lässt Sandbox-Vorgänge zu. Die zweite ermöglicht die Projektkonfiguration. Siehe Berechtigungen auf API-Ebene für Projekte und IAM-Policys für OCI Generative AI.

Zugriff von einer Sandbox auf OCI-Services

Code, der in einer Sandbox ausgeführt wird, kann seinen Resource Principal verwenden, um OCI-Services aufzurufen. Umfang von Policys für das Projekt und die Zielressourcen. Beispiel: Mit der folgenden Policy können Sandboxes aus einem Projekt Objekte in einem Bucket lesen:

Allow any-user to read objects in compartment <target-compartment-name>
where all {
  request.principal.type = 'generativeaisandbox',
  request.principal.project_id = '<project-ocid>',
  target.bucket.name = '<bucket-name>'
}

Die Berechtigung gilt für Sandboxes aus dem angegebenen Projekt. Um verschiedenen Workloads unterschiedlichen OCI-Zugriff zu gewähren, verwenden Sie separate Projekte oder Policys, die auf die erforderlichen Ressourcen ausgerichtet sind. Die Objektberechtigungen und die Bucket-Bedingung finden Sie unter Details zu Object Storage und Archive Storage.

Verwenden Sie innerhalb der Sandbox --auth resource_principal mit der OCI-CLI oder einen Resource Principal Signer mit dem OCI-Python-SDK:

import oci

signer = oci.auth.signers.get_resource_principals_signer()
client = oci.object_storage.ObjectStorageClient(
    config={"region": "us-chicago-1"},
    signer=signer,
)

Vault Secret lesen

Für eine Workload, die ein Vault Secret benötigt, erteilen Sie Zugriff auf das spezifische Secret Bundle:

Allow any-user to read secret-bundles in compartment <secret-compartment-name>
where all {
  request.principal.type = 'generativeaisandbox',
  request.principal.project_id = '<project-ocid>',
  target.secret.id = '<secret-ocid>'
}

Verwenden Sie den Resource Principal Signer mit dem OCI Secrets-Client, um das Secret zur Laufzeit abzurufen. Secret-Werte außerhalb der Befehlsausgabe und Logs beibehalten. Secret-Bundle-Berechtigungen finden Sie unter Details zu Vault, Key Management und Secret Management Service.

Sonstige Berechtigungen

Benutzerdefiniertes Networking erfordert die Berechtigung, das ausgewählte Subnetz und alle Netzwerksicherheitsgruppen (NSGs), die Sie anhängen, zu verwenden. NSGs verwenden Sicherheitsregeln, um den eingehenden und ausgehenden Traffic für zugehörige Ressourcen zu steuern. Benutzerdefinierte Images erfordern die Berechtigung zum Lesen des Image-Repositorys. Wenn die Durchsetzung von Sicherheitslückenscans aktiviert ist, scannen Sie die Ergebnisse. Siehe Networking für Sandboxes und Benutzerdefiniertes Image für eine Sandbox verwenden.