Logs d’audit Atlassian
Aperçu
Lakewatch est en aperçu privé. Pour demander l'accès, contactez votre équipe de compte Databricks.
Lakewatch fournit un connecteur API pour ingérer des événements de logs d'audit d'organisation à partir d'Atlassian. Cet article couvre les prérequis, les instructions de configuration, le schéma du connecteur et les observables de l'analyseur Lakewatch.
Prérequis
Le connecteur nécessite :
- Lakeflow Spark Declarative Pipelines Serverless activés dans votre workspace.
- Unity Catalog, avec des privilèges de création ou d’utilisation d’une connexion Unity Catalog. Voir Autorisations de connexion.
- Un abonnement Atlassian Guard Standard, Atlassian Guard Premium ou Cloud Enterprise. Sans l'un de ces éléments, Atlassian ne remplit pas le journal d'audit de l'organisation. Consultez la documentation sur les activités du journal d'audit d'Atlassian.
- Autorisation d'administrateur de l'organisation pour créer la clé d'API qui authentifie le connecteur. Voir la documentation de l’API REST des organisations Atlassian.
Limitations connues
- Le SCD de type 2 n’est pas pris en charge.
- Le connecteur prend en charge l'authentification par clé d'API d'organisation Atlassian. L'authentification par OAuth et par nom d'utilisateur et mot de passe standard n'est pas prise en charge.
- Les clés API Atlassian expirent après un maximum d'un an. Créez une nouvelle clé et mettez à jour la connexion Unity Catalog avant l'expiration de la clé actuelle.
- La rétrospection historique ne peut pas dépasser 180 jours. Voir Choisir la période de rétrospection pour l'ingestion.
Configurer Atlassian pour l'ingestion
Atlassian authentifie les demandes d'API d'administration avec une clé d'API que le connecteur envoie en tant que jeton Bearer. Pour plus d’informations, consultez le guide d’Atlassian sur la gestion d’une organisation avec les APIs d’administration.
- Connectez-vous à l’administration d’Atlassian en tant qu’utilisateur disposant des autorisations d’administration d’organisation. Sélectionnez votre organisation si vous en gérez plus d’une.
- Sélectionnez Paramètres de l’organisation , puis Clés API .
- Sélectionnez Clés API avec portées , puis sélectionnez Créer une clé API .
- Saisissez un nom pour la clé et sélectionnez une date d’expiration. Les clés ne peuvent pas être valides plus d’un an.
- Sélectionnez le périmètre
read:events:admin(affiché comme Lecture pour Événements ). C’est le seul périmètre requis par le connecteur. Voir la documentation des événements de l’API REST des organisations d’Atlassian. - Passez en revue la clé, puis sélectionnez Créer .
- Copiez l’ Organisation ID et l’ API key . Atlassian ne montre plus ces valeurs. Utilisez-les pour créer une connexion au Unity Catalog dans Databricks.
Les clés d’API Atlassian expirent après un an maximum et ne sont pas renouvelées automatiquement. Avant que la clé expire, créez une nouvelle clé d’API d’organisation et mettez à jour la clé d’API sur la connexion Unity Catalog existante. Ne créez pas de nouvelle connexion.
Lorsque vous créez une connexion via l’interface utilisateur de Lakewatch, saisissez l’ ID d’organisation et la clé d’API récupérés ci-dessus.
Pour plus d’informations, consultez Configurer l’authentification auprès d’Atlassian.
Étapes suivantes
Une fois la configuration ci-dessus terminée, créez une source de données avec le connecteur Atlassian dans l'interface utilisateur de Lakewatch. Voir les connecteurs d'API pour les instructions.
Schémas de connecteur et Lakewatch
Le connecteur ingère la table source suivante à partir du schéma source default :
Table source | Données d'Atlassian | Analyseur Lakewatch intégré |
|---|---|---|
| Événements de modification des utilisateurs, de la sécurité et de la configuration de l’organisation |
|
Le connecteur écrit la table source dans la destination brute de la source de données. L’analyseur intégré écrit une table analysée séparée portant le nom de l’analyseur, sauf si vous définissez une destination analysée lors de la configuration de la source de données.
Colonnes gérées par Lakewatch
Le connecteur utilise le champ source id comme clé primaire non nulle et le champ source time comme curseur pour l’ingestion incrémentielle. Contrairement aux connecteurs qui génèrent un ID Lakewatch, ce connecteur n’ajoute pas de colonne lw_id. Le parser attribue la colonne analysée time.
Pour les pipelines créés par Lakewatch, le connecteur ajoute également ces colonnes à la table brute, et la table analysée les inclut :
lw_meta: Métadonnées de traitement Lakewatch standard.lw_observables: Valeurs extraites des champs marqués comme observables de sécurité dans l'analyseur.
Pour plus d’information, consultez la référence du parser.
Schéma de table du connecteur brut
Le schéma suivant comprend les champs d’événement d’audit de l’organisation Atlassian. Pour obtenir des définitions de champs, voir la référence du connecteur Atlassian Audit Logs.
Schéma
Colonne | Type de données |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Observables de l’analyseur
L'analyseur atlassian_audit écrit les objets imbriqués sous la forme VARIANT et extrait les champs suivants dans lw_observables.
Observables
Champ | Observable |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|