Software as a Service（SaaS）展開監査ログ

このページでは、SaaS 展開コントローラテナント監査ログをスケジュールおよび管理する方法について説明します。 

AppDynamics では、コントローラテナント UI の一部でコントローラテナントがコントローラと呼ばれます。これらはまったく同じと考えてください。

この監査機能では audit.log ファイルを作成します。これは、コントローラテナント内のユーザーアクティビティと構成変更をモニターするために使用されます。audit.log ファイルは AppDynamics コントローラ テナント サーバー上に保持されているため、AppDynamics のユーザーはこのファイルにアクセスできないことに注意してください。情報を取得するには、レポートをスケジュールし、取得を構成する必要があります。 

監査レポートの作成

このレポートを使用して、ユーザー情報、コントローラテナント構成、およびアプリケーションプロパティに加えられた変更を表示できます。コントローラテナント監査では、次の属性がレポートされます。

スケジュールされたレポートを表示および構成するには、会社管理者の権限が必要です。 

1. [Dashboards & Reports > Reports > Add Report] をクリックします。

2. [Report Title] と [Report Subtitle] を入力します。[Report Subtitle] を使用して、レポートに CONFIDENTIAL のラベルを付けることができます。

3. オプションで、レポートファイルの最初にタイトルページを含める場合は、Show Title Page を選択します。

4. [Report Type] ドロップダウンをクリックし [Controller Audit ] を選択して、[Reports Data] タブのフィールドを定義します。

5. レポートの [Schedule] を構成します。

6. [Report Data] を選択するか、[Next] をクリックします。

7. [Timerange] ドロップダウンをクリックして、[Standard] または [Custom] 時間範囲を設定します。カスタムの時間範囲オプションはすべての [Report Types] に対して使用できます。

8. レポートファイル形式として PDF、JSON、または CSV を選択します。

9. または、[Show Diff] チェックボックスをオフにして、レポートファイルから Object Changes 列を削除します。

10. [Filters] ドロップダウンをクリックして、追加または除外するデータを選択します。

11. 属性値を入力します。

12. [+ Add] をクリックして、さらにフィルタを選択します。

13. [Recipients] を選択するか、[Next] をクリックします。
14. 受信者の電子メールアドレスを入力します。複数の受信者に送信する場合は、[Add] をクリックします。
15. Save をクリックします。

[Reports] ページ内の任意の場所を右クリックすると、追加のオプションと、監査の詳細をすぐに確認できる [Send Report Now] オプションが表示されます。

監査ログレポートの取得

監査ログレポートは、レポート作成時に設定したアドレスに従って電子メールで送信されます。次の情報がキャプチャされます。

• ユーザログインと情報の変更

• コントローラテナント構成の変更

• アプリケーションプロパティやオブジェクトの変更（上記テーブルにリストされているポリシー、正常性ルール、エンティティなど）

• 環境プロパティの変更

AppDynamics は、PDF、JSON、および CSV の出力形式をサポートしています。 

API を介した監査履歴の取得

ControllerAuditHistory API メソッドを使用して監査履歴を取得できます。このメソッドは、指定された時間範囲について、JSON または CSV ファイル内の構成およびユーザアクティビティのレコードを返します。この情報は、ファイルに記載されている内容と同じです。

形式

GET /controller/ ControllerAuditHistory?startTime=<start-time>&endTime=<end-time>&include=<field>:<value>&exclude=<field>:<value>

For example:

http://localhost:8080/controller/ControllerAuditHistory?startTime=yyyy-MM-dd&&endTime=yyyy-MM-dd&include=filterName1:filterValue1&include=filterName1:filterValue1&exclude=filterName1:filterValue1&exclude=filterName1:filterValue1

curl --user user1@customer1:welcome "http://demo.appdynamics.com:8090/controller/ControllerAuditHistory?startTime=2015-12-19T10:50:03.607-0700&endTime=2015-12-19T17:50:03.607-0700&timeZoneId=America&Francisco&include=userName:user1&include=action:LOGIN&exclude=accountName:system&exclude=action:OBJECT_UPDATE"
  
[{"timeStamp":1450569821811,"auditDateTime":"2015-12-20T00:03:41.811+0000","accountName":"customer1","securityProviderType":"INTERNAL","userName":"user1","action":"LOGIN"},{"timeStamp":1450570234518,"auditDateTime":"2015-12-20T00:10:34.518+0000","accountName":"customer1","securityProviderType":"INTERNAL","userName":"user1","action":"LOGIN"},{"timeStamp":1450570273841,"auditDateTime":"2015-12-20T00:11:13.841+0000","accountName":"customer1","securityProviderType":"INTERNAL","userName":"user1","action":"OBJECT_CREATED","objectType":"AGENT_CONFIGURATION"},
...
{"timeStamp":1450570675345,"auditDateTime":"2015-12-20T00:17:55.345+0000","accountName":"customer1","securityProviderType":"INTERNAL","userName":"user1","action":"OBJECT_DELETED","objectType":"BUSINESS_TRANSACTION"},{"timeStamp":1450570719240,"auditDateTime":"2015-12-20T00:18:39.240+0000","accountName":"customer1","securityProviderType":"INTERNAL","userName":"user1","action":"APP_CONFIGURATION","objectType":"APPLICATION","objectName":"ACME Book Store Application"},{"timeStamp":1450571834835,"auditDateTime":"2015-12-20T00:37:14.835+0000","accountName":"customer1","securityProviderType":"INTERNAL","userName":"user1","action
 
curl --user user1@customer1:welcome "http://127.0.0.1:8080/controller/ControllerAuditHistory?startTime=2019-05-28T08:00:03.607-0700&endTime=2019-05-28T11:32:03.607-0700&timeZoneId=America%2FSan%20Francisco&include=applicationName:ACME"
[{"timeStamp":1559066415823,"auditDateTime":"2019-05-28T18:00:15.823+0000","accountName":"customer1","securityProviderType":"INTERNAL","userName":"user1","action":"LOGIN","objectId":0,"applicationName":"ACME"}]

入力パラメータ

start-time

end-time

time-zone-id

include

exclude

出力のサイズを制御するには、start-time から end-time までの範囲が 24 時間を超えないようにします。24 時間よりも長くなる場合は、連続する時間パラメータで複数のクエリを使用します。

• 同じタイプの複数のフィルタが許可されます。

• バックエンド API の処理には、同じ <field> を含むリレーションシップが "OR" のフィルタや、異なる <field> を含むリレーションシップが "AND" のフィルタなどがあります。

• include フィルタと exclude フィルタが直接連携することはありません。

• 各フィルタはパラメータにする必要があります（例：include=filterName1:filterValue1&include=filterName2:filterValue2）。次の例を参照してください。

監査ログのデフォルト構成設定

次の表に、テナント用のデフォルト設定を示します。これらの設定を編集するには、AppDynamics アカウントマネージャにお問い合わせください。

audit.enabled

audit.log.changes.persisted

audit.log.file.count

audit.log.file.enabled

audit.log.file.location

audit.log.file.size

audit.log.retention.period

AppDynamics では、監査ログが 30 日間のみ保持されます。それよりも長く保持する場合は、アカウントマネージャに問い合わせるか、スケジュール設定されたレポートを定期的にダウンロードしてください。

監査対象のエントリ

次のエントリが監査されます。

監査レポートでは、必要に応じて上記のエンティティのアプリケーション名がサポートされます。

サポートされている監査アクション

次に、監査でサポートされているアクションのリストを示します。

上記の表のすべての監査エントリで、これらのアクションのすべてがサポートされるわけではありません。