Creating a new Kubernetes Discovery job

When configuring Kubernetes discovery jobs, you will first need to create a Venafi Control Plane service account.

To create a new Kubernetes Discovery job

  1. From the TLS Protect menu bar, click ConfigurationJobs.

    (Optional) To filter the Jobs list by one or more specific job types, use the Job Type filter. See Filtering the Jobs list by job type.

  2. Click + Create New Job to start the Create New Job wizard.

  3. On the Create New Job page, select Kubernetes Discovery, and then click Start.

  4. Under Job Details, in the Name field of the New Kubernetes Discovery Job page, type a name for your new Kubernetes Discovery job.
  5. (Optional) In the Description field, type a description that describes the purpose for your new job.

    A strong description can be useful in helping other administrators better understand the purpose of your new object (such as certificates, jobs, credentials, devices, trust stores, etc.), or to remind yourself later why you created it.

  6. (Optional) In the Contacts field, begin typing the name a user name to specify one or more contacts for your new job.

    To add multiple contact names, press Enter after finding each name.

  7. (Conditional) If you do not have an existing Venafi Control Plane service account, follow the instructions for Creating a Service Account.

    NOTE   ED25519 keys are not supported.

  8. Next, configure the job settings.

    1. Indicate from which Kubernetes cluster you want to discover certificates. If you will only be discovering from selected clusters, use the controls to move the clusters into the Selected clusters box.

    2. Select if you want to ignore certificates from inactive clusters.
      Clusters are considered inactive when they do not report data to Venafi Control Plane, but they are still registered.

    3. Select if you want to include expired certificates.

    4. Specify the minimum validity of the certificates which you want to discover.

    5. Using the drop-down box select a folder where the discovered clusters and certificates should be placed.

    6. In the Retirement section, select how the system should handle deleted Kubernetes clusters.

      Clusters are considered deleted when removed from Venafi Control Plane. Based on your selection, the following details apply:

      • Delete - When clusters are deleted from Venafi Control Plane, they will be removed from the Venafi Trust Protection Platform Inventory and their related certificates will be deleted if they are not associated with other applications, Kubernetes clusters, or namespaces. If there are certificates associated with another Kubernetes cluster or application, they are automatically moved into a new Kubernetes policy folder labeled Associated Certificates (automatically moved) under the same organization.

      • Move - When clusters are deleted from Venafi Control Plane, they will be moved to a new location. If their related certificates are associated to another application, Kubernetes cluster, or namespace, they will be moved to Associated Certificates (automatically moved). Otherwise, they will be moved to Archived.

    7. Next, select how the system should handle deleted certificates.

      • Retire - When certificates are deleted from the Kubernetes cluster, certificates monitoring is disabled if the certificates are not in use by another application, Kubernetes cluster, or namespace. Certificates that are in use by another cluster or application are automatically moved to a new Kubernetes policy folder labeled Associated Certificates (automatically moved) and are not retired.

      • Revoke - When certificates are deleted from the Kubernetes cluster, and they are issued by Venafi, a revocation is requested if the certificates are not in use by another application, Kubernetes cluster, or namespace. Certificates that are in use by another cluster or application are automatically moved to a new Kubernetes policy folder labeled Associated Certificates (automatically moved) and revocation is not requested.

        • Specify certificate revocation for a number of days. In the event that a certificate is deleted from the Kubernetes cluster, it will not be immediately revoked for a specified period of time, but rather will be kept in a monitoring state during that time. This intentional delay is to allow time for any dependent systems or applications to be updated and avoid disruption. After the specified period of time, the certificate would then be revoked if it has not been reissued or renewed.

      • Delete - When certificates are deleted from the Kubernetes cluster, they are removed from the inventory if the certificates are not in use by another application, Kubernetes cluster, or namespace. Certificates that are in use by another cluster or application are automatically moved to a new Kubernetes policy folder labeled Associated Certificates (automatically moved).

      • Move - When certificates are deleted from the Kubernetes cluster, they are moved to the specified location if the certificates are not in use by another application, Kubernetes cluster, or namespace. Certificates that are in use by another cluster or application are automatically moved to a new Kubernetes policy folder labeled Associated Certificates (automatically moved).

    8. Click Next.

  9. Finally, select the frequency of when you would like the job to run.

  10. Click Create Job.

Related Topics Link IconRelated Topics