Custom Connector Plugin Auditable Event Methods on Confluent Cloud

Auditable event methods for the resource type CUSTOM_CONNECTOR_PLUGIN are triggered by operations on custom connector plugins (used with custom connectors) that send event messages to the audit log cluster and store them as event records in an Apache Kafka® topic. For more information about audit log records, see Audit Log Event Records.

Method name	Action triggering an auditable event message
CreateCustomConnectorPlugin	A request to create a custom connector plugin.
CreatePresignedUrl	A request to create a presigned URL for a custom connector plugin.
DeleteCustomConnectorPlugin	A request to delete a custom connector plugin.
GetCustomConnectorPlugin	A request for a query of custom connector plugin details.
ListCustomConnectorPlugins	A request for a list of custom connector plugins.
UpdateCustomConnectorPlugin	A request to update a custom connector plugin.

CreateCustomConnectorPlugin

The CreateCustomConnectorPlugin event is generated by a request to create a custom connector plugin. It sends an event message that is saved in the audit log as an event record.

To view example event messages, expand the following dropdowns:

Success

{
   "datacontenttype": "application/json",
   "data": {
       "serviceName": "crn://confluent.cloud/",
       "methodName": "CreateCustomConnectorPlugin",
       "cloudResources": [
           {
               "scope": {
                   "resources": [
                       {
                           "type": "ORGANIZATION",
                           "resourceId": "2f37f0b6-f8da-4e8b-bc5f-282ebb0511be"
                       }
                   ]
               },
               "resource": {
                   "type": "CUSTOM_CONNECTOR_PLUGIN",
                   "resourceId": "ccp-ccl5y86z"
               }
           }
       ],
       "authenticationInfo": {
           "principal": {
               "email": "xxx@confluent.io",
               "confluentUser": {
                   "resourceId": "u-n5v236"
               }
           },
           "result": "SUCCESS",
           "identity": "crn://confluent.cloud/organization=2f37f0b6-f8da-4e8b-bc5f-282ebb0511be/identity-provider=Confluent/identity=u-n5v236"
       },
       "requestMetadata": {
           "requestId": [
               "14753a88809357d8a5badbbd491d0e46"
           ],
           "clientAddress": [
               {
                   "ip": "134.238.233.61"
               }
           ]
       },
       "request": {
           "accessType": "MODIFICATION",
           "data": {
               "display_name": "ccp.0907-0952.838393",
               "sensitive_config_properties": [
                   "foo",
                   "bar"
               ],
               "upload_source": {
                   "location": "PRESIGNED_URL_LOCATION",
                   "upload_id": "c70f04f5-6667-4070-99e6-5a258f1a96cf"
               },
               "connector_class": "io.confluent.kafka.connect.datagen.DatagenConnector",
               "connector_type": "SOURCE",
               "description": "xxx"
           }
       },
       "result": {
           "status": "SUCCESS",
           "data": {
               "api_version": "connect/v1",
               "connector_class": "io.confluent.kafka.connect.datagen.DatagenConnector",
               "connector_type": "SOURCE",
               "description": "xxx",
               "documentation_link": "",
               "id": "ccp-ccl5y86z",
               "metadata": {
                   "created_at": "2023-09-07T16:52:52.310421Z",
                   "resource_name": "crn://confluent.cloud/organization=2f37f0b6-f8da-4e8b-bc5f-282ebb0511be/custom-connector-plugins=ccp-ccl5y86z",
                   "self": "http://api.confluent.cloud/connect/v1/custom-connector-plugins/ccp-ccl5y86z",
                   "updated_at": "2023-09-07T16:52:52.310421Z"
               },
               "content_format": "ZIP",
               "display_name": "ccp.0907-0952.838393",
               "kind": "CustomConnectorPlugin",
               "sensitive_config_properties": [
                   "foo",
                   "bar"
               ]
           }
       },
       "resourceName": "crn://confluent.cloud/organization=2f37f0b6-f8da-4e8b-bc5f-282ebb0511be/custom-connector-plugin=ccp-ccl5y86z"
   },
   "subject": "crn://confluent.cloud/organization=2f37f0b6-f8da-4e8b-bc5f-282ebb0511be/custom-connector-plugin=ccp-ccl5y86z",
   "specversion": "1.0",
   "id": "c69b184c-536e-4474-9f2b-2b73e8028423",
   "source": "crn://confluent.cloud/",
   "time": "2023-09-07T16:52:52.856497336Z",
   "type": "io.confluent.cloud/request"
}

CreatePresignedUrl

The CreatePresignedUrl event is generated by a request to create a presigned URL for a custom connector plugin. It sends an event message that is saved in the audit log as an event record.

To view example event messages, expand the following dropdowns:

DeleteCustomConnectorPlugin

The DeleteCustomConnectorPlugin event is generated by a request to delete a custom connector plugin. It sends an event message that is saved in the audit log as an event record.

To view example event messages, expand the following dropdowns:

GetCustomConnectorPlugin

