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:
ListSandboxesabrufen
Leseberechtigung
Erteilen Sie den Benutzergruppen die Berechtigung read, um die folgenden Vorgänge auszuführen:
ListSandboxesabrufenGetSandboxabrufen
Berechtigung verwenden
Erteilen Sie den Benutzergruppen die Berechtigung use, um die folgenden Vorgänge auszuführen:
ListSandboxesabrufenGetSandboxabrufen- 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:
ListSandboxesabrufenGetSandboxabrufen- PUT
UpdateSandbox - POST
RunSandboxCommand - POST
CreateSandbox DeleteSandboxLÖSCHEN
- 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.
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
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.