Logs d'audit OpenAI
Bêta
Lakewatch est en bêta. Les administrateurs de workspace peuvent contrôler l’accès à cette fonctionnalité à partir de la page Previews . Consultez Gérer les aperçus au niveau du workspace.
Utilisez le connecteur Lakewatch API pour ingérer les événements de log d’audit de l’organisation à partir de la plateforme OpenAI API. Cette page couvre les prérequis, les instructions de configuration, le schéma du connecteur et les observables de sécurité.
Prérequis
Le connecteur nécessite :
- LakeFlow Pipelines Serverless activés dans votre Workspace.
- Unity Catalog, avec les privilèges pour créer ou utiliser une connexion Unity Catalog. Voir Autorisations de connexion.
- La préversion de Lakeflow Connect pour OpenAI activée dans votre workspace par un administrateur du workspace. Voir Activer la préversion du connecteur.
- Si la politique de réseau serverless de votre workspace utilise un accès restreint, les domaines d’API de la source doivent figurer sur la liste des domaines autorisés de la politique. Consultez la section Autoriser les domaines d’API source dans votre politique réseau.
- La journalisation d'audit est activée pour votre organisation OpenAI. Une fois la journalisation d'audit activée, seul le support OpenAI peut la désactiver. Voir Documentation de l'API Admin et Logs d'audit d'OpenAI.
- Le rôle de propriétaire de l’organisation dans votre organisation OpenAI pour créer la clé API d’administration qui authentifie le connecteur. Voir le guide des APIs d’administration d’OpenAI.
Limitations connues
- Les dimensions à évolution lente (SCD) de type 2 ne sont pas prises en charge.
- Le connecteur prend en charge l’authentification par clé API administrateur OpenAI. Les clés API de projet standard et OAuth ne sont pas prises en charge.
- La première synchronisation de la table
audit_log_entriesdémarre à l’heure de start de la source de données, qui doit se situer dans les 365 derniers jours. Si vous ne définissez pas d’heure de start, l’ingestion démarre lorsque vous créez la source de données. Les synchronisations ultérieures reprennent à partir de la dernière valeureffective_atingérée. Voir Choisir jusqu’où remonter pour l’ingestion.
Configurer OpenAI pour l’ingestion
Le connecteur s’authentifie auprès de l’API d’administration OpenAI avec une clé API d’administration, qu’il envoie sous forme de jeton Bearer. Les clés API d’administration ne fonctionnent qu’avec les Endpoint de l’API d’administration. Pour obtenir les étapes complètes, consultez Configurer l’authentification auprès d’OpenAI.
- Connectez-vous à la plateforme OpenAI en tant que propriétaire d'organisation.
- Ouvrez la page Clés d’administration pour votre organisation.
- Créez une clé d’API d’administration et définissez ses autorisations sur Lecture seule . L’accès en lecture seule est suffisant pour l’ingestion. Consultez le guide d’OpenAI sur l’attribution des autorisations de clé API.
- Copiez la clé d’API d’administration. OpenAI affiche la clé complète une seule fois.
Lorsque vous créez une connexion via l’interface utilisateur Lakewatch, entrez la clé API administrateur que vous avez copiée à l’étape précédente.
Étapes suivantes
Une fois OpenAI configuré, créez une source de données avec le connecteur OpenAI dans l’interface utilisateur Lakewatch. Voir Connecteurs API pour obtenir des instructions.
Schémas de connecteur et de Lakewatch
Lakewatch ingère les événements de logs d'audit de l'organisation OpenAI dans une table unique nommée audit_log_entries.
Table source | Données OpenAI | Analyseur Lakewatch intégré |
|---|---|---|
| Événements de log d’audit d’organisation, tels que les modifications de clé API, d’utilisateur, de projet et de paramètre d’organisation |
|
Le connecteur écrit chaque table source directement dans la destination configurée pour son analyseur intégré. Par default, la table de destination est nommée <parser>_<datasource>, où <datasource> est le nom de la source de données. Par exemple, avec le nom de source de données default openai, la table est openai_audit_openai. Vous pouvez définir une destination différente lors de la création de la source de données. Il n'y a pas de table de transfert brute distincte ou d'étape d'analyse ultérieure.
Colonnes gérées par Lakewatch
Le connecteur utilise le champ source id comme clé primaire non nulle et le champ source effective_at comme curseur pour l’ingestion incrémentielle. Contrairement aux connecteurs qui synthétisent un ID Lakewatch, ce connecteur n’ajoute pas de colonne lw_id ou time. Pour limiter une query ou une règle de détection à une fenêtre temporelle, transmettez la colonne effective_at à IN_TIMERANGE().
Pour les sources de données Lakewatch, le connecteur ajoute également :
lw_meta: la source de données et l’identité de connexion, le nom et la version de l’analyseur, ainsi que l’heure d’ingestion.lw_observables: Observables de sécurité extraits par le connecteur.
Consultez les tables de sortie du connecteur.
Schéma de la table de sortie du connecteur
La destination inclut les colonnes source et événement ci-dessous, ainsi que les colonnes lw_meta et lw_observables décrites ci-dessus.
La table audit_log_entries écrit une ligne par événement de log d'audit. Chaque ligne contient l'ID de l'événement, son type et son heure, ainsi que l'acteur et le projet auxquels l'événement est associé. La colonne data stocke l'enregistrement de log d'audit original complet sous forme de VARIANT, y compris l'objet details nommé d'après l'événement type, tel que project.updated.
Schéma
Column | Data type |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
Pour les définitions de champ, voir Documentation de l'objet journal d'audit d'OpenAI.
Observables de sécurité
Le connecteur extrait ces champs dans lw_observables:
Observables
Field | Observable |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
Les champs dans data dépendent de l’événement type. Le connecteur scanne data et extrait les valeurs dans lw_observables en faisant correspondre les noms des sous-champs. La correspondance n’est pas sensible à la casse.
Observables de données
| Observable |
|---|---|
|
|
|
|
|
|
|
|
|
|