Splunk® Common Information Model Add-on

Common Information Model Add-on Manual

This documentation does not apply to the most recent version of Splunk® Common Information Model Add-on. For documentation on the most recent version, go to the latest release.

Certificates

The fields and tags in the Certificates data model describe key and certificate management events from a variety of secure servers and IAM systems.

Note: A dataset is a component of a data model. In versions of the Splunk platform prior to version 6.5.0, these were referred to as data model objects.

Tags used with Certificates event datasets

The following tags act as constraints to identify your events as being relevant to this data model. For more information, see How to use these reference tables.

Dataset name Tag name
All_Certificates certificate
|____ SSL
ssl OR tls

Fields for Certificates event datasets

The following table lists the extracted and calculated fields for the event datasets in the model. The table does not include any inherited fields. For more information, see How to use these reference tables.

The key for using the column titled "Abbreviated list of example values" follows:

  • Recommended are fields derived from the "recommended=true" JSON parameter that the TA developers need to make best efforts to map
  • Prescribed fields are the permitted values that can populate the fields, which are derived from the "expected_values" JSON parameter
  • Other values are other example values that you might see
Dataset name Field name Data type Description Abbreviated list of example values
All_Certificates dest string The target in the certificate management event.
All_Certificates dest_bunit string The business unit of the target.

This field is automatically provided by Asset and Identity correlation features of applications like Splunk Enterprise Security.
All_Certificates dest_category string The category of the target.

This field is automatically provided by Asset and Identity correlation features of applications like the Splunk Enterprise Security.
other:
email_server, SOX-compliant
All_Certificates dest_port number The port number of the target.
All_Certificates dest_priority string The priority of the target.
All_Certificates duration number The amount of time for the completion of the certificate management event, in seconds.
All_Certificates response_time number The amount of time it took to receive a response in the certificate management event, if applicable.
All_Certificates src string The source involved in the certificate management event. You can alias this from more specific fields, such as src_host, src_ip, or src_nt_host.

Note: Do not confuse src with the event source or sourcetype fields.
All_Certificates src_bunit string The business unit of the certificate management source.

This field is automatically provided by Asset and Identity correlation features of applications like Splunk Enterprise Security.
All_Certificates src_category string The category of the certificate management source.

This field is automatically provided by Asset and Identity correlation features of applications like the Splunk Enterprise Security.
other:
email_server, SOX-compliant
All_Certificates src_port number The port number of the source.
All_Certificates src_priority string The priority of the certificate management source.
All_Certificates tag string This automatically generated field is used to access tags from within datamodels. Add-on builders do not need to populate it.
All_Certificates transport string The transport protocol of the Network Traffic involved with this certificate.
SSL ssl_end_time time The expiry time of the certificate. Needs to be converted to UNIX time for calculations in dashboards. recommended
SSL ssl_engine string The name of the signature engine that created the certificate.
SSL ssl_hash string The hash of the certificate. recommended
SSL ssl_is_valid boolean Indicator of whether the ssl certificate is valid or not. prescribed fields:
true, false, 1, 0
SSL ssl_issuer string The certificate issuer's RFC2253 Distinguished Name. recommended
SSL ssl_issuer_common_name string The certificate issuer's common name. recommended
SSL ssl_issuer_email string The certificate issuer's email address.
SSL ssl_issuer_locality string The certificate issuer's locality.
SSL ssl_issuer_organization string The certificate issuer's organization.
SSL ssl_issuer_state string The certificate issuer's state of residence.
SSL ssl_issuer_street string The certificate issuer's street address.
SSL ssl_issuer_unit string The certificate issuer's organizational unit.
SSL ssl_name string The name of the ssl certificate.
SSL ssl_policies string The Object Identification Numbers's of the certificate's policies in a comma separated string.
SSL ssl_publickey string The certificate's public key.
SSL ssl_publickey_algorithm string The algorithm used to create the public key.
SSL ssl_serial string The certificate's serial number. recommended
SSL ssl_session_id string The session identifier for this certificate.
SSL ssl_signature_algorithm string The algorithm used by the Certificate Authority to sign the certificate.
SSL ssl_start_time time This is the start date and time for this certificate's validity. Needs to be converted to UNIX time for calculations in dashboards. recommended
SSL ssl_subject string The certificate owner's RFC2253 Distinguished Name. recommended
SSL ssl_subject_common_name string This certificate owner's common name. recommended
SSL ssl_subject_email string The certificate owner's e-mail address.
SSL ssl_subject_locality string The certificate owner's locality.
SSL ssl_subject_organization string The certificate owner's organization.
SSL ssl_subject_state string The certificate owner's state of residence.
SSL ssl_subject_street string The certificate owner's street address.
SSL ssl_subject_unit string The certificate owner's organizational unit.
SSL ssl_validity_window number The length of time (in seconds) for which this certificate is valid.
SSL ssl_version string The ssl version of this certificate.
Last modified on 31 August, 2020
Authentication   Change

This documentation applies to the following versions of Splunk® Common Information Model Add-on: 4.16.0, 4.17.0


Was this topic useful?







You must be logged into splunk.com in order to post comments. Log in now.

Please try to keep this discussion focused on the content covered in this documentation topic. If you have a more general question about Splunk functionality or are experiencing a difficulty with Splunk, consider posting a question to Splunkbase Answers.

0 out of 1000 Characters