Skip to main content

Kubernetes: Install a sensor

Compatible with Kubernetes 1.16 or later and Helm 3.0.0 or later.

Before you begin

  • Make sure you have administrator privileges.

  • Make sure you have Kubernetes set up on your machine.

  • Make sure you have Helm installed on your machine.

  • Make sure you have Docker installed on your machine.

Install sensor

Download the Kubernetes deployment package from your CertCentral account

  1. In your CertCentral account, in the left main menu, go to Discovery > Manage Discovery.

  2. On the Manage scans page, select Add sensor.

  3. On the Set up a sensor page, under step 1 Download a discovery sensor in the Docker section, select Kubernetes deployment files.

    You can also download the sensor from here: Kubernetes sensor deployment file.

  4. Save the package (digicert_sensor_kubernetes.zip) in your system. Make sure to note the location.

  5. Extract the contents of the zip file.

Configure and deploy the sensor to Kubernetes with Helm

  1. Create the installation directory.

    For example:

    install_dir

    And copy the extracted folder (digicert_sensor_kubernetes) in the installation directory.

  2. Open the values.yaml file in a text editor.

  3. Edit the values.yaml file to provide the information for the following parameters to configure the sensor.

    • Username

    • Password

    • Division name

    • Sensor name

    Note: These parameters are used to provision a sensor to a CertCentral account.

  4. Go to the sensor installation directory (install_dir) and run the helm install command to install and start the sensor.

    helm install <image name> <installation directory path>

    For example:

    helm install digicert-sensor ./install_dir

The values.yaml file looks like this:

# Default values for sensor-charts.
# This is a YAML-formatted file.
# Declare variables to be passed into your templates.

replicaCount: 1

image:
  repository: digicertinc/digicert-sensor
  pullPolicy: Always
  tag: "latest"

nameOverride: ""
fullnameOverride: ""

service:
  type: ClusterIP
  port: 8080

ingress:
  enabled: false

resources: {}
  # We usually recommend not to specify default resources and to leave this as a conscious
  # choice for the user. This also increases chances charts run on environments with little
  # resources, such as Minikube. If you do want to specify resources, uncomment the following
  # lines, adjust them as necessary, and remove the curly braces after 'resources:'.
  # limits:
  #   cpu: 100m
  #   memory: 128Mi
  # requests:
  #   cpu: 100m
  #   memory: 128Mi

autoscaling:
  enabled: false

daasDomain: "daas.digicert.com"
sensorHome: /usr/local/digicert/sensor

sensorAuthDetails:
  username: username
  password: password
  divisionName: DivisionName
  sensorName: sensorName

What's next

Verify sensor installation:

  • Check the sensor status in your CertCentral account.

  • Check the sensor status logs.

Note

The sensor log location is: <path defined in sensorHome parameter>/logs/sensor.log

For example: /usr/local/digicert/sensor/logs/sensor.log

Now, you're ready to set up and run a scan using this sensor. See Set up and run a scan.

If you're using multiple sensors, you might want to rename the sensors to make tracking and identification easier. See Rename the sensor.