The GetCustomConnectorPlugin event is generated by a request to get the details of a custom connector plugin. It sends an event message that is saved in the audit log as an event record.

To view example event messages, expand the following dropdowns:

Success

{
  "datacontenttype": "application/json",
  "data": {
    "serviceName": "crn://confluent.cloud/",
    "methodName": "GetCustomConnectorPlugin",
    "cloudResources": [
      {
        "scope": {
          "resources": [
            {
              "type": "ORGANIZATION",
              "resourceId": "2f37f0b6-f8da-4e8b-bc5f-282ebb0511be"
            }
          ]
        },
        "resource": {
          "type": "CUSTOM_CONNECTOR_PLUGIN",
          "resourceId": "ccp-ccl5y86z"
        }
      }
    ],
    "authenticationInfo": {
      "principal": {
        "email": "xxx@confluent.io",
        "confluentUser": {
          "resourceId": "u-n5v236"
        }
      },
      "result": "SUCCESS",
      "identity": "crn://confluent.cloud/organization=2f37f0b6-f8da-4e8b-bc5f-282ebb0511be/identity-provider=Confluent/identity=u-n5v236"
    },
    "requestMetadata": {
      "requestId": [
        "e7c9dd7cf6ad139b673fefb6feb521ed"
      ],
      "clientAddress": [
        {
          "ip": "134.238.233.61"
        }
      ]
    },
    "request": {
      "accessType": "READ_ONLY",
      "data": {
        "plugin_id": "ccp-ccl5y86z"
      }
    },
    "result": {
      "status": "SUCCESS",
      "data": {
        "api_version": "connect/v1",
        "connector_type": "SOURCE",
        "kind": "CustomConnectorPlugin",
        "sensitive_config_properties": [
          "foo",
          "bar"
        ],
        "metadata": {
          "created_at": "2023-09-07T16:52:52.310421Z",
          "resource_name": "crn://confluent.cloud/organization=2f37f0b6-f8da-4e8b-bc5f-282ebb0511be/custom-connector-plugins=ccp-ccl5y86z",
          "self": "http://api.confluent.cloud/connect/v1/custom-connector-plugins/ccp-ccl5y86z",
          "updated_at": "2023-09-07T16:52:52.851542Z"
        },
        "connector_class": "io.confluent.kafka.connect.datagen.DatagenConnector",
        "content_format": "ZIP",
        "description": "xxx",
        "display_name": "ccp.0907-0952.838393",
        "documentation_link": "",
        "id": "ccp-ccl5y86z"
      }
    },
    "resourceName": "crn://confluent.cloud/organization=2f37f0b6-f8da-4e8b-bc5f-282ebb0511be/custom-connector-plugin=ccp-ccl5y86z"
  },
  "subject": "crn://confluent.cloud/organization=2f37f0b6-f8da-4e8b-bc5f-282ebb0511be/custom-connector-plugin=ccp-ccl5y86z",
  "specversion": "1.0",
  "id": "3f4da8ba-d0a9-4cda-b64f-788d97947541",
  "source": "crn://confluent.cloud/",
  "time": "2023-09-07T16:53:48.371391090Z",
  "type": "io.confluent.cloud/request"
}

ListCustomConnectorPlugins

The ListCustomConnectorPlugins event is generated by a request to list the custom connector plugins. It sends an event message that is saved in the audit log as an event record.

To view an example event message, expand the following dropdown:

Success

{
  "datacontenttype": "application/json",
  "data": {
    "serviceName": "crn://confluent.cloud/",
    "methodName": "ListCustomConnectorPlugins",
    "cloudResources": [
      {
        "resource": {
          "type": "ORGANIZATION",
          "resourceId": "2f37f0b6-f8da-4e8b-bc5f-282ebb0511be"
        }
      }
    ],
    "authenticationInfo": {
      "principal": {
        "email": "xxx@confluent.io",
        "confluentUser": {
          "resourceId": "u-n5v236"
        }
      },
      "result": "SUCCESS",
      "identity": "crn://confluent.cloud/organization=2f37f0b6-f8da-4e8b-bc5f-282ebb0511be/identity-provider=Confluent/identity=u-n5v236"
    },
    "requestMetadata": {
      "requestId": [
        "bb3156f0d3c840283175d31f3a7f0e58"
      ],
      "clientAddress": [
        {
          "ip": "134.238.233.61"
        }
      ]
    },
    "request": {
      "accessType": "READ_ONLY",
      "data": {
        "page_info": {
          "page_size": 1
        },
        "filter": {
          "org_resource_ids": [
            "2f37f0b6-f8da-4e8b-bc5f-282ebb0511be"
          ],
          "include_validated_only": true
        }
      }
    },
    "result": {
      "status": "SUCCESS",
      "data": {
        "api_version": "connect/v1",
        "data": [
          {
            "api_version": "connect/v1",
            "connector_class": "io.confluent.kafka.connect.datagen.DatagenConnector",
            "description": "custom",
            "display_name": "ccp.updated.0823-1216.978310",
            "kind": "CustomConnectorPlugin",
            "metadata": {
              "created_at": "2022-12-08T18:59:45.446846Z",
              "resource_name": "crn://confluent.cloud/organization=2f37f0b6-f8da-4e8b-bc5f-282ebb0511be/custom-connector-plugins=custom-plugin-lov3oe",
              "self": "http://api.confluent.cloud/connect/v1/custom-connector-plugins/custom-plugin-lov3oe",
              "updated_at": "2023-08-23T19:16:32.463964Z"
            },
            "sensitive_config_properties": [],
            "connector_type": "source",
            "content_format": "ZIP",
            "documentation_link": "https://github.com/confluentinc/kafka-connect-datagen/blob/master/README.md",
            "id": "custom-plugin-lov3oe"
          }
        ],
        "kind": "CustomConnectorPlugin",
        "metadata": {
          "first": "http://api.confluent.cloud/connect/v1/custom-connector-plugins",
          "next": "http://api.confluent.cloud/connect/v1/custom-connector-plugins?page_token=eyJpZCI6ImN1c3RvbS1wbHVnaW4tbG92M29lIiwiY3JlYXRlZCI6IjIwMjItMTItMDhUMTg6NTk6NDUuNDQ2ODQ2WiIsInNpemUiOjF9"
        }
      }
    },
    "resourceName": "crn://confluent.cloud/organization=2f37f0b6-f8da-4e8b-bc5f-282ebb0511be"
  },
  "subject": "crn://confluent.cloud/organization=2f37f0b6-f8da-4e8b-bc5f-282ebb0511be",
  "specversion": "1.0",
  "id": "f349f692-59f7-4272-be61-38a9eedb1cf8",
  "source": "crn://confluent.cloud/",
  "time": "2023-09-07T16:58:11.337320157Z",
  "type": "io.confluent.cloud/request"
}

UpdateCustomConnectorPlugin

The UpdateCustomConnectorPlugin event is generated by a request to update a custom connector plugin. It sends an event message that is saved in the audit log as an event record.

To view example event messages, expand the following dropdowns:

Success

{
  "datacontenttype": "application/json",
  "data": {
    "serviceName": "crn://confluent.cloud/",
    "methodName": "UpdateCustomConnectorPlugin",
    "cloudResources": [
      {
        "scope": {
          "resources": [
            {
              "type": "ORGANIZATION",
              "resourceId": "2f37f0b6-f8da-4e8b-bc5f-282ebb0511be"
            }
          ]
        },
        "resource": {
          "type": "CUSTOM_CONNECTOR_PLUGIN",
          "resourceId": "ccp-cc4rkygk"
        }
      }
    ],
    "authenticationInfo": {
      "principal": {
        "email": "xxx@confluent.io",
        "confluentUser": {
          "resourceId": "u-n5v236"
        }
      },
      "result": "SUCCESS",
      "identity": "crn://confluent.cloud/organization=2f37f0b6-f8da-4e8b-bc5f-282ebb0511be/identity-provider=Confluent/identity=u-n5v236"
    },
    "requestMetadata": {
      "requestId": [
        "d2bac6eff3a27d10e60d747b8455f9ee"
      ],
      "clientAddress": [
        {
          "ip": "134.238.233.61"
        }
      ]
    },
    "request": {
      "accessType": "MODIFICATION",
      "data": {
        "sensitive_config_properties": [
          "sss",
          "kkk"
        ],
        "id": "ccp-cc4rkygk"
      }
    },
    "result": {
      "status": "SUCCESS",
      "data": {
        "metadata": {
          "created_at": "2023-09-01T22:19:03.269826Z",
          "resource_name": "crn://confluent.cloud/organization=2f37f0b6-f8da-4e8b-bc5f-282ebb0511be/custom-connector-plugins=ccp-cc4rkygk",
          "self": "http://api.confluent.cloud/connect/v1/custom-connector-plugins/ccp-cc4rkygk",
          "updated_at": "2023-09-07T17:02:59.162922Z"
        },
        "sensitive_config_properties": [
          "sss",
          "kkk"
        ],
        "api_version": "connect/v1",
        "connector_type": "SOURCE",
        "content_format": "ZIP",
        "id": "ccp-cc4rkygk",
        "kind": "CustomConnectorPlugin",
        "connector_class": "io.confluent.kafka.connect.datagen.DatagenConnector",
        "description": "xxx",
        "display_name": "billtest",
        "documentation_link": ""
      }
    },
    "resourceName": "crn://confluent.cloud/organization=2f37f0b6-f8da-4e8b-bc5f-282ebb0511be/custom-connector-plugin=ccp-cc4rkygk"
  },
  "subject": "crn://confluent.cloud/organization=2f37f0b6-f8da-4e8b-bc5f-282ebb0511be/custom-connector-plugin=ccp-cc4rkygk",
  "specversion": "1.0",
  "id": "e6808569-e514-415a-b1b0-a5680da1009d",
  "source": "crn://confluent.cloud/",
  "time": "2023-09-07T17:02:59.166251748Z",
  "type": "io.confluent.cloud/request"
